Home

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,
    }

感谢:

PhotoView

ImmersionBar

XPopup

[感谢所有开源的人]

详情见Demo

版本记录:

版本 V1.3.7:
1.默认支持长图显示
2.代码优化
版本 V1.3.6:
1.优化顶部状态栏下拉透明
2.show()支持不传递view
3.支持修改背景色,状态栏文字颜色
4.支持修改圆形指示器Drawable,文字指示器文字大小和颜色
版本 V1.3.5:
1.优化底部导航栏颜色问题
2.新增生命周期回调监听

推荐:

NameDescribe
GankMM(Material Design & MVP & Retrofit + OKHttp & RecyclerView ...)Gank.io Android客户端:每天一张美女图片,一个视频短片,若干Android,iOS等程序干货,周一到周五每天更新,数据全部由 干货集中营 提供,持续更新。
MNUpdateAPKAndroid APK 版本更新的下载和安装,适配7.0,8.0,简单方便。
MNImageBrowser交互特效的图片浏览框架,微信向下滑动动态关闭
MNCalendar简单的日历控件练习,水平方向日历支持手势滑动切换,跳转月份;垂直方向日历选取区间范围。
MClearEditText带有删除功能的EditText
MNCrashMonitorDebug监听程序崩溃日志,展示崩溃日志列表,方便自己平时调试。
MNProgressHUDMNProgressHUD是对常用的自定义弹框封装,加载ProgressDialog,状态显示的StatusDialog和自定义Toast,支持背景颜色,圆角,边框和文字的自定义。
MNXUtilsDBxUtils3 数据库模块单独抽取出来,方便使用。
MNVideoPlayerSurfaceView + MediaPlayer 实现的视频播放器,支持横竖屏切换,手势快进快退、调节音量,亮度等。------代码简单,新手可以看一看。
MNZXingCode快速集成二维码扫描和生成二维码
MNChangeSkinAndroid夜间模式,通过Theme实现
SwitcherView垂直滚动的广告栏文字展示。
MNPasswordEditText类似微信支付宝的密码输入框。
MNSwipeToLoadDemo利用SwipeToLoadLayout实现的各种下拉刷新效果(饿了吗,京东,百度外卖,美团外卖,天猫下拉刷新等)。