MNImageBrowser

一个图片浏览框架,类似微信图片浏览,手势向下滑动关闭,图片加载引擎自定义,支持长按,单击监听,切换监听,自定义任意的遮罩层,实现各种效果,支持横竖屏切换,简单方便。

注意

8.0系统关闭了下拉缩小特效,8.0 fullscreen opaque activities can request orientation,其它系统版本正常

截图

gif比较慢:

截图:

自定义任意的遮罩层:

如何添加

方式一:Gradle添加:

1.在Project的build.gradle中添加仓库地址

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

AndroidX 适配版本源码

2.在app目录下的build.gradle中添加依赖


     //android support library
     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.2.5'
     }

     //android x 适配
     dependencies {
         implementation 'androidx.appcompat:appcompat:1.0.0'
         implementation 'androidx.legacy:legacy-support-v4:1.0.0'
         implementation 'com.github.maning0303:MNImageBrowser:V1.2.5X'
     }

方式二:(方便自定义修改)

下载源码使用Module添加:imagebrowserlibrary(需要 android x 适配,切换到androidx分支。)

    implementation project(':imagebrowserlibrary')

代码使用(详情见Demo):


    public ImageBrowserConfig.TransformType transformType = ImageBrowserConfig.TransformType.Transform_Default;
    public ImageBrowserConfig.IndicatorType indicatorType = ImageBrowserConfig.IndicatorType.Indicator_Number;
    public ImageBrowserConfig.ScreenOrientationType screenOrientationType = ImageBrowserConfig.ScreenOrientationType.Screenorientation_Default;

    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) {
                    //图片滑动切换监听
                 }
             }
             //全屏模式:默认非全屏模式
             .setFullScreenMode(isFulScreenMode)
             //手势下拉缩小效果是否开启
             .setOpenPullDownGestureEffect(isOpenPullDownGestureEffect)
             //打开动画
             .setActivityOpenAnime(R.anim.activity_anmie_in)
             //关闭动画
             .setActivityExitAnime(R.anim.activity_anmie_out)
             //打开
             .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
         */
        void loadImage(Context context, String url, ImageView imageView, View progressView);

    }

    //Picasso
    public class PicassoImageEngine implements ImageEngine {
        @Override
            public void loadImage(Context context, String url, ImageView imageView, final View progressView) {
                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) {
            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);
        }
    }

    //其它
    public class XXXImageEngine implements ImageEngine {
        @Override
        public void loadImage(Context context, String url, ImageView imageView,View progressView) {
            //加载图片实现
        }

     }

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_Default,
        //竖屏
        ScreenOrientation_Portrait,
        //横屏
        Screenorientation_Landscape,
    }

感谢:

PhotoView

ImmersionBar

[感谢所有开源的人]

详情见Demo

版本记录:

版本 V1.2.5:
1.优化requestFeature() must be called before adding content,去除requestWindowFeature(Window.FEATURE_NO_TITLE);
2.优化代码,防止未知崩溃
版本 V1.2.3:
1.修复8.0 fullscreen opaque activities can request orientation 错误(解决方案:主题设置8.0去掉下拉缩小效果,其他版本正常使用)
2.添加 下拉缩小效果 开关,可手动选择
3.PhotoView 引入源码,防止和应用冲突
4.优化代码,防止数据异常
版本 V1.2.0:
1.修复已知Bug,防止关闭出现空指针异常和多次连续启动出现的异常
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实现的各种下拉刷新效果(饿了吗,京东,百度外卖,美团外卖,天猫下拉刷新等)。