介紹

可自定義的標簽視圖，支持添加標簽，點擊，長按彈出刪除對話框，以及拖拽排序。

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();