Skip to content

Rate 评分

用于评分

基本用法

评分默认被分为三个等级,可以利用颜色数组对分数及情感倾向进行分级(默认情况下不区分颜色)。 三个等级所对应的颜色用 colors 属性设置,而它们对应的两个阈值则通过 low-thresholdhigh-threshold 设定。

尺寸

通过设置 size 属性,来展示不同大小。可选值:largedefaultsmall。 默认 default

半选

属性 allow-half 允许出现半星

辅助文字

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

可清空

当你再次点击相同的值时,可以将值重置为 0

自定义图标

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

只读

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

API

Attributes

参数说明类型默认值
model-value / v-model绑定值number0
max最大分值number5
size尺寸'large' | 'default' | 'small'
disabled是否禁用booleanfalse
allow-half是否半选booleanfalse
low-threshold低分和中等分数的界限值, 值本身被划分在低分中number2
high-threshold高分和中等分数的界限值, 值本身被划分在高分中number4
colorsicon 的颜色。 若传入数组,共有 3 个元素,为 3 个分段所对应的颜色;若传入对象,可自定义分段,键名为分段的界限值,键值为对应的颜色string[] | Record<number, string>['#F7BA2A', '#F7BA2A', '#F7BA2A']
void-color未选中 icon 的颜色string#C6D1DE
disabled-void-color只读时未选中 icon 的颜色string#EFF2F7
icons图标组件 若传入数组,则需要传入 3 个元素,分别为 3 个部分所对应的类名;若传入对象,则可自定义分段,键名为分段的界限值,键值为对应的类名string[] | Component[] | Record<number, string | Component>[StarFilled, StarFilled, StarFilled]
void-icon未被选中的图标组件IconSlotTypeStar
disabled-void-icon禁用状态的未选择图标IconSlotTypeStarFilled
show-text是否显示辅助文字,若为真,则会从 texts 数组中选取当前分数对应的文字内容booleanfalse
show-score是否显示当前分数, show-score 和 show-text 不能同时为真booleanfalse
text-color辅助文字的颜色string''
texts辅助文字数组string[]['Extremely bad', 'Disappointed', 'Fair', 'Satisfied', 'Surprise']
score-template分数显示模板string
clearable是否可以重置值为 0booleanfalse
id原生属性 idstring
label原生属性 aria-labelstring

Events

事件名称说明类型
change分值改变时触发(value: number) => void

Exposes

名称说明类型
setCurrentValue设置当前值(value: number) => void
resetCurrentValue重置当前值() => void