作为Android官方提供的评分控件，RatingBar对于大家来说是比较熟悉的，但大部分人在用过原生RatingBar后肯定对它不满意，因为实在是不好用。这里的不好用包括了：大小改起来不方便、星星间距不好改、使用自己的图片居然还要写xml……总之你很难说出它的优点来，缺点却是脱口而出。
有鉴于此，自己写一个自定义的RatingBar就有必要了，而且要保证实现一些常用的属性，如大小、间距、点击事件等。考虑到这个控件是要在实际项目中发挥作用，而实际工作里是有UI设计给切图的，所以就没有在控件里自己去画星星，而是直接用切图来展示。当然，以后我会考虑使用Canvas直接画星星，这样使用的时候只需要给出颜色值就能得到想要的星星了。
好吧，这个项目我把它命名为NiceRatingBar，你可以在Github找到它的源码：https://github.com/KaelLi1989/NiceRatingBar。当然，这是一个新发布的项目，功能目前比较单一，只支持使用图片来展示星星，不能只输入颜色就自己画星星，并且最低支持到0.5的颗粒度，还无法做到0.1分的颗粒度（更低就没必要了）。当然，这些feature未来会支持的。
一般来说一个评分控件需要有2种基本功能：一种是仅仅展示评分，无法继续操作更改评分；另一种就是可以更改评分。这2种基本功能，NiceRatingBar当然都实现了，仅仅展示评分一般用在商品列表和当前用户已经评分过的、不能重复评分的商品详情页面，能更改评分的地方一般就是用户对某个商品进行评分了。本控件支持传统的点击星星评分，也支持随手势左右滑动进行线性评分。
通过点击星星来设置分数
NiceRatingBar的使用很简单，大概分下面这么几部：
- 添加jitpack仓库，因为项目发布在Github，最终用jitpack打包，所以如果你的项目里没有jitpack仓库，需要添加一下。具体的方法是，在项目的根gradle文件，增加jitpack的仓库地址：
allprojects {
repositories {
……
maven { url 'https://jitpack.io' }
}
}
- 在相应的module的gradle里添加NiceRatingBar的依赖：
implementation 'com.github.KaelLi1989:NiceRatingBar:1.0.0'
当然如果你把依赖放在了项目的公共基础模块里，那么就要这样：
api 'com.github.KaelLi1989:NiceRatingBar:1.0.0'
- 在布局文件里进行控件的声明，需要注意有几项属性是必须设置的：
<com.kaelli.niceratingbar.NiceRatingBar
android:id="@+id/niceRatingBar"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
// int型，代表满分，默认是5
app:nrb_starTotal="10"
// 每个星星的宽度
app:nrb_starImageWidth="16dp"
// 每个星星的高度
app:nrb_starImageHeight="16dp"
// 一颗完整星星的图片资源，是必须设置的属性
app:nrb_starFullResource="@drawable/ic_star_black_16dp"
// 一颗空白星星的图片资源，是必须设置的属性
app:nrb_starHalfResource="@drawable/ic_star_border_black_16dp"
// 半颗星星的图片资源，非必须。若设置了，则支持半颗星的展示与评分，否则仅支持整颗星效果
app:nrb_starEmptyResource="@drawable/ic_star_half_black_16dp"
// float型，初始评分值，非必须
app:nrb_rating="1.1"
// 星星之间的间距
app:nrb_starImagePadding="2dp"
// Enable表示用户可以进行评分，Disable则表示不可评分，仅展示评分
app:nrb_ratingStatus="Enable" />
- 然后在Java(Kotlin)代码里进行相应的设置，比如你希望监听到用户的评分：
niceRatingBar.setOnRatingChangedListener(new OnRatingChangedListener() {
@Override
public void onRatingChanged(float rating) {
// 在这里得到的rating就是用户通过控件得到的评分，通常你应该用通过接口把这个评分传到服务端
}
});
当把评分传到服务端成功后，在接口成功的回调里，你可以使用
niceRatingBar. setRatingStatus(RatingStatus.Disable);
这样控件的状态就变成了不能操作评分，只能展示评分了。之所以这样操作，是因为通常一个对象（如一件商品）只允许同一个用户评分1次，如果你允许多次评分那就没必要关闭打分了。
如果服务端提前获取数据，某个商品的评分是4.5分，而且只是展示评分不能打分，那么就要使用下面的代码，来设置评分，同时关闭更改评分的能力：
niceRatingBar. setRating(4.7f); niceRatingBar. setRatingStatus(RatingStatus.Disable);
是的，NiceRatingBar的使用就是这么简单，马上替换掉那个难用的原生RatingBar吧。
评论