# TagView

**Repository Path**: xiongwg/TagView

## Basic Information

- **Project Name**: TagView
- **Description**: 动态的文字标签
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2021-08-13
- **Last Updated**: 2021-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TagView

#### 项目介绍
- 项目名称：TagView文本标签
- 所属系列：openharmony的第三方组件适配移植
- 功能：实现文本可操作标签
- 项目移植状态：主功能完成
- 调用差异：无
- 开发版本：sdk6，DevEco Studio2.2 Beta1
- 基线版本：Release 1.3

#### 效果演示

<img src="gif/screen.gif"></img>

#### 安装教程

1.在项目根目录下的build.gradle文件中，
 ```
 allprojects {
    repositories {
        maven {
            url 'https://s01.oss.sonatype.org/content/repositories/releases/'
        }
    }
 }
```
2.在entry模块的build.gradle文件中，
 ```
 dependencies {
    implementation('com.gitee.chinasoft_ohos:TagView:1.0.0')
    ......  
 }
```

在sdk6，DevEco Studio2.2 Beta1下项目可直接运行
如无法运行，删除项目.gradle,.idea,build,gradle,build.gradle文件，
并依据自己的版本创建新项目，将新项目的对应文件复制到根目录下

#### 使用说明

组件主要是继承DependentLayout实现的Text标签动态操作类，都包含标签的动态添加，删除，监听等操作

XML中添加控件:

```xml
   <com.cunoraz.tagview.TagView
            ohos:id="$+id:tag_group"
            ohos:width="match_parent"
            ohos:height="match_parent"
            ohos:margin="10vp"
            app:lineMargin="10"
            app:tagMargin="10"
            app:textPaddingLeft="10"
            app:textPaddingRight="10"
            app:textPaddingTop="10"
            app:textPaddingBottom="10"/>
```

文本标签初始化数据，添加监听事件操作:

```java
 TagView tagGroup = (TagView)findviewById(R.id.tag_view);
 //You can add one tag
 tagGroup.addTag(Tag tag);
 //You can add multiple tag via ArrayList
 tagGroup.addTags(ArrayList<Tag> tags);
 //Via string array
 addTags(String[] tags);
  //set click listener
     tagGroup.setOnTagClickListener(new OnTagClickListener() {
           @Override
           public void onTagClick(Tag tag, int position) {
           }
       });
       
  //set delete listener
           tagGroup.setOnTagDeleteListener(new OnTagDeleteListener() {
           @Override
           public void onTagDeleted(final TagView view, final Tag tag, final int position) {
           }
       });

//set long click listener
     tagGroup.setOnTagLongClickListener(new OnTagLongClickListener() {
           @Override
           public void onTagLongClick(Tag tag, int position) {
           }
       });
```

自定义MaterialSpinner控件，可以添加自定义属性，具体可用属性如下:

| name                    | type      | info                                                   |
|-------------------------|-----------|--------------------------------------------------------|
| lineMargin              | int       | sets the evey lineMargi                                |
| tagMargin               | int       | set  the tagMargin                                     |
| textPaddingLeft         | int       | set the  textPaddingLeft                               |
| textPaddingRight        | int       | set the  textPaddingRight                              |
| textPaddingTop          | int       | set the  textPaddingTop                                |
| textPaddingBottom       | int       | set the  textPaddingBottom                             |

#### 测试信息

CodeCheck代码测试无异常

CloudTest代码测试无异常

病毒安全检测通过

当前版本demo功能与原组件基本无差异

#### 版本迭代

- 1.0.0

#### 版权和许可信息

<pre>
Copyright 2015 Cüneyt Çarıkçi.

Licensed under the Apache License, Version 2.0 (the "License"); you may not 
use this file except in compliance with the License. You may obtain a copy 
of the License at 

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed
under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR 
CONDITIONS OF ANY KIND,either express or implied. See the License for the 
specific language governing permissions and limitations under the License.
</pre>