NineGridView

Introduction: 类似 QQ 空间,微信朋友圈,微博主页等,展示图片的九宫格控件,自动根据图片的数量确定图片大小和控件大小,支持任意的图片加载框架
More: Author   ReportBugs   
Tags:
九宫格图片-图片格子-朋友圈图片样式-

类似 QQ 空间,微信朋友圈,微博主页等,展示图片的九宫格控件,自动根据图片的数量确定图片大小和控件大小,使用 Adapter 模式设置图片,对外提供接口回调,支持任意的图片加载框架,如 Glide,ImageLoader,Fresco,xUtils3,Picasso 等,支持点击图片全屏预览大图。

该项目是根据:https://github.com/laobie/NineGridImageView 修改而成,进行了优化扩展,使代码更加简单,喜欢原作的可以去使用。同时欢迎大家下载体验本项目,如果使用过程中遇到什么问题,欢迎反馈。

联系方式

  • 邮箱地址: liaojeason@126.com
  • QQ 群: 489873144 (建议使用 QQ 群,邮箱使用较少,可能看的不及时)
  • 本群刚建立,旨在为使用我的 github 项目的人提供方便,如果遇到问题欢迎在群里提问。个人能力也有限,希望一起学习一起进步。

演示

image image image image imageimage

1.用法

使用前,对于 Android Studio 的用户,可以选择添加:

    compile 'com.lzy.widget:ninegridview:0.2.0'

或者使用

    compile project(':ninegridview')

2.项目功能

  • 使用 Adapter 模式设置图片
  • 当图片数量只有一张时,自动根据图片大小调整控件大小
  • 默认增加了图片点击全屏预览效果,并附带预览动画
  • 使用接口加载图片,支持任意的图片加载框架,如 Glide,ImageLoader,Fresco,xUtils3,Picasso 等
  • 整合了 PhotoView 图片预览
  • 使用接口抽出图片的加载方式,可以方便的将 Glide 替换成自己喜欢的 ImageLoader 等
  • 支持 fill 个 grid 两种显示模式
  • 当获取的图片数量超过最大显示的图片数量时,最后一张图片上会显示剩余数量(类似于 QQ 的动态效果)
  • 使用代码简单,只需要几行代码
  • 其他功能增加中......

3.参数含义

自定义属性名字 参数含义
ngv_singleImageSize 只显示一张图片时的最大图片大小
ngv_singleImageRatio 只显示一张图片时图片宽高比
ngv_gridSpacing 网格显示图片时,图片之间的间距,默认 3dp
ngv_maxSize 最多显示图片的数量,默认最大 9 张
ngv_mode 支持 fill 和 grid 两种显示模式,其中 grid 模式在显示 4 张图片时采用 2*2 的布局

4.代码演示

1.在 Application 中初始化 NineGridView 的图片加载器

    NineGridView.setImageLoader(new PicassoImageLoader());

    /** Picasso 加载 */
    private class PicassoImageLoader implements NineGridView.ImageLoader {

        @Override
        public void onDisplayImage(Context context, ImageView imageView, String url) {
            Picasso.with(context).load(url)//
                    .placeholder(R.drawable.ic_default_image)//
                    .error(R.drawable.ic_default_image)//
                    .into(imageView);
        }

        @Override
        public Bitmap getCacheImage(String url) {
            return null;
        }
    }

2.在自己的 Adapter 中初始化 NineGridView 的适配器

  • ImageInfo是库中提供的数据 Bean,需要两个 url,分别表示小图和大图的 url,没有大图或者小图,则都赋给相同的 Url 即可。
  • ClickNineGridViewAdapter是库中提供的默认实现了点击预览的 Adapter,如果不想使用预览效果,可以自己继承 NineGridViewAdapter 实现其中 onDisplayImage 方法即可。
     ArrayList<ImageInfo> imageInfo = new ArrayList<>();
     List<EvaluationPic> imageDetails = item.getAttachments();
     if (imageDetails != null) {
         for (EvaluationPic imageDetail : imageDetails) {
             ImageInfo info = new ImageInfo();
             info.setThumbnailUrl(imageDetail.smallImageUrl);
             info.setBigImageUrl(imageDetail.imageUrl);
             imageInfo.add(info);
         }
     }
     holder.nineGrid.setAdapter(new ClickNineGridViewAdapter(context, imageInfo));
    
Apps
About Me
GitHub: Trinea
Facebook: Dev Tools