Android自定义View实现星星评分效果

前言

在前面的学习中，我们基本了解了一些 Canvas 的绘制，那么这一章我们一起复习一下图片的绘制几种方式，和事件的简单交互方式。

我们从易到难，作为基础的进阶控件，我们从最简单的交互开始，那就自定义一个星星评分的控件吧。

一个 App 必不可少的评论系统打分的控件，可以展示评分，可以点击评分，可以滑动评分。它的实现总体上可以分为以下的步骤：

• 强制测量大小为我们指定的大小

• 先绘制Drawable未评分的图片

• 在绘制Bitmap已评分的图片

• 在onTouch中点击和移动的事件中动态计算当前的评分，进而刷新布局

• 回调的处理与属性的抽取

思路我们已经有了，下面一步一步的来实现吧。

话不多说，Let's go

1、测量与图片的绘制

我们需要绘制几个星星，那么我们必须要设置的几个属性：

当前的评分值，总共有几个星星，每一个星星的间距和大小，选中和未选中的Drawable图片：

private int mStarDistance = 0;
   private int mStarCount = 5;
   private int mStarSize = 20;    //每一个星星的宽度和高度是一致的
   private float mScoreNum = 0.0F;  //当前的评分值
   private Drawable mStarScoredDrawable;  //已经评分的星星图片
   private Drawable mStarUnscoredDrawable;  //还未评分的星星图片

private void init(Context context, AttributeSet attrs) {

mScoreNum = 2.1f;
       mStarSize = context.getResources().getDimensionPixelSize(R.dimen.d_20dp);
       mStarDistance = context.getResources().getDimensionPixelSize(R.dimen.d_5dp);
       mStarScoredDrawable = context.getResources().getDrawable(R.drawable.iv_normal_star_yellow);
       mStarUnscoredDrawable = context.getResources().getDrawable(R.drawable.iv_normal_star_gray);
   }

测量布局的时候，我们就不能根据xml设置的 match_parent 或 wrap_content 来设置宽高，我们需要根据星星的大小与间距来动态的计算，所以不管xml中如何设置，我们都强制性的使用我们自己的测量。

星星的数量 * 星星的宽度再加上中间的间距 * 数量-1，就是我们的控件宽度，控件高度则是星星的高度。

具体的确定测量我们再上一篇已经详细的复习过了，这里直接贴代码：

@Override
   protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
       setMeasuredDimension(mStarSize * mStarCount + mStarDistance * (mStarCount - 1), mStarSize);
   }

这样就可以得到对应的测量宽高 （加一个背景方便看效果）：

如何绘制星星？直接绘制Drawable即可，默认的Drawable的绘制为:

@Override
   protected void onDraw(Canvas canvas) {
       super.onDraw(canvas);

for (int i = 0; i < mStarCount; i++) {
           mStarUnscoredDrawable.setBounds((mStarDistance + mStarSize) * i, 0, (mStarDistance + mStarSize) * i + mStarSize, mStarSize);
           mStarUnscoredDrawable.draw(canvas);
       }

}

如果有5个星星图片，那么就为每一个星星定好位置：

那么已经选中的图片也需要使用这种方法绘制吗？

计算当前的评分，然后计算计算需要绘制多少星星，那么就是这样做：

int score = (int) Math.ceil(mScoreNum);
   for (int i = 0; i < score; i++) {
       mStarScoredDrawable.setBounds((mStarDistance + mStarSize) * i, 0, (mStarDistance + mStarSize) * i + mStarSize, mStarSize);
       mStarScoredDrawable.draw(canvas);
   }

可是这么做不符合我们的要求啊 ，我们是需要是可以显示评分为2.5之类值，那么我们怎么能绘制半颗星呢？Drawable.draw(canvas) 的方式满足不了，那我们可以使用 BitmapShader 的方式来绘制。

初始化一个 BitmapShader 设置给 Paint 画笔，通过画笔就可以画出对应的形状。

比如此时的场景，我们如果想只画0.5个星星，那么我们就可以

paint = new Paint();
   paint.setAntiAlias(true);
   paint.setShader(new BitmapShader(drawableToBitmap(mStarScoredDrawable), BitmapShader.TileMode.CLAMP, BitmapShader.TileMode.CLAMP));

@Override
   protected void onDraw(Canvas canvas) {
       for (int i = 0; i < mStarCount; i++) {
           mStarUnscoredDrawable.setBounds((mStarDistance + mStarSize) * i, 0, (mStarDistance + mStarSize) * i + mStarSize, mStarSize);
           mStarUnscoredDrawable.draw(canvas);
       }

canvas.drawRect(0, 0, mStarSize * mScoreNum, mStarSize, paint);
   }

那么如果是大于一个星星之后的小数点就可以用公式计算

if (mScoreNum > 1) {
       canvas.drawRect(0, 0, mStarSize, mStarSize, paint);

if (mScoreNum - (int) (mScoreNum) == 0) {
           //如果评分是3.0之类的整数，那么直接按正常的rect绘制
           for (int i = 1; i < mScoreNum; i++) {
               canvas.translate(mStarDistance + mStarSize, 0);
               canvas.drawRect(0, 0, mStarSize, mStarSize, paint);
           }
       } else {
           //如果是小数例如3.5，先绘制之前的3个，再绘制后面的0.5
           for (int i = 1; i < mScoreNum - 1; i++) {
               canvas.translate(mStarDistance + mStarSize, 0);
               canvas.drawRect(0, 0, mStarSize, mStarSize, paint);
           }
           canvas.translate(mStarDistance + mStarSize, 0);
           canvas.drawRect(0, 0, mStarSize * (Math.round((mScoreNum - (int) (mScoreNum)) * 10) * 1.0f / 10), mStarSize, paint);
       }

} else {
       canvas.drawRect(0, 0, mStarSize * mScoreNum, mStarSize, paint);
   }

效果：

关于 BitmapShader 的其他用法，可以翻看我之前的自定义圆角圆形View，和自定义圆角容器的文章，里面都有用到过，主要是方便一些图片的裁剪和缩放等。

2、事件的交互与计算

这里并没有涉及到什么事件嵌套，拦截之类的复杂处理，只需要处理自身的 onTouch 即可。而我们需要处理的就是按下的时候和移动的时候评分值的变化。

在onDraw方法中，我们使用 mScoreNum 变量来绘制的已评分的 Bitmap 绘制。所以这里我们只需要在 onTouch 中计算出对应的 mScoreNum 值，让其重绘即可。

@Override
   public boolean onTouchEvent(MotionEvent event) {

//x轴的宽度做一下最大最小的限制
       int x = (int) event.getX();
       if (x < 0) {
           x = 0;
       }
       if (x > mMeasuredWidth) {
           x = mMeasuredWidth;
       }

switch (event.getAction()) {
           case MotionEvent.ACTION_DOWN:
           case MotionEvent.ACTION_MOVE: {
               mScoreNum = x * 1.0f / (mMeasuredWidth * 1.0f / mStarCount);
               invalidate();
               break;
           }
           case MotionEvent.ACTION_UP: {
               break;
           }
       }

return super.onTouchEvent(event);

}

计算出一颗星的长度，然后计算当前x轴的长度，就可以计算出当前有几颗星，我们默认处理的是 float 类型。就可以根据计算出的 mScoreNum 值来得到对应的动画效果：

3. 回调处理与自定义属性抽取

到此效果的实现算是结束了，但是我们还有一些收尾工作没做，如何监听进度的回调，如何控制整数与浮点数的显示，是否支持触摸等等。然后对其做一些自定义属性的抽取，就可以在应用中比较广泛的使用了。

自定义属性：

private int mStarDistance = 5;
   private int mStarCount = 5;
   private int mStarSize = 20;    //每一个星星的宽度和高度是一致的
   private float mScoreNum = 0.0F;  //当前的评分值
   private Drawable mStarScoredDrawable;  //已经评分的星星图片
   private Drawable mStarUnscoredDrawable;  //还未评分的星星图片
   private boolean isOnlyIntegerScore = false;  //默认显示小数类型
   private boolean isCanTouch = true; //默认支持控件的点击
   private OnStarChangeListener onStarChangeListener;

自定义属性的赋值与初始化操作：

private void init(Context context, AttributeSet attrs) {
       setClickable(true);
       TypedArray mTypedArray = context.obtainStyledAttributes(attrs, R.styleable.StarScoreView);
       this.mStarDistance = mTypedArray.getDimensionPixelSize(R.styleable.StarScoreView_starDistance, 0);
       this.mStarSize = mTypedArray.getDimensionPixelSize(R.styleable.StarScoreView_starSize, 20);
       this.mStarCount = mTypedArray.getInteger(R.styleable.StarScoreView_starCount, 5);
       this.mStarUnscoredDrawable = mTypedArray.getDrawable(R.styleable.StarScoreView_starUnscoredDrawable);
       this.mStarScoredDrawable = mTypedArray.getDrawable(R.styleable.StarScoreView_starScoredDrawable);
       this.isOnlyIntegerScore = mTypedArray.getBoolean(R.styleable.StarScoreView_starIsTouchEnable, true);
       this.isOnlyIntegerScore = mTypedArray.getBoolean(R.styleable.StarScoreView_starIsOnlyIntegerScore, false);
       mTypedArray.recycle();

paint = new Paint();
       paint.setAntiAlias(true);
       paint.setShader(new BitmapShader(drawableToBitmap(mStarScoredDrawable), BitmapShader.TileMode.CLAMP, BitmapShader.TileMode.CLAMP));
   }

自定义属性的定义xml文件：

<!--  评分星星控件  -->
   <declare-styleable name="StarScoreView">
       <!--星星间距-->
       <attr name="starDistance" format="dimension" />
       <!--星星大小-->
       <attr name="starSize" format="dimension" />
       <!--星星个数-->
       <attr name="starCount" format="integer" />
       <!--星星已评分图片-->
       <attr name="starScoredDrawable" format="reference" />
       <!--星星未评分图片-->
       <attr name="starUnscoredDrawable" format="reference" />
       <!--是否可以点击-->
       <attr name="starIsTouchEnable" format="boolean" />
       <!--是否显示整数-->
       <attr name="starIsOnlyIntegerScore" format="boolean" />
   </declare-styleable>

在OnTouch的时候就可以判断是否能触摸

@Override
   public boolean onTouchEvent(MotionEvent event) {
       if (isCanTouch) {

//x轴的宽度做一下最大最小的限制
           int x = (int) event.getX();
           if (x < 0) {
               x = 0;
           }
           if (x > mMeasuredWidth) {
               x = mMeasuredWidth;
           }

switch (event.getAction()) {
               case MotionEvent.ACTION_DOWN:
               case MotionEvent.ACTION_MOVE: {
                   setStarMark(x * 1.0f / (getMeasuredWidth() * 1.0f / mStarCount));
                   break;
               }
               case MotionEvent.ACTION_UP: {
                   break;
               }
           }

return super.onTouchEvent(event);

} else {
           //如果设置不能点击，直接不触发事件
           return false;
       }

}

而 setStarMark 则是设置入口的方法，内部判断是否支持小数点和设置对于的监听，并调用重绘。

public void setStarMark(float mark) {
       if (isOnlyIntegerScore) {
           mScoreNum = (int) Math.ceil(mark);
       } else {
           mScoreNum = Math.round(mark * 10) * 1.0f / 10;
       }
       if (this.onStarChangeListener != null) {
           this.onStarChangeListener.onStarChange(mScoreNum);  //调用监听接口
       }
       invalidate();
   }

一个简单的图片绘制和事件触摸的控件就完成啦，使用起来也是超级方便。

<com.guadou.kt_demo.demo.demo18_customview.star.StarScoreView
       android:id="@+id/star_view"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:layout_gravity="center_horizontal"
       android:layout_marginTop="@dimen/d_40dp"
       android:background="#f1f1f1"
       app:starCount="5"
       app:starDistance="@dimen/d_5dp"
       app:starIsOnlyIntegerScore="false"
       app:starIsTouchEnable="true"
       app:starScoredDrawable="@drawable/iv_normal_star_yellow"
       app:starSize="@dimen/d_35dp"
       app:starUnscoredDrawable="@drawable/iv_normal_star_gray" />

Activity中可以设置评分和设置监听：

override fun init() {

val starView = findViewById<StarScoreView>(R.id.star_view)

starView.setOnStarChangeListener {
           YYLogUtils.w("当前选中的Star:$it")
       }

findViewById<View>(R.id.set_progress).click {
           starView.setStarMark(3.5f)
       }
   }

效果：

后记

整个流程走下来是不是很简单呢，此控件不止用于星星类型的评分，任何图片资源都可以使用，现在我们思路打开扩展一下，相似的场景和效果我们可以实现一些图片进度，触摸进度条，圆环的SeekBar，等等类似的控制都是相似的思路。

来源：https://juejin.cn/post/7167256092051767326