NiceRatingBar:比Android原生RatingBar更好用的评分控件

KaelLi 2019年11月22日14:26:59
评论
3,128

作为Android官方提供的评分控件,RatingBar对于大家来说是比较熟悉的,但大部分人在用过原生RatingBar后肯定对它不满意,因为实在是不好用。这里的不好用包括了:大小改起来不方便、星星间距不好改、使用自己的图片居然还要写xml……总之你很难说出它的优点来,缺点却是脱口而出。

有鉴于此,自己写一个自定义的RatingBar就有必要了,而且要保证实现一些常用的属性,如大小、间距、点击事件等。考虑到这个控件是要在实际项目中发挥作用,而实际工作里是有UI设计给切图的,所以就没有在控件里自己去画星星,而是直接用切图来展示。当然,以后我会考虑使用Canvas直接画星星,这样使用的时候只需要给出颜色值就能得到想要的星星了。

好吧,这个项目我把它命名为NiceRatingBar,你可以在Github找到它的源码:https://github.com/KaelLi1989/NiceRatingBar。当然,这是一个新发布的项目,功能目前比较单一,只支持使用图片来展示星星,不能只输入颜色就自己画星星,并且最低支持到0.5的颗粒度,还无法做到0.1分的颗粒度(更低就没必要了)。当然,这些feature未来会支持的。

一般来说一个评分控件需要有2种基本功能:一种是仅仅展示评分,无法继续操作更改评分;另一种就是可以更改评分。这2种基本功能,NiceRatingBar当然都实现了,仅仅展示评分一般用在商品列表和当前用户已经评分过的、不能重复评分的商品详情页面,能更改评分的地方一般就是用户对某个商品进行评分了。本控件支持传统的点击星星评分,也支持随手势左右滑动进行线性评分。

NiceRatingBar:比Android原生RatingBar更好用的评分控件

通过点击星星来设置分数

NiceRatingBar:比Android原生RatingBar更好用的评分控件

NiceRatingBar的使用很简单,大概分下面这么几部:

  1. 添加jitpack仓库,因为项目发布在Github,最终用jitpack打包,所以如果你的项目里没有jitpack仓库,需要添加一下。具体的方法是,在项目的根gradle文件,增加jitpack的仓库地址:
allprojects {
    repositories {
        ……
        maven { url 'https://jitpack.io' }
    }
}
  1. 在相应的module的gradle里添加NiceRatingBar的依赖:
implementation 'com.github.KaelLi1989:NiceRatingBar:1.0.0'

当然如果你把依赖放在了项目的公共基础模块里,那么就要这样:

api 'com.github.KaelLi1989:NiceRatingBar:1.0.0'
  1. 在布局文件里进行控件的声明,需要注意有几项属性是必须设置的:
<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" />
  1. 然后在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吧。

KaelLi
  • 本文由 发表于 2019年11月22日14:26:59
  • 转载请务必保留本文链接:https://www.kaelli.com/41.html
匿名

发表评论

匿名网友 填写信息

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen: