Skip to content

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-modelnumber0评分绑定的值
read-onlybooleanfalse只读模式,无法交互
countnumber5总等级数
colorstring选中颜色(CSS 颜色字符串)
allow-halfbooleanfalse是否允许半选(0.5 步长)

事件

事件回调参数说明
change(value: number)分值改变时触发

插槽

插槽作用域说明
default替代默认星形 icon(接受字符串 / SVG / 单字符等)
infovalue评分右侧自定义描述区域,作用域为当前选中值

Released under the MIT License.