文档中心

rating

Phone12+PC/2in113+Tablet12+TV19+Wearable18+

更新时间: 2026-08-29 09:41

复制页面

说明

从API version 4开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

评分条，表示用户使用感受的衡量标准条。

权限列表

无

子组件

不支持。

属性

除支持通用属性外，还支持如下属性：

展开

名称	类型	默认值	必填	描述
numstars	number	5	否	设置评分条的星级总数。
rating	number	0	否	设置评分条当前评星数。
stepsize	number	0.5	否	设置评分条的评星步长。
indicator	boolean	false	否	设置评分条是否为指示器。 true：作为指示器，用户不可操作。 false：非指示器，用户可操作。

样式

除支持通用样式外，还支持如下样式：

展开

名称	类型	默认值	必填	描述
star-background	string	-	否	设置单个星级未选中的背景图片，只支持本地路径图片，图片格式为png和jpg。
star-foreground	string	-	否	设置单个星级选中的前景图片，只支持本地路径图片，图片格式为png和jpg。
star-secondary	string	-	否	设置单个星级部分选中的次级背景图片，该图片会覆盖背景图片，只支持本地路径图片，图片格式为png和jpg。
width	<length>\|<percentage>	120px 60px（不可操作）	否	默认值是在未设置自定义资源和评分星数时，使用5个星和默认资源下的宽度值。
height	<length>\|<percentage>	24px 12px（不可操作）	否	默认值是在未设置自定义资源和评分星数时，使用5个星和默认资源下的高度值。
rtl-flip	boolean	true	否	在rtl文字方向下是否自动翻转图源。 true：在rtl文字方向下自动翻转图源。 false：在rtl文字方向下不自动翻转图源。

说明

star-background，star-secondary，star-foreground三个星级图源必须全部设置，否则默认的星级颜色为灰色，以此提示图源设置错误。

事件

除支持通用事件外，还支持如下事件：

展开

名称	参数	描述
change	{ rating: number }	评分条的评星发生改变时触发该回调。

方法

支持通用方法。

示例

<!-- xxx.hml -->
<div class="container">
  <rating numstars="5" rating="5" @change="changeRating" id="rating">
  </rating>
</div>

/* xxx.css */
.container {
  display: flex;
  justify-content: center;
  align-items: center;
}
.rating {
  width: 200px;
}

// xxx.js
import promptAction from '@ohos.promptAction';
export default {
    changeRating(e){
        promptAction.showToast({
            message: e.rating
        });
    }
}