Rate 评分
等级评估。
何时使用
- 收集用户对某个对象的「满意度 / 喜爱度」反馈。
- 展示外部聚合评分(只读模式)。
基本使用
v-model 双向绑定数值(0 ~ count);默认 5 颗星。
只读模式
read-only 用于「展示」场景,无法交互。常见于商品列表、评论汇总。
半选
allow-half 允许半颗星选中(0.5 步长),常用于精确评分。
自定义星数
count 改变总等级数,常见于「10 分制」打分。
自定义颜色
color 字符串接 CSS 颜色值;可用主题预设关键字(blue / red / orange)或自定义十六进制。
自定义图标
default slot 接一个字符或 SVG 元素替换星星。常见用于「心形」「点赞」「字母评分」。
评分描述(info slot)
info slot 接收作用域 info(当前选中值),可显示「差 / 一般 / 好 / 很好 / 极好」文案。
change 事件
@change 在评分改变时触发,回调参数为新值;用于联动日志、表单校验等。
清零按钮
配合外部按钮把绑定值重置为 0;典型「重新评分」交互。
在表单中使用
评分通常作为表单字段;与 <c-form> 协议无差异。
只读 + 聚合分数(商品页常见)
多条评分汇总展示,配合主图标说明评分含义。
API
Props
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| v-model | number | 0 | 评分绑定的值 |
| read-only | boolean | false | 只读模式,无法交互 |
| count | number | 5 | 总等级数 |
| color | string | — | 选中颜色(CSS 颜色字符串) |
| allow-half | boolean | false | 是否允许半选(0.5 步长) |
事件
| 事件 | 回调参数 | 说明 |
|---|---|---|
| change | (value: number) | 分值改变时触发 |
插槽
| 插槽 | 作用域 | 说明 |
|---|---|---|
| default | — | 替代默认星形 icon(接受字符串 / SVG / 单字符等) |
| info | value | 评分右侧自定义描述区域,作用域为当前选中值 |