Rate 评分
uni-appH5微信小程序App
跨端星级评分组件,支持禁用和只读状态。
何时使用
需要用户对内容打分的场景:商品评价、满意度反馈。
何时不使用
仅需展示平均分时可用只读模式;精确数值输入用 Slider。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | number | 0 | 当前分值(v-model),allowHalf 时可为 0.5 步进 |
max | number | 5 | 星星总数 |
disabled | boolean | false | 禁用,不可交互且置灰 |
readonly | boolean | false | 只读,不可交互但保留配色 |
size | number | 24 | 星星尺寸(px) |
allowHalf | boolean | false | 允许半星(点击左右半区 / 键盘 0.5 步进) |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | number | 分值变化时触发(v-model) |
change | number | 分值变化时触发,与 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 />