Android自定义控件-ZzImageBox

Android自定义控件
  1. 1. ZzImageBox
    1. 1.0.1. 功能简介：
    2. 1.0.2. Gradle
    3. 1.0.3. Maven
  2. 1.1. What does it look like?
  3. 1.2. How to use it ?
  4. 1.3. 属性说明：

ZzImageBox

A powerful image container for adding and removing images.

功能简介：

1.支持添加、删除、默认图片的配置；

2.支持最大行数限制；

3.支持每行数量修改；

4.支持添加、删除、图片点击回调接口。

5.支持Box的添加(.addImage(String imagePath))和删除(.removeImage(int position))；

6.支持加载本地图片(使用方法.addImage(String imagePath))；

7.支持左右margin设置。

Gradle

1
compile 'me.zhouzhuo.zzimagebox:zz-image-box:1.0.4'

Maven

1
2
3
4
5
6
<dependency>
  <groupId>me.zhouzhuo.zzimagebox</groupId>
  <artifactId>zz-image-box</artifactId>
  <version>1.0.4</version>
  <type>pom</type>
</dependency>

What does it look like?

zzimagebox

How to use it ?

xml:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<me.zhouzhuo.zzimagebox.ZzImageBox
    android:id="@+id/zz_image_box"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:zib_left_margin="20dp"
    app:zib_right_margin="20dp"
    app:zib_img_padding="5dp"
    app:zib_img_size_one_line="4"
    app:zib_max_line="3"
    app:zib_img_deletable="true"
    app:zib_img_add="@drawable/iv_add"
    app:zib_img_default="@drawable/iv_default"
    app:zib_img_delete="@drawable/iv_delete"
    />

java:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
final ZzImageBox imageBox = (ZzImageBox) findViewById(R.id.zz_image_box);
imageBox.setOnImageClickListener(new ZzImageBox.OnImageClickListener() {
    @Override
    public void onImageClick(int position, String filePath) {
        Log.d("ZzImageBox", "image clicked:" + position + "," + filePath);
    }
  
    @Override
    public void onDeleteClick(int position, String filePath) {
        imageBox.removeImage(position);
        Log.d("ZzImageBox", "delete clicked:" + position + "," + filePath);
        Log.d("ZzImageBox", "all images\n"+imageBox.getAllImages().toString());
    }
  
    @Override
    public void onAddClick() {
        imageBox.addImage(null);
        Log.d("ZzImageBox", "add clicked");
        Log.d("ZzImageBox", "all images\n"+imageBox.getAllImages().toString());
    }
});

属性说明：

1
2
3
4
5
6
7
8
9
10
11
<declare-styleable name="ZzImageBox">
    <attr name="zib_max_line" format="integer" />
    <attr name="zib_img_size_one_line" format="integer" />
    <attr name="zib_img_padding" format="dimension|reference" />
    <attr name="zib_img_default" format="color|reference" />
    <attr name="zib_img_delete" format="color|reference" />
    <attr name="zib_img_add" format="color|reference" />
    <attr name="zib_img_deletable" format="boolean" />
    <attr name="zib_left_margin" format="dimension|reference" />
    <attr name="zib_right_margin" format="dimension|reference" />
</declare-styleable>
属性名 属性类型 属性功能
zib_max_line integer 最大行数
zib_img_size_one_line integer 每行数量
zib_img_padding dimension 图片之间的间距
zib_img_default drawable color
zib_img_delete drawable color
zib_img_add drawable color
zib_img_deletable boolean 是否显示删除图片
zib_left_margin dimension 控件距离屏幕左边距离
zib_right_margin dimension 控件距离屏幕右边距离
Android
prev： next：