MNImageBrowser
Introduction: 一个图片浏览框架,类似微信图片浏览,手势向下滑动关闭,图片加载引擎自定义,支持长按,单击监听,切换监听,自定义任意的遮罩层，实现各种效果,支持横竖屏切换,简单方便。
Tags:
一个图片浏览框架,支持 AndroidX,支持 Fresco,支持微博长图,类似微信图片浏览,手势向下滑动关闭,图片加载引擎自定义,支持长按,单击监听,切换监听,自定义任意的遮罩层，实现各种效果,支持横竖屏切换,简单方便。
截图
自定义相关属性
如何添加
方式一:Gradle 添加：
1.在 Project 的 build.gradle 中添加仓库地址
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
}
Support 适配版本源码，下载代码切换到 support 分支
2.在 app 目录下的 build.gradle 中添加依赖
//android x 适配
dependencies {
implementation 'androidx.appcompat:appcompat:1.1.0'
implementation 'androidx.legacy:legacy-support-v4:1.0.0'
implementation 'com.github.maning0303:MNImageBrowser:V1.3.7'
}
//android support (后期不再支持 support 升级)
dependencies {
//v4,v7 包
implementation 'com.android.support:appcompat-v7:28.0.0'
implementation 'com.android.support:support-v4:28.0.0'
implementation 'com.github.maning0303:MNImageBrowser:V1.3.5-support'
}
方式二:(方便自定义修改)
下载源码使用 Module 添加：imagebrowserlibrary，默认 androidx 版本，support 版本切换到 support 分支
implementation project(':imagebrowserlibrary')
代码使用(详情见 Demo):
//最简单的调用方式：
imageEngine = new GlideImageEngine();
MNImageBrowser.with(context)
//当前位置
.setCurrentPosition(0)
//图片引擎
.setImageEngine(imageEngine)
//图片集合
.setImageList(sourceImageList)
.show();
//-------------------------------------------
//自定义调用
public ImageBrowserConfig.TransformType transformType = ImageBrowserConfig.TransformType.Transform_Default;
public ImageBrowserConfig.IndicatorType indicatorType = ImageBrowserConfig.IndicatorType.Indicator_Number;
public ImageBrowserConfig.ScreenOrientationType screenOrientationType = ImageBrowserConfig.ScreenOrientationType.ScreenOrientation_Portrait;
MNImageBrowser.with(context)
//必须-当前位置
.setCurrentPosition(position)
//必须-图片加载用户自己去选择
.setImageEngine(new XXXImageEngine())
//必须（setImageList 和 setImageUrl 二选一，会覆盖）-图片集合
.setImageList(sourceImageList)
//必须（setImageList 和 setImageUrl 二选一，会覆盖）-设置单张图片
.setImageUrl("xxx")
//非必须-图片切换动画
.setTransformType(transformType)
//非必须-指示器样式（默认文本样式：两种模式）
.setIndicatorType(indicatorType)
//设置隐藏指示器
.setIndicatorHide(false)
//设置自定义遮盖层，定制自己想要的效果，当设置遮盖层后，原本的指示器会被隐藏
.setCustomShadeView(customShadeView)
//自定义 ProgressView，不设置默认默认没有
.setCustomProgressViewLayoutID(R.layout.layout_custom_progress_view)
//非必须-屏幕方向：横屏，竖屏，Both（默认：横竖屏都支持）
.setScreenOrientationType(screenOrientationType)
//非必须-图片单击监听
.setOnClickListener(new OnClickListener() {
@Override
public void onClick(FragmentActivity activity, ImageView view, int position, String url) {
//单击监听
}
})
//非必须-图片长按监听
.setOnLongClickListener(new OnLongClickListener() {
@Override
public void onLongClick(FragmentActivity activity, ImageView imageView, int position, String url) {
//长按监听
}
})
//非必须-图片滑动切换监听
.setOnPageChangeListener(new OnPageChangeListener() {
@Override
public void onPageSelected(int position) {
//图片滑动切换监听
}
}
//生命周期监听
.setOnActivityLifeListener(new OnActivityLifeListener() {
@Override
public void onCreate() {
Log.i(TAG, "OnActivityLifeListener:onCreate");
}
@Override
public void onResume() {
Log.i(TAG, "OnActivityLifeListener:onResume");
}
@Override
public void onPause() {
Log.i(TAG, "OnActivityLifeListener:onPause");
}
@Override
public void onDestory() {
Log.i(TAG, "OnActivityLifeListener:onDestory");
}
})
//全屏模式：默认非全屏模式
.setFullScreenMode(isFulScreenMode)
//手势下拉缩小效果是否开启
.setOpenPullDownGestureEffect(isOpenPullDownGestureEffect)
//打开动画
.setActivityOpenAnime(R.anim.activity_anmie_in)
//关闭动画
.setActivityExitAnime(R.anim.activity_anmie_out)
//自定义显示 View，默认使用 PhotoView，可以自定义 View 实现 Fresco 等加载
.setCustomImageViewLayoutID(showCustomImageView ? R.layout.layout_custom_image_view_fresco : 0)
//自定义指示器显示
.setIndicatorBackgroundResId(R.drawable.custom_indicator_bg_selected, R.drawable.custom_indicator_bg_unselected)
//状态栏黑色字体
.setStatusBarDarkFont(true)
//数字指示器文字大小，sp
.setIndicatorTextSize(18)
//数字指示器文字颜色
.setIndicatorTextColor("#FF0000")
//整体背景色
.setWindowBackgroundColor("#FFFFFF")
//打开，可以不传 View
.show(viewHolder.imageView);
//----MNImageBrowser 提供其他方法----
/**
* 获取当前 Activity 实例
*/
MNImageBrowser.getCurrentActivity();
/**
* 手动关闭图片浏览器
*/
MNImageBrowser.finishImageBrowser();
/**
* 获取当前 ImageView
*/
MNImageBrowser.getCurrentImageView();
/**
* 获取当前位置
*/
MNImageBrowser.getCurrentPosition();
/**
* 获取 ViewPager
*/
MNImageBrowser.getViewPager();
/**
* 删除图片
*
* @param position
*/
MNImageBrowser.removeImage(int position) {
/**
* 删除图片
*/
MNImageBrowser.removeCurrentImage() {
/**
* 获取图片集合
*/
MNImageBrowser.getImageList() {
图片加载需要实现 ImageEngine：
/**
* author : maning
* time : 2018/04/10
* desc : 图片引擎--需要实现
* version: 1.0
*/
public interface ImageEngine {
/**
* 加载图片方法
*
* @param context 上下文
* @param url 图片地址
* @param imageView ImageView
* @param progressView 进度 View
* @param customImageView 自定义加载图片，替换 PhotoView
*/
void loadImage(Context context, String url, ImageView imageView, View progressView, View customImageView);
}
//Picasso
public class PicassoImageEngine implements ImageEngine {
@Override
public void loadImage(Context context, String url, ImageView imageView, final View progressView, View customImageView) {
Picasso.with(context).load(url)
.placeholder(R.drawable.default_placeholder)
.error(R.mipmap.ic_launcher)
.into(imageView, new Callback() {
@Override
public void onSuccess() {
//隐藏进度 View,必须设置 setCustomProgressViewLayoutID
progressView.setVisibility(View.GONE);
}
@Override
public void onError() {
//隐藏进度 View,必须设置 setCustomProgressViewLayoutID
progressView.setVisibility(View.GONE);
}
});
}
}
//Glide
public class GlideImageEngine implements ImageEngine {
@Override
public void loadImage(Context context, String url, ImageView imageView, final View progressView, View customImageView) {
Glide.with(context)
.load(url)
.asBitmap()
.fitCenter()
.placeholder(R.drawable.default_placeholder)
.error(R.mipmap.ic_launcher)
.listener(new RequestListener<String, Bitmap>() {
@Override
public boolean onException(Exception e, String model, Target<Bitmap> target, boolean isFirstResource) {
//隐藏进度 View,必须设置 setCustomProgressViewLayoutID
progressView.setVisibility(View.GONE);
return false;
}
@Override
public boolean onResourceReady(Bitmap resource, String model, Target<Bitmap> target, boolean isFromMemoryCache, boolean isFirstResource) {
//隐藏进度 View,必须设置 setCustomProgressViewLayoutID
progressView.setVisibility(View.GONE);
return false;
}
})
.into(imageView);
}
}
//Fresco，必须配合 setCustomImageViewLayoutID()方法来
public class FrescoImageEngine implements ImageEngine {
@Override
public void loadImage(Context context, String url, ImageView imageView, final View progressView, View customImageView) {
imageView.setVisibility(View.GONE);
//用自己定义的 View 去加载图片
if (customImageView != null) {
SimpleDraweeView draweeView = (SimpleDraweeView) customImageView.findViewById(R.id.fresco_image_view);
if (draweeView != null) {
//加载图片处理 xxx
}
}
}
//其它
public class XXXImageEngine implements ImageEngine {
@Override
public void loadImage(Context context, String url, ImageView imageView,View progressView, View customImageView) {
//加载图片实现
}
}
TransformType 切换效果提供 7 种效果：
ImageBrowserConfig：
//枚举类型：切换动画类型
public enum TransformType {
Transform_Default,
Transform_DepthPage,
Transform_RotateDown,
Transform_RotateUp,
Transform_ZoomIn,
Transform_ZoomOutSlide,
Transform_ZoomOut,
}
IndicatorType 指示器提供 2 种效果：
ImageBrowserConfig：
//枚举类型：指示器类型
public enum IndicatorType {
Indicator_Circle,
Indicator_Number
}
ScreenOrientationType 屏幕方向 3 种效果：
ImageBrowserConfig：
//枚举类型：屏幕方向
public enum ScreenOrientationType {
//默认：竖屏
ScreenOrientation_Portrait,
//横屏
Screenorientation_Landscape,
//全部支持
Screenorientation_All,
}
感谢:
[感谢所有开源的人]
详情见 Demo
版本记录：
版本 V1.3.7:
1.默认支持长图显示
2.代码优化
版本 V1.3.6:
1.优化顶部状态栏下拉透明
2.show()支持不传递 view
3.支持修改背景色，状态栏文字颜色
4.支持修改圆形指示器 Drawable，文字指示器文字大小和颜色
版本 V1.3.5:
1.优化底部导航栏颜色问题
2.新增生命周期回调监听
推荐:
| Name | Describe | |
|---|---|---|
| GankMM | （Material Design & MVP & Retrofit + OKHttp & RecyclerView ...）Gank.io Android 客户端：每天一张美女图片，一个视频短片，若干 Android，iOS 等程序干货，周一到周五每天更新，数据全部由 干货集中营 提供,持续更新。 | |
| MNUpdateAPK | Android APK 版本更新的下载和安装,适配 7.0，8.0,简单方便。 | |
| MNImageBrowser | 交互特效的图片浏览框架,微信向下滑动动态关闭 | |
| MNCalendar | 简单的日历控件练习，水平方向日历支持手势滑动切换，跳转月份；垂直方向日历选取区间范围。 | |
| MClearEditText | 带有删除功能的 EditText | |
| MNCrashMonitor | Debug 监听程序崩溃日志,展示崩溃日志列表，方便自己平时调试。 | |
| MNProgressHUD | MNProgressHUD 是对常用的自定义弹框封装,加载 ProgressDialog,状态显示的 StatusDialog 和自定义 Toast,支持背景颜色,圆角,边框和文字的自定义。 | |
| MNXUtilsDB | xUtils3 数据库模块单独抽取出来，方便使用。 | |
| MNVideoPlayer | SurfaceView + MediaPlayer 实现的视频播放器，支持横竖屏切换，手势快进快退、调节音量，亮度等。------代码简单，新手可以看一看。 | |
| MNZXingCode | 快速集成二维码扫描和生成二维码 | |
| MNChangeSkin | Android 夜间模式，通过 Theme 实现 | |
| SwitcherView | 垂直滚动的广告栏文字展示。 | |
| MNPasswordEditText | 类似微信支付宝的密码输入框。 | |
| MNSwipeToLoadDemo | 利用 SwipeToLoadLayout 实现的各种下拉刷新效果（饿了吗，京东，百度外卖，美团外卖，天猫下拉刷新等）。 |
