android自定义ratingbar，灵活性极高

XLhRatingBar

一个自定义的android RatingBar，无固定样式，一切由你指定。

image

https://github.com/xingliuhua/XLHRatingBar欢迎点击star。

背景

我们常常要使用到RatingBar来做一些评分、进度、等级功能。android.widget.RatingBar可以实现一些简单效果，我们可以利用

layer-list和android:progressDrawable。我们还可以放置一些图片，当点击的时候改变图片的样式来实现。

我们如果想实现一些复杂的效果，这些方案就有点麻烦了：

• 每次半颗星

• 每颗星的大小不一

• 第1、3、5是半颗，第2、4、6是整颗

• 竖向或者斜向放置

他们都显得那么笨重，不够灵活，扩展性也非常差。

功能

• 每个内部单元控件（就是星星）有三种状态：未选中、选中一半、全选中。

• 内部单元控件的选中状态由用户在回调中根据点击的位置自己判断。

• 自定义每个内部单元控件的样式，用户可根据单元控件的位置、状态动态返回控件。

• 自定义属性或代码设置内部单元控件的总数，已选个数。

• 选中状态的监听。

安装

dependencies {

//other dependencies...

compile 'com.xingliuhua:xlhratingbar_lib:4.0'

}

使用

SimpleRatingView

该库以及默认实现了简单的样式及功能,默认共5颗星，每次最小可以改变半颗。可以直接在代码或xml文件中使用。

XLHRatingBar xlhRatingBar = new XLHRatingBar(this);

//添加到容器布局中即可

或者在xml布局中

android:layout_width="match_parent"

android:layout_height="wrap_content"

app:numStars="5"

app:rating="2.5" />

自定义样式

实现接口IRatingView

IRatingView就是单个内部控件的行为抽象，你可以根据自己的业务需求来返回对应的值，可以参考SimpleRatingView默认实现。

public interface IRatingView {

/**

* you can change your item style by state and position. eg:color,text size.

* @param state STATE_NONE,STATE_HALF,STATE_FULL

* @param position star index. start from 0

* @param starNums star item number

*/

void setCurrentState(int state,int position,int starNums);

/**

* return you start item view,you can custom item by positon

* @param context

* @param position star index. start from 0

* @param starNums star item number

* @return

*/

ViewGroup getRatingView(Context context,int position,int starNums);

/**

* not selected

*/

public static final int STATE_NONE = 0;

/**

* select half

*/

public static final int STATE_HALF = 1;

/**

* selected

*/

public static final int STATE_FULL = 2;

}

在布局中引用并指定IRatingView的实现类。

xmlns:app="http://schemas.android.com/apk/res-auto"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:gravity="center_vertical"

app:numStars="5"

app:rating="5"

app:ratingViewClass="com.example.xlhratingbar_lib.SimpleRatingView"

/>

代码中使用

LinearLayout llContainer = (LinearLayout) findViewById(R.id.ll_container);

XLHRatingBar xlhRatingBar = new XLHRatingBar(this);

xlhRatingBar.setNumStars(3);

xlhRatingBar.setEnabled(false);//can not change rating by touch

xlhRatingBar.setRatingViewClassName("com.example.xlhratingbar.MyRatingView4");

xlhRatingBar.setOnRatingChangeListener(new XLHRatingBar.OnRatingChangeListener() {

@Override

public void onChange(float rating, int numStars) {

Toast.makeText(getApplicationContext(), "rating:" + rating, 0).show();

}

});

llContainer.addView(xlhRatingBar);

欢迎大家点击star。