Home

Awesome

AndroidTagGroup

Release 1.4 Maven Central Android Arsenal Build Status

The TagGroup is a special layout with a set of tags. You can use it to tag people, books or anything you want.

Also you can contribute new idea to me.

Demo

Screenshot

screenshot1

Edit Tags

screenshot2 screenshot3

Download Demo

Usage

Step 1

Gradle

dependencies {
   compile 'me.gujun.android.taggroup:library:1.4@aar'
}

Maven

<dependency>
    <groupId>me.gujun.android.taggroup</groupId>
    <artifactId>library</artifactId>
    <version>1.4</version>
    <type>apklib</type>
</dependency>

Step 2

Use it in your own code:

<me.gujun.android.taggroup.TagGroup
    android:id="@+id/tag_group"
    style="@style/TagGroup" />
TagGroup mTagGroup = (TagGroup) findViewById(R.id.tag_group);
mTagGroup.setTags(new String[]{"Tag1", "Tag2", "Tag3"});

Use setTags(...) to set the initial tags in the group.

How to submit a new tag?

To "submit" a new tag as user press "Enter" or tap the blank area of the tag group, also you can "submit" a new tag via submitTag().

Note: Google keyboard (a few soft keyboard not honour the key event) currently not supported "Enter" key to "submit" a new tag.

How to delete a tag?

To delete a tag as user press "Backspace" key or double-tap the tag which you want to delete.

How to detect tag click event?

Implement a callback interface: TagGroup.OnTagClickListener, and set the listener via setOnTagClickListener().

Build

run ./gradlew assembleDebug (Mac/Linux)

or

run gradlew.bat assembleDebug (Windows)

Attributes

There are several attributes you can set:

Dimension illustrate

attrdefaultmean
atg_isAppendModefalseDetermine the TagGroup mode, APPEND or single DISPLAY.
atg_inputHintAdd Tag/添加标签The hint of the INPUT tag.
atg_borderColor#49C120The tag outline border color.
atg_textColor#49C120The tag text color.
atg_backgroundColor#FFFFFFThe tag background color.
atg_dashBorderColor#AAAAAAThe tag dash outline border color.
atg_inputHintColor#80000000The input tag hint text color.
atg_inputTextColor#DE000000The input tag type text color..
atg_checkedBorderColor#49C120The checked tag outline border color.
atg_checkedTextColor#FFFFFFThe checked text color.
atg_checkedMarkerColor#FFFFFFThe checked marker color.
atg_checkedBackgroundColor#49C120The checked tag background color.
atg_pressedBackgroundColor#EDEDEDThe tag background color when the tag is being pressed.
atg_borderStrokeWidth0.5dpThe tag outline border stroke width.
atg_textSize13spThe tag text size.
atg_horizontalSpacing8dpThe horizontal tag spacing.(Mark1)
atg_verticalSpacing4dpThe vertical tag spacing.(Mark2)
atg_horizontalPadding12dpThe horizontal tag padding.(Mark3)
atg_verticalPadding3dpThe vertical tag padding.(Mark4)

Developed By

Jun Gu - 2dxgujun@gmail.com

<a href="http://weibo.com/2dxgujun"> <img alt="Follow me on Weibo" src="http://ww4.sinaimg.cn/large/bce2dea9gw1epjhk9h9m6j20230233yb.jpg"/> </a> <a href="https://plus.google.com/u/0/113657331852211913645"> <img alt="Follow me on Google Plus" src="http://ww1.sinaimg.cn/large/bce2dea9gw1epjhbx0ouij2023023jr6.jpg"/> </a>

License

Copyright 2015 Jun Gu

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.