Rate 评分

用于评分。

基础用法

评分组件将评分分为几个等级,这些等级可以用不同的背景颜色来区分。 默认情况下,背景颜色是相同的,但你可以为其分配一个包含三个元素的数组,以使用 colors 属性来反映三个级别,它们的两个阈值可以通过 low-thresholdhigh-threshold 来定义,或者您可以为它们分配一个对象,该对象的键是两个级别之间的阈值,值是相应的颜色。

默认值
区分颜色

尺寸



支持半选

添加 allow-half 属性可以开启半星选择。

辅助文字

用辅助文字直接显示分数。

为组件设置 show-text 属性会在右侧显示辅助文字。 你可以通过 texts 属性为每一个分值指定对应的辅助文字。 texts 为一个数组,长度应等于最大值 max

可清空

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

更多种类的图标

您可以使用不同的图标来区分不同的评分组件。

您可以通过 icons 属性传入一个包含三个元素的数组或一个对象来自定义图标。 在这个例子中,我们还使用了 void-icon 来设置未选中时的图标。

只读

只读的评分用来展示分数,可以设置为半星。

使用 disabled 属性来设置组件为只读。添加 show-score 属性,它会显示在右侧。 此外,您还可以使用 score-template 属性来提供一个分数模板。 它必须包含 {value},并且 {value} 会被替换为相应的分数。

3.7 分

自定义样式

现在您可以为评分组件设置自定义样式了。 使用 css/scss 语言来改变全局或局部的颜色。 我们设置了一些全局颜色变量:--el-rate-void-color, --el-rate-fill-color, --el-rate-disabled-void-color, --el-rate-text-color。 你可以像这样使用: :root { --el-rate-void-color: red; --el-rate-fill-color: blue; }.

默认变量

变量默认颜色
--el-rate-void-colorvar(--el-border-color-darker)
--el-rate-fill-color#f7ba2a
--el-rate-disabled-void-colorvar(--el-fill-color)
--el-rate-text-colorvar(--el-text-color-primary)

API

属性

名称描述类型默认值
model-value / v-model绑定值number0
max最大分值number5
size评分组件的大小枚举
disabled是否为只读booleanfalse
allow-half是否允许半选booleanfalse
low-threshold低分和中等分数的界限值,值本身被划分在低分中number2
high-threshold中等和高等分数的界限值,值本身被划分在高分中number4
colors图标的颜色。 如果是数组,则需要有 3 个元素,每个元素表示一个等级的颜色;如果是对象,则键是两个等级之间的阈值,值是对应的颜色object['#f7ba2a', '#f7ba2a', '#f7ba2a']
void-color未选中图标的颜色string#c6d1de
disabled-void-color只读时未选中图标的颜色string#eff2f7
icons图标组件。 如果是数组,则需要有 3 个元素,每个元素表示一个等级的图标;如果是对象,则键是两个等级之间的阈值,值是对应的图标组件object[StarFilled, StarFilled, StarFilled]
void-icon未选中图标的组件string / Component
disabled-void-icon只读时未选中图标的组件string / ComponentStarFilled
show-text是否显示辅助文字booleanfalse
show-score是否显示当前分数。 show-score 和 show-text 不能同时为真booleanfalse
text-color辅助文字的颜色string''
texts辅助文字数组array['极差', '失望', '一般', '满意', '惊喜']
score-template分数模板string
clearable 2.2.18是否可以重置值为 0booleanfalse
id原生 id 属性string
aria-label a11y 2.7.2与 Rate 中的 aria-label 相同string
label a11y 已废弃与 Rate 中的 aria-label 相同string

事件

名称描述类型
change分值改变时触发Function

暴露

名称描述类型
setCurrentValue设置当前值Function
resetCurrentValue重置当前值Function

来源

组件样式文档

贡献者