mojito

mojito

English

由于工作繁忙，关于该项目，暂时不做维护，如果有大佬想要完善，非常提倡大佬们能够提pull requests，有时间我会进行合并；该项目整体的架构设计还算ok，各位需要想要进行开发或者拓展也是非常方便的。

功能列表

• 支持Coil图片加载器
• 支持Glide图片加载器
• 支持Fresco图片加载器
• 支持视频图片混合、GIF、图片预览
• 支持拖拽关闭
• 支持自定义页面索引指示器、进度条、Cover
• 支持原图加载策略

二维码下载体验

通过视频查看效果

SAMPLE VIDEO LINK

动图效果

开始

---

添加 dependencies

allprojects {
    repositories {
        maven { url 'https://jitpack.io' }
    }
}

implementation "com.github.mikaelzero.mojito:mojito:$mojito_version"
//support long image and gif with Sketch
implementation "com.github.mikaelzero.mojito:SketchImageViewLoader:$mojito_version"

//load with coil
implementation "com.github.mikaelzero.mojito:coilimageloader:$mojito_version"
//load with glide
implementation "com.github.mikaelzero.mojito:GlideImageLoader:$mojito_version"
//load with fresco
implementation "com.github.mikaelzero.mojito:FrescoImageLoader:$mojito_version"

初始化

// in your application
Mojito.initialize(
    GlideImageLoader.with(this),
    SketchImageLoadFactory()
)

//or

//YourMojitoConfig:IMojitoConfig
Mojito.initialize(
    GlideImageLoader.with(this),
    SketchImageLoadFactory(),
    YourMojitoConfig()
)

开始使用

Mojito.with(context)
    .urls(SourceUtil.getSingleImage())
    .views(singleIv)
    .start()

使用

RecyclerView

binding.recyclerView.mojito(R.id.srcImageView) {
    urls(SourceUtil.getNormalImages())
    position(position)
    mojitoListener(
        view, x, y, pos ->
            Toast.makeText(context, "tap click", Toast.LENGTH_SHORT).show()
        }
    )
    progressLoader {
        DefaultPercentProgress()
    }
    setIndicator(NumIndicator())
}

单个 View

binding.longHorIv.mojito(SourceUtil.getLongHorImage())

无 View

 Mojito.start(context) {
    urls(SourceUtil.getNormalImages())
}

视频 View or 视频/图片 混合View

Mojito.start(context) {
    urls(SourceUtil.getVideoImages(), SourceUtil.getVideoTargetImages())
    setMultiTargetEnableLoader(object : MultiTargetEnableLoader {
        override fun providerEnable(position: Int): Boolean {
            return position != 1
        }
    })
    setMultiContentLoader(object : MultiContentLoader {
        override fun providerLoader(position: Int): ImageViewLoadFactory {
            return if (position == 1) {
                ArtLoadFactory()
            } else {
                SketchImageLoadFactory()
            }
        }
    })
    position(position)
    views(recyclerView, R.id.srcImageView)
}

Callback回调

 abstract class SimpleMojitoViewCallback : OnMojitoListener {
    // image click
    override fun onClick(view: View, x: Float, y: Float, position: Int) {

    }

    //image long press
    override fun onLongClick(fragmentActivity: FragmentActivity?, view: View, x: Float, y: Float, position: Int) {
    }

    //end of min image to max image 
    override fun onShowFinish(mojitoView: MojitoView, showImmediately: Boolean) {
    }

    //activity finish,backToMin,single click
    override fun onMojitoViewFinish() {
    }

    //when you drag your image 
    override fun onDrag(view: MojitoView, moveX: Float, moveY: Float) {
    }

    //the ratio of long image when you scroll
    override fun onLongImageMove(ratio: Float) {
    }
}

API

Name	desc
url(src,target)	设置缩略图和原图url数据
position	点击的位置
views	1. recylclerView,imageViewId 2. single view 3. multi views
autoLoadTarget	默认为true，如果你设置了原图的url并且设置了autoLoadTarget(false) 你需要使用setFragmentCoverLoader来自定义view
setProgressLoader	当你设置了 autoLoadTarget false 才会生效
setIndicator	可以选择 NumIndicator 或者 CircleIndexIndicator
setActivityCoverLoader	自定义Activity的覆盖层view
setMultiContentLoader	如果使用视频和图片混合模式，需要设置 ImageViewLoadFactory

Thanks

sketch

BigImageViewer