Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/master'
Browse files Browse the repository at this point in the history
  • Loading branch information
qstumn committed Mar 21, 2017
2 parents 86def9b + baa26db commit 6ab8672
Showing 1 changed file with 17 additions and 37 deletions.
54 changes: 17 additions & 37 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,84 +5,64 @@

![](https://github.com/qstumn/BadgeView/blob/master/demo_gif.gif?raw=true)

###一些特性
* 随意定制外观,包括Badge位置、底色、阴影、文字颜色、大小、内外边距等
### 一些特性
* 随意定制外观,包括Badge位置、底色、边框、阴影、文字颜色(支持透明色)、大小、内外边距等

* Badge数字小于0时显示dot,等于0时隐藏整个Badge,在普通模式下超过99时显示99+,精确模式下显示具体值

* 支持设置文本内容

* 支持设置图片背景

* 支持类似QQ的拖拽消除效果(默认关闭)

* 支持以动画的方式隐藏Badge

## how to use:
###1. gradle
### 1. gradle
```groovy
compile 'q.rorbin:badgeview:VERSION_CODE'
```
VERSION_CODE : [here](https://github.com/qstumn/BadgeView/releases)

###2. code
### 2. code
```java
new QBadgeView(context).bindTarget(textview).setBadgeNumber(5);
```

###3. 方法说明
### 3. 方法说明
code | 说明
--- | ---
setBadgeNumber | 设置Badge数字
setBadgeText | 设置Badge文本
setBadgeTextSize | 设置数值大小
setBadgeTextColor | 设置数值颜色
setBadgeTextSize | 设置文本字体大小
setBadgeTextColor | 设置文本颜色
setExactMode | 设置是否显示精确模式数值
setBadgeGravity | 设置Badge相对于TargetView的位置
setGravityOffset | 设置外边距
setBadgePadding | 设置内边距
setBadgeBackgroundColor | 设置背景色
setBadgeBackground | 设置背景图片
setShowShadow | 设置是否显示阴影
setOnDragStateChangedListener | 打开拖拽消除模式并设置监听
stroke | 描边
hide | 隐藏Badge

###4.在ListView或者RecyclerView中使用
### 4.在ListView或者RecyclerView中使用
可参考demo中[ListViewActivity](https://github.com/qstumn/BadgeView/blob/master/app/src/main/java/q/rorbin/badgeviewdemo/ListViewActivity.java)[RecyclerViewActivity](https://github.com/qstumn/BadgeView/blob/master/app/src/main/java/q/rorbin/badgeviewdemo/RecyclerViewActivity.java)

###5.一些注意事项
### 5.一些注意事项
* 请不要在xml中创建Badge
* Badge和TargetView绑定是采用替换TargetView的Parent方式实现的,同时将Parent的Id和TargetView的Id设置成一样来保证不会在RelativeLayout中出现位置错乱问题,所以在bindTarget后再次使用findViewById(TargetViewId)得到的会是Parent而不是TargetView,此时建议使用Badge.getTargetView方法来获取TargetView,如果您有更好的解决方式并愿意和我分享,请在Issues中提交给我或者给我发邮件,谢谢。

###6.更新计划

1 . 自定义复杂的背景
2 . 多种隐藏动画

####Change Log History
```
v1.0.6
1、添加了setBadgeText方法
2、添加了setGravityOffset(float x , float y)方法,可以用来分别设置x和y方向的偏移量
3、优化隐藏动画,现在严格按照Badge的的大小生成隐藏动画
4、修复Badge宽度过宽时只有触摸中心才能触发拖拽的BUG
5、修改setBadgeNumberSize为setBadgeTextSize,setBadgeNumberColor改为setBadgeTextColor
v1.0.5
添加了getTargetView方法
v1.0.4
1. 修复在hide、bindTarget在某些情况下会出现异常崩溃的BUG
2. BadgeGravity新增CENTER | TOP、CENTER | BOTTOM、CENTER | START、CENTER | END
3. demo中添加了在ListView、RecyclerView中使用的例子
v1.0.2
1. 修复了在ScrollView中bindTarget会导致拖拽消除时起始拖拽位置不正确的BUG
2. 减少了隐藏动画的碎片数量,降低内存占用
```
### 6.更新计划
添加富文本内容

###5.Thanks For
### 5.Thanks For

https://github.com/mabeijianxi/stickyDots

#LICENSE
# LICENSE
```
Copyright 2017, RorbinQiu
Expand Down

0 comments on commit 6ab8672

Please sign in to comment.