Rate 评分

用于评分

基础用法

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

<template>
  <div class="demo-rate-block">
    <span class="demonstration">Default</span>
    <el-rate v-model="value1" />
  </div>
  <div class="demo-rate-block">
    <span class="demonstration">Color for different levels</span>
    <el-rate v-model="value2" :colors="colors" />
  </div>
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const value1 = ref(null)
const value2 = ref(null)
const colors = ref(['#99A9BF', '#F7BA2A', '#FF9900']) // same as { 2: '#99A9BF', 4: { value: '#F7BA2A', excluded: true }, 5: '#FF9900' }
</script>
<style scoped>
.demo-rate-block {
  padding: 30px 0;
  text-align: center;
  border-right: solid 1px var(--el-border-color);
  display: inline-block;
  width: 49%;
  box-sizing: border-box;
}
.demo-rate-block:last-child {
  border-right: none;
}
.demo-rate-block .demonstration {
  display: block;
  color: var(--el-text-color-secondary);
  font-size: 14px;
  margin-bottom: 20px;
}
</style>

尺寸

<template>
  <el-rate v-model="value" size="large" />
  <br />
  <el-rate v-model="value" />
  <br />
  <el-rate v-model="value" size="small" />
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const value = ref(null)
</script>

允许半选

属性 allow-half 允许出现半星

<template>
  <el-rate v-model="value" allow-half />
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const value = ref()
</script>

辅助文字

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

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

<template>
  <el-rate
    v-model="value"
    :texts="['oops', 'disappointed', 'normal', 'good', 'great']"
    show-text
  />
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const value = ref()
</script>

其它 icon

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

设置icon-classes属性可以自定义不同分段的图标。 若传入数组，共有 3 个元素，为 3 个分段所对应的类名；若传入对象，可自定义分段，键名为分段的界限值，键值为对应的类名。 本例还使用 void-icon-class 指定了未选中时的图标类名。

<template>
  <el-rate
    v-model="value"
    :icons="icons"
    :void-icon="ChatRound"
    :colors="['#409eff', '#67c23a', '#FF9900']"
  />
</template>
<script lang="ts" setup>
import { ref } from 'vue'
import { ChatDotRound, ChatLineRound, ChatRound } from '@element-plus/icons-vue'
const value = ref()
const icons = [ChatRound, ChatLineRound, ChatDotRound] // same as { 2: ChatRound, 4: { value: ChatLineRound, excluded: true }, 5: ChatDotRound }
</script>

只读

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

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

<template>
  <el-rate
    v-model="value"
    disabled
    show-score
    text-color="#ff9900"
    score-template="{value} points"
  />
</template>
<script lang="ts" setup>
import { ref } from 'vue'
const value = ref(3.7)
</script>

自定义样式

您可以为rate组件设置自定义样式。 使用 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; }.

默认变量

Rate 属性

Rate 事件

源代码

组件 • 文档

贡献者

三咲智子

云游君

jeremywu

Chen

btea

LIUCHAO

류한경

opengraphica

Shana-AE

MoConWu

kooriookami

SongWuKong

Aex

Alan Wang

tryag

Xc

Hades-li