非常教程

Element UI参考手册

组件

Rate 评分

Rate 评分

评分组件

基础用法

  • 默认不区分颜色
  • 区分颜色

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

<div class="block">
  <span class="demonstration">默认不区分颜色</span>
  <el-rate v-model="value1"></el-rate>
</div>
<div class="block">
  <span class="demonstration">区分颜色</span>
  <el-rate
    v-model="value2"
    :colors="['#99A9BF', '#F7BA2A', '#FF9900']">
  </el-rate>
</div>

<script>
  export default {
    data() {
      return {
        value1: null,
        value2: null
      }
    }
  }
</script>

辅助文字

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

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

<el-rate
  v-model="value3"
  show-text>
</el-rate>

<script>
  export default {
    data() {
      return {
        value3: null
      }
    }
  }
</script>

其它 icon

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

设置icon-classes属性可以自定义对应 3 个不同分段的图标。本例还使用void-icon-class指定了未选中时的图标类名。

<el-rate
  v-model="value4"
  :icon-classes="['icon-rate-face-1', 'icon-rate-face-2', 'icon-rate-face-3']"
  void-icon-class="icon-rate-face-off"
  :colors="['#99A9BF', '#F7BA2A', '#FF9900']">
</el-rate>

<script>
  export default {
    data() {
      return {
        value4: null
      }
    }
  }
</script>

只读

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

为组件设置 disabled 属性表示组件为只读,支持小数分值。此时若设置 show-score,则会在右侧显示目前的分值。可以提供 score-template 作为显示模板,模板为一个包含了 {value} 的字符串,{value} 会被解析为分值。

<el-rate
  v-model="value5"
  disabled
  show-score
  text-color="#ff9900"
  score-template="{value}">
</el-rate>

<script>
  export default {
    data() {
      return {
        value5: 3.7
      }
    }
  }
</script>

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

是否显示辅助文字,若为真,则会从 texts 数组中选取当前分数对应的文字内容

boolean

false

show-score

是否显示当前分数,show-score 和 show-text 不能同时为真

boolean

false

text-color

辅助文字的颜色

string

#1F2D3D

texts

辅助文字数组

array

['极差', '失望', '一般', '满意', '惊喜']

score-template

分数显示模板

string

{value}

Events

事件名称

说明

回调参数

change

分值改变时触发

改变后的分值