介绍

可自定义的标签视图，支持添加标签，点击，长按弹出删除对话框，以及拖拽排序。

Github

类似控件

android-flowlayout
TagCloudView

使用

第一步

在build.gradle文件中添加依赖：

dependencies {
    compile 'co.lujun:androidtagview:1.0.3'
}

第二步

在布局中使用AndroidTagView，可以使用自定义属性。

<co.lujun.androidtagview.TagContainerLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:layout_margin="0dp"
    android:padding="10dp"
    app:container_enable_drag="false"
    app:horizontal_interval="10dp"
    app:vertical_interval="10dp"
    app:tag_clickable="true"
    app:tag_theme="pure_teal" />

第三步

在代码中使用，并设置数据。

TagContainerLayout mTagContainerLayout = (TagContainerLayout) findViewById(R.id.tagcontainerLayout);
mTagContainerLayout.setTags(List<String> tags);

[图片上传失败...(image-e318a2-1540455478741)]

属性

以下属性均可在布局中设置，也可以通过set或get方法使用。

主题

方向

注：是标签内文本方向

Gravity

注：是子标签在父布局中的相对位置，父布局即引用的co.lujun.androidtagview.TagContainerLayout。

Methods

1. 设置监听事件：TagView.OnTagClickListener

mTagContainerLayout.setOnTagClickListener(new TagView.OnTagClickListener() { 
      @Override 
      public void onTagClick(int position, String text) {
           // ...点击事件
     } 
      @Override 
      public void onTagLongClick(final int position, String text) { 
          // ...长按事件
     }
});

2. 设置标签最大长度：setTagMaxLength(int max)

mTagContainerLayout.setTagMaxLength(int max);

3. 获取某个标签的文字：getTagText(int position)

String text = mTagContainerLayout.getTagText(int position);

4. 获取所有标签的文字：getTags()

List<String> list = mTagContainerLayout.getTags();

5. 可拖拽模式（container_enable_drag="true"）下获取标签状态，：getTagViewState()

/**共3种状态
1.ViewDragHelper.STATE_IDLE             空闲状态
2.ViewDragHelper.STATE_DRAGGING   正在拖拽状态
3.ViewDragHelper.STATE_SETTLING     正在设置状态
**/
int state = mTagContainerLayout.getTagViewState();

6. 设置主题，如果要自定义主题，切记先设置主题ColorFactory.NONE，然后再设置其他属性setTheme(int theme)

// 设置自带主题
mTagContainerLayout.setTheme(ColorFactory.PURE_CYAN);
.
// 设置自定义主题
mTagContainerLayout.setTheme(ColorFactory.NONE);
mTagContainerLayout.setTagBackgroundColor(Color.TRANSPARENT);

7. 设置文本方向：setTagTextDirection(int direction)

/**共2种方向
1.View.TEXT_DIRECTION_LTR  由左到右
2.View.TEXT_DIRECTION_RTL  由右到左
**/
mTagContainerLayout.setTagTextDirection(View.TEXT_DIRECTION_RTL);

8. 设置标签的文本字体：setTagTypeface(Typeface typeface)

Typeface typeface = Typeface.createFromAsset(getAssets(), "iran_sans.ttf");
mTagContainerLayout.setTagTypeface(typeface);

9. 设置标签，参数为 List<String> 或 String[]：setTags()

mTagContainerLayout.setTags(List<String> tags);

10. 添加单个标签（末尾）：addTag(String text)

mTagContainerLayout.addTag(String text);

11. 在指定位置添加单个标签（即当前位置的标签之前），：addTag(String text, int position)

mTagContainerLayout.addTag(String text, int position);

12. 删除指定位置的标签：removeTag(int position)

mTagContainerLayout.removeTag(int position);

13. 删除所有标签：removeAllTags()

mTagContainerLayout.removeAllTags();