評分條 RatingBar

本節將繼續學習一個和進度有關的控件：RatingBar ，在 Android 中 RatingBar 是一個可以支持用戶打分的 UI 控件，相比 ProgressBar 而言，RatingBar 不僅僅可以用來展示同時還可以接收用戶的輸入操作；而相比 SeekBar，RatingBar 則更側重于與用戶的互動性。有了前兩節的基礎，這一節理解起來也是非常容易的。

1. RatingBar 的特性

從繼承關系來看，RatingBar 是派生自 SeekBar 的，所以它擁有 SeekBar 的所有屬性和功能（當然也包括 ProgressBar 的功能）?？梢岳斫鉃?SeekBar 是進度的另一種表現形式，它將進度換成了分數，用戶拖動進度條來進行評分操作，我們先來感受一下 RatingBar 的樣式：

有圖有真相，我們會在各大 App 市場、電影票 App、團購 App 等場景中大量的看到 RatingBar 的影子。

用戶通過點擊不同的星級進行打分，通過 RatingBar 我們可以拿到一個浮點類型的數字，比如：1.0、2.3、5.5 等等，就類似于我們給電影評分，接下來我們看看如何使用。

2 RatingBar 的基本用法

2.1 RatingBar 的屬性

RatingBar 的屬性都很好理解，以下是幾個常用的屬性：

• android:rating：
  設置默認評分值，接收一個浮點數。
• android:numStars：
  總共有多少顆星級，接收一個整形數。
• android:isIndicator：
  設置當前 RatingBar 是否只是分數展示，即用戶無法更改分值，接收一個 boolean 值。
• android:stepSize：
  評分增加的步進值，接收一個浮點數。
• style：
  自定義樣式。和 ProgressBar、SeekBar 一樣，我們可以自定義 RatingBar 的展示樣式，系統為我們提供了兩種常用的樣式可供選擇：

  style="?android:attr/ratingBarStyleSmall"
  style="?android:attr/ratingBarStyleIndicator"
  

2.2 RatingBar 事件監聽及 API

RatingBar 需要接收用戶的輸入，所以需要一個事件監聽器：

RatingBar.OnRatingBarChangeListener

接口中只定義了一個函數:

void onRatingChanged(RatingBar ratingBar, float rating, boolean fromUser);

參數說明：

• ratingBar： 分值被修改的 RatingBar 實例
• rating： 修改之后的分值，一個浮點型
• fromUser： 是否是由用戶主動修改

另外我們在代碼中可以動態去修改 Rating 值以及總的星級數，通過如下接口：

setRating(float rating)          // 動態設置當前分值
setNumStars(final int numStars)  // 動態設置總分數

通過以下接口獲取當前的分值及總分數：

getNumStars()
getRating()

2.3 RatingBar 的使用示例

接下來我們實現一個完整的 RatingBar 工程，通過打分回調接口及獲取分數的 API 完成以下兩大功能：

• 在點擊 RatingBar 進行打分之后通過 Toast 展示當前分數
• 點擊 Button 的獲取當前分數，并展示到 TextView 之上
  首先我們編寫布局文件：

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <RatingBar
        android:id="@+id/ratingBar"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginLeft="80dp"
        android:layout_marginTop="200dp"
        android:numStars="5"
        android:rating="2.6"
        android:stepSize="0.1" />

    <Button
        android:id="@+id/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_below="@+id/ratingBar"
        android:layout_alignLeft="@+id/ratingBar"
        android:layout_marginLeft="60dp"
        android:layout_marginTop="30dp"
        android:text="獲取評分" />

    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_below="@+id/button"
        android:layout_alignLeft="@+id/button"
        android:layout_marginTop="20dp"
        android:textSize="20dp"
        android:textStyle="bold" />
</RelativeLayout>

布局文件中我們放置了 3 個控件：RatingBar 用來展示星級、Button 用來展示觸發分數獲取、TextView用來展示具體的分數值，接下來編寫 Java 代碼完成邏輯控制：

package com.emercy.myapplication;

import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.RatingBar;
import android.widget.TextView;
import android.widget.Toast;

import androidx.appcompat.app.AppCompatActivity;

public class MainActivity extends AppCompatActivity {
    private RatingBar mRatingBar;
    private TextView mTextView;
    private Button mButton;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        mRatingBar = findViewById(R.id.ratingBar);
        mTextView = findViewById(R.id.textView);
        mButton = findViewById(R.id.button);
        mButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                int numStars = mRatingBar.getNumStars();
                float rating = mRatingBar.getRating();
                mTextView.setText("得分: " + rating + "/" + numStars);
            }
        });

        mRatingBar.setOnRatingBarChangeListener(new RatingBar.OnRatingBarChangeListener() {
            @Override
            public void onRatingChanged(RatingBar ratingBar, float rating, boolean fromUser) {
                Toast.makeText(MainActivity.this, "當前分數變動為：" + rating, Toast.LENGTH_SHORT).show();
            }
        });
    }
}

首先給 Button 設置一個點擊事件監聽器，在其中通過getNumStars()和getRating()獲取總的星數和當前星數，并通過 TextView 展示。接著給 RatingBar 。

設置一個評分變動監聽器，在評分修改的時候通過 Toast 打印出最新的評分，效果如下：

3. 小結

本節是繼續前兩節—— ProgressBar 、 SeekBar 的又一升級版，它延續了進度條及拖動條的特點，而將場景轉移到了評分系統當中，使用起來和 ProgressBar、SeekBar 類似，也非常好理解，在具體場景的時候能夠靈活運用就行。