Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/2dxgujun/AndroidTagGroup
:four_leaf_clover:A beautiful android tag group widget.
https://github.com/2dxgujun/AndroidTagGroup
Last synced: about 2 months ago
JSON representation
:four_leaf_clover:A beautiful android tag group widget.
- Host: GitHub
- URL: https://github.com/2dxgujun/AndroidTagGroup
- Owner: 2dxgujun
- License: apache-2.0
- Created: 2015-02-10T07:42:57.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-11-04T08:47:55.000Z (almost 3 years ago)
- Last Synced: 2024-06-27T12:31:03.826Z (3 months ago)
- Language: Java
- Homepage:
- Size: 793 KB
- Stars: 2,477
- Watchers: 76
- Forks: 513
- Open Issues: 74
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
README
# `AndroidTagGroup`
[](https://github.com/2dxgujun/AndroidTagGroup/releases)
[](https://maven-badges.herokuapp.com/maven-central/me.gujun.android.taggroup/library)
[](https://android-arsenal.com/details/1/1539)
[](https://travis-ci.org/2dxgujun/AndroidTagGroup)
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
### Edit Tags
[Download Demo](https://github.com/2dxgujun/AndroidTagGroup/releases/download/v1.4/AndroidTagGroup-Demo-v1.4.apk)
# Usage
## Step 1
#### Gradle
```groovy
dependencies {
compile 'me.gujun.android.taggroup:library:1.4@aar'
}
```
#### Maven
```xml
me.gujun.android.taggroup
library
1.4
apklib
```
## Step 2
Use it in your own code:
```xml
```
```java
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:
| attr | default | mean |
|:------------------------- |:---------------- |:------------------------------------------------------- |
| atg_isAppendMode | false | Determine the TagGroup mode, APPEND or single DISPLAY. |
| atg_inputHint | Add Tag/添加标签 | The hint of the INPUT tag. |
| atg_borderColor | #49C120 | The tag outline border color. |
| atg_textColor | #49C120 | The tag text color. |
| atg_backgroundColor | #FFFFFF | The tag background color. |
| atg_dashBorderColor | #AAAAAA | The tag dash outline border color. |
| atg_inputHintColor | #80000000 | The input tag hint text color. |
| atg_inputTextColor | #DE000000 | The input tag type text color.. |
| atg_checkedBorderColor | #49C120 | The checked tag outline border color. |
| atg_checkedTextColor | #FFFFFF | The checked text color. |
| atg_checkedMarkerColor | #FFFFFF | The checked marker color. |
| atg_checkedBackgroundColor| #49C120 | The checked tag background color. |
| atg_pressedBackgroundColor| #EDEDED | The tag background color when the tag is being pressed. |
| atg_borderStrokeWidth | 0.5dp | The tag outline border stroke width. |
| atg_textSize | 13sp | The tag text size. |
| atg_horizontalSpacing | 8dp | The horizontal tag spacing.(Mark1) |
| atg_verticalSpacing | 4dp | The vertical tag spacing.(Mark2) |
| atg_horizontalPadding | 12dp | The horizontal tag padding.(Mark3) |
| atg_verticalPadding | 3dp | The vertical tag padding.(Mark4) |
# Developed By
Jun Gu - <[email protected]>
# 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.