Awesome
MNImageBrowser
一个图片浏览框架,支持AndroidX,支持Fresco,支持微博长图,类似微信图片浏览,手势向下滑动关闭,图片加载引擎自定义,支持长按,单击监听,切换监听,自定义任意的遮罩层，实现各种效果,支持横竖屏切换,简单方便。
截图
<div align="center"> <img src = "screenshots/mn_ib_001.gif" width=180 > <img src = "screenshots/mn_ib_002.jpg" width=180 > <img src = "screenshots/mn_ib_003.jpg" width=180 > <img src = "screenshots/mn_ib_004.jpg" width=180 > <img src = "screenshots/mn_ib_005.jpg" width=180 > </div>自定义相关属性
<div> <img src = "screenshots/mn_ib_006.jpg" width=180 > </div>如何添加
方式一: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实现的各种下拉刷新效果（饿了吗，京东，百度外卖，美团外卖，天猫下拉刷新等）。 |