# Android-Cloud-TagView-Plus

**Repository Path**: androidfm/Android-Cloud-TagView-Plus

## Basic Information

- **Project Name**: Android-Cloud-TagView-Plus
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2015-09-23
- **Last Updated**: 2025-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Android-Cloud-TagView-Plus
###Introduction
An Android Cloud Tag Widget. You can edit the tag's style, and set listener of selecting or deleting tag. Used in APP with ten millions of users. 

###Screenshot
`Sample`

![Sample](https://lh3.googleusercontent.com/N3-r6Z_F0Uu3hT5Fs4H4y0SNW5pjaUuBMu3qLZsPgoQ=s600)

`used in app with ten millions of users(YY)`

![enter image description here](https://lh3.googleusercontent.com/-okm7rbiOw40/VUbX3t_SPxI/AAAAAAAAA_8/q1JBPKQpQyw/s600/Screenshot_2015-03-27-16-35-42.png)

###Feature

- Editable Style of Text, such as Font size and color.
- Editable Style of Tag, Background/Pressed Color, Radius effect, Custom Background, Delete mode.
- Listener of tag selecting and deleting.
- Can be created from XML file or Java code.

###Sample Apk
[download apk](raw/sample-debug.apk)

###Usage
used in xml file
```java
<me.kaede.tagview.TagView
            android:id="@+id/tagview"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_marginTop="10dp"
            app:lineMargin="5dp"
            app:tagMargin="3dp"
            app:textPaddingBottom="3dp"
            app:textPaddingLeft="10dp"
            app:textPaddingRight="10dp"
            app:textPaddingTop="3dp">
</me.kaede.tagview.TagView>
```
or used by java code
```java
TagView tagview2 = new TagView(this);
tagview2.setLineMargin(20f);//dp
tagview2.setTagMargin(20f);
tagview2.setTextPaddingLeft(20f);
tagview2.setTextPaddingTop(20f);
tagview2.setTextPaddingRight(20f);
tagview2.setTexPaddingBottom(20f);
```
add a lot of tags
```java
String[] tags = getResources().getStringArray(R.array.continents);
tagView.addTags(tags);
```
add a tag in details
```java
Tag tag = new Tag("Tag Text");
tag.tagTextColor = Color.parseColor("#FFFFFF");
tag.layoutColor =  Color.parseColor("#DDDDDD");
tag.layoutColorPress = Color.parseColor("#555555");
//or tag.background = this.getResources().getDrawable(R.drawable.custom_bg);
tag.radius = 20f;
tag.tagTextSize = 14f;
tag.layoutBorderSize = 1f;
tag.layoutBorderColor = Color.parseColor("#FFFFFF");
tag.isDeletable = true;
tagView.addTag(tag);
```

###To-Do List

 - Animation Support 
 - Multi Tag Arrange Type (such as Right-To-Left arrange)
 - Improve Performance

###Problem
TagView supports to be used as ItemView in ListView/GridView/RecyclerView, but it will remove and re-add its tags very frequently when you are flinging. Therefore the performance of TagView in ItemView maybe not good if you have a lot of ItemViews using TagView. And in this situation it is advised to use `SpannableString` instead of views. I will add `SpannableString` version of TagView to improve the performance in ItemView.

###Substitute

- https://github.com/namito/TagCloudLinkView
- https://github.com/mcharmas/android-tagview

##中文
###简介
Android上的云标签控件，除了能设置标签的样式外，还能监听标签的点击和删除事件。目前已在千万级用户的应用上使用。

###特点

- 支持设置标签内容的样式，如字体大小、颜色
- 支持设置标签的颜色（或者自定义布局）、点击效果、圆角效果、是否可删除
- 能监听标签的点击和删除事件
- 支持从代码或者XML创建TagView

###待完成

- 动画效果

###License

    Copyright 2015 Kaede Akatsuki

    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.