mojito 
由于工作繁忙，关于该项目，暂时不做维护，如果有大佬想要完善，非常提倡大佬们能够提pull requests，有时间我会进行合并；该项目整体的架构设计还算ok，各位需要想要进行开发或者拓展也是非常方便的。
功能列表
- 支持Coil图片加载器
- 支持Glide图片加载器
- 支持Fresco图片加载器
- 支持视频图片混合、GIF、图片预览
- 支持拖拽关闭
- 支持自定义页面索引指示器、进度条、Cover
- 支持原图加载策略
二维码下载体验
通过视频查看效果
动图效果
开始
添加 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(
onClick = { 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 |