Skip to content

Rate 评分

评分组件

基础用法

辅助文字

用辅助文字直接地表达对应分数。

其他 Icon

当有多层评价时,可以用不同类型的 Icon 区分评分层级。

允许半选

评分组件支持半选模式,通过设置 allow-half 属性开启。

只读

只读的评分用来展示分数,允许出现半星。

✨ 心情模式 (Unique)

开启 mood 属性,评分图标将根据分数自动变化为心情图标(难过 -> 开心)。

🅰️ 字符模式 (Unique)

使用 character 属性,可以将图标替换为任意字符(如字母、汉字、数字等),适用于特殊的评分场景(如等级评定)。

🏃 动态效果 (Unique)

开启 animate 属性,鼠标悬停或选中时会有跳动动画,增加交互趣味性。

API

Rate 属性

属性名说明类型默认值
model-value / v-model绑定值number0
max最大分值number5
disabled是否为只读booleanfalse
allow-half是否允许半选booleanfalse
low-threshold低分和中等分数的界限值,值本身被划分在低分中number2
high-threshold高分和中等分数的界限值,值本身被划分在高分中number4
colorsicon 的颜色。若传入数组,共有 3 个元素,为 3 个分段所对应的颜色;若传入对象,可自定义分段,键名为分段的界限值,键值为对应的颜色string[] / object['#F7BA2A', '#F7BA2A', '#F7BA2A']
void-color未选中 icon 的颜色string#C6D1DE
disabled-void-color只读时未选中 icon 的颜色string#EFF2F7
iconsicon 的组件。若传入数组,共有 3 个元素,为 3 个分段所对应的 icon;若传入对象,可自定义分段,键名为分段的界限值,键值为对应的 iconstring[] / Component[] / object[Star, Star, Star]
void-icon未选中 icon 的组件string / ComponentStar
disabled-void-icon只读时未选中 icon 的组件string / ComponentStar
show-text是否显示辅助文字,若为真,则会从 texts 数组中选取当前分数对应的文字内容booleanfalse
show-score是否显示当前分数,show-score 和 show-text 不能同时为真booleanfalse
text-color辅助文字的颜色string#1f2d3d
texts辅助文字数组string[]['极差', '失望', '一般', '满意', '惊喜']
score-template分数显示模板string{value}
size图标大小,支持 CSS 单位number / string
clearable是否允许再次点击后清除booleanfalse
mood是否开启心情模式booleanfalse
character自定义字符模式string
animate是否开启交互动画booleanfalse

Rate 事件

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