## Rate 评分 评分组件 ### 基础用法 :::demo 评分被分为三个等级,可以利用颜色对分数及情感倾向进行分级(默认情况下不区分颜色)。三个等级所对应的颜色用过`colors`属性设置,而它们对应的两个阈值则通过 `low-threshold` 和 `high-threshold` 设定。 ``` html
默认不区分颜色
区分颜色
``` ::: ### 辅助文字 用辅助文字直接地表达对应分数 :::demo 为组件设置 `show-text` 属性会在右侧显示辅助文字。通过设置 `texts` 可以为每一个分值指定对应的辅助文字。`texts` 为一个数组,长度应等于最大值 `max`。 ``` html ``` ::: ### 其它 icon 当有多层评价时,可以用不同类型的 icon 区分评分层级 :::demo 设置`icon-classes`属性可以自定义对应 3 个不同分段的图标。本例还使用`void-icon-class`指定了未选中时的图标类名。 ``` html ``` ::: ### 只读 只读的评分用来展示分数,允许出现半星 :::demo 为组件设置 `disabled` 属性表示组件为只读,支持小数分值。此时若设置 `show-text`,则会在右侧显示目前的分值。可以提供 `text-template` 作为显示模板,模板为一个包含了 `{value}` 的字符串,`{value}` 会被解析为分值。 ``` html ``` ::: ### Attributes | 参数 | 说明 | 类型 | 可选值 | 默认值 | |---------- |-------- |---------- |------------- |-------- | | max | 最大分值 | number | — | 5 | | disabled | 是否为只读 | boolean | — | false | | allow-half | 是否允许半选 | boolean | — | false | | low-threshold | 低分和中等分数的界限值,值本身
被划分在低分中 | number | — | 2 | | high-threshold | 高分和中等分数的界限值,值本身
被划分在高分中 | number | — | 4 | | colors | icon 的颜色数组,共有 3 个元素,
为 3 个分段所对应的颜色 | array | — | ['#F7BA2A', '#F7BA2A', '#F7BA2A'] | | void-color | 未选中 icon 的颜色 | string | — | #C6D1DE | | disabled-void-color | 只读时未选中 icon 的颜色 | string | — | #EFF2F7 | | icon-classes | icon 的类名数组,共有 3 个元素,
为 3 个分段所对应的类名 | array | — | ['el-icon-star-on', 'el-icon-star-on',
'el-icon-star-on'] | | void-icon-class | 未选中 icon 的类名 | string | — | el-icon-star-off | | disabled-void-icon-class | 只读时未选中 icon 的类名 | string | — | el-icon-star-on | | show-text | 是否显示辅助文字 | boolean | — | false | | text-color | 辅助文字的颜色 | string | — | 1F2D3D | | texts | 辅助文字数组 | array | — | ['极差', '失望', '一般', '满意', '惊喜'] | | text-template | 只读时的辅助文字模板 | string | — | {value} | ### Events | 事件名称 | 说明 | 回调参数 | |---------- |-------- |---------- | | change | 分值改变时触发 | 改变后的分值 |