跳到主要内容

Rate 评分 ​

uni-appH5微信小程序App

跨端星级评分组件,支持禁用和只读状态。

何时使用 ​

需要用户对内容打分的场景:商品评价、满意度反馈。

何时不使用 ​

仅需展示平均分时可用只读模式;精确数值输入用 Slider。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
Rate 评分 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
modelValuenumber0当前分值(v-model),allowHalf 时可为 0.5 步进
maxnumber5星星总数
disabledbooleanfalse禁用,不可交互且置灰
readonlybooleanfalse只读,不可交互但保留配色
sizenumber24星星尺寸(px)
allowHalfbooleanfalse允许半星(点击左右半区 / 键盘 0.5 步进)

Events ​

名称载荷说明
update:modelValuenumber分值变化时触发(v-model)
changenumber分值变化时触发,与 update:modelValue 同步

示例 ​

基础用法 ​

vue
<Rate v-model="score" />

只读与禁用 ​

vue
<view class="row">
  <Rate :model-value="4" readonly />
  <Rate :model-value="2" disabled />
</view>

自定义数量 ​

vue
<Rate v-model="score" :max="7" :size="20" />

半星评分 ​

vue
<Rate v-model="score" allow-half />