Rate 评分
用于评分。
基础用法
评分组件将评分分为几个等级,这些等级可以用不同的背景颜色来区分。 默认情况下,背景颜色是相同的,但你可以为其分配一个包含三个元素的数组,以使用 colors
属性来反映三个级别,它们的两个阈值可以通过 low-threshold
和 high-threshold
来定义,或者您可以为它们分配一个对象,该对象的键是两个级别之间的阈值,值是相应的颜色。
尺寸
支持半选
添加 allow-half
属性可以开启半星选择。
辅助文字
用辅助文字直接显示分数。
为组件设置 show-text
属性会在右侧显示辅助文字。 你可以通过 texts
属性为每一个分值指定对应的辅助文字。 texts
为一个数组,长度应等于最大值 max
。
可清空
当您再次点击相同的值时,您可以将该值重置为 0
。
更多种类的图标
您可以使用不同的图标来区分不同的评分组件。
您可以通过 icons
属性传入一个包含三个元素的数组或一个对象来自定义图标。 在这个例子中,我们还使用了 void-icon
来设置未选中时的图标。
只读
只读的评分用来展示分数,可以设置为半星。
使用 disabled
属性来设置组件为只读。添加 show-score
属性,它会显示在右侧。 此外,您还可以使用 score-template
属性来提供一个分数模板。 它必须包含 {value}
,并且 {value}
会被替换为相应的分数。
自定义样式
现在您可以为评分组件设置自定义样式了。 使用 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-color | var(--el-border-color-darker) |
--el-rate-fill-color | #f7ba2a |
--el-rate-disabled-void-color | var(--el-fill-color) |
--el-rate-text-color | var(--el-text-color-primary) |
API
属性
名称 | 描述 | 类型 | 默认值 |
---|---|---|---|
model-value / v-model | 绑定值 | number | 0 |
max | 最大分值 | number | 5 |
size | 评分组件的大小 | 枚举 | — |
disabled | 是否为只读 | boolean | false |
allow-half | 是否允许半选 | boolean | false |
low-threshold | 低分和中等分数的界限值,值本身被划分在低分中 | number | 2 |
high-threshold | 中等和高等分数的界限值,值本身被划分在高分中 | number | 4 |
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 / Component | StarFilled |
show-text | 是否显示辅助文字 | boolean | false |
show-score | 是否显示当前分数。 show-score 和 show-text 不能同时为真 | boolean | false |
text-color | 辅助文字的颜色 | string | '' |
texts | 辅助文字数组 | array | ['极差', '失望', '一般', '满意', '惊喜'] |
score-template | 分数模板 | string | |
clearable 2.2.18 | 是否可以重置值为 0 | boolean | false |
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 |