Rate 评分

评分组件

基础用法

默认不区分颜色

区分颜色

辅助文字

只读

3.7

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

<template>
  <div class="rate">
    <div class="block">
      <span class="demonstration">默认不区分颜色</span>
      <jp-rate v-model="value1"></jp-rate>
    </div>
    <div class="block">
      <span class="demonstration">区分颜色</span>
      <jp-rate v-model="value2" :colors="colors"></jp-rate>
    </div>
    <div class="block">
      <span class="demonstration">辅助文字</span>
      <jp-rate v-model="value3" show-text></jp-rate>
    </div>
    <div class="block">
      <span class="demonstration">只读</span>
      <jp-rate v-model="value4" disabled show-score text-color="#ff9900" score-template="{value}"></jp-rate>
    </div>
  </div>
</template>

<script>
export default {
  data() {
    return {
      value1: null,
      value2: null,
      value3: null,
      value4: 3.7,
      colors: ['#99A9BF', '#F7BA2A', '#FF9900'] // 等同于 { 2: '#99A9BF', 4: { value: '#F7BA2A', excluded: true }, 5: '#FF9900' }
    }
  }
}
</script>
<style scoped lang="less">
.rate {
  display: flex;
}
.block {
  padding: 30px 24px;
  overflow: hidden;
}

.demonstration {
  font-size: 14px;
  color: #8492a6;
  line-height: 44px;
}
</style>

显示代码

其它 icon

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

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

<template>
  <div class="rate">
    <div class="block">
      <jp-rate
        v-model="value"
        :icon-classes="iconClasses"
        void-icon-class="jp-icon-circle-check"
        :colors="['#99A9BF', '#F7BA2A', '#FF9900']"
      ></jp-rate>
    </div>
  </div>
</template>

<script>
export default {
  data() {
    return {
      value: null,
      iconClasses: ['jp-icon-circle-check-filled', 'jp-icon-circle-check-filled', 'jp-icon-circle-check-filled']
    }
  }
}
</script>
<style scoped lang="less">
.rate {
  display: flex;
}
.block {
  padding: 30px 24px;
  overflow: hidden;
}
</style>

显示代码

Attributes

参数	说明	类型	可选值	默认值
value / v-model	绑定值	number	—	0
max	最大分值	number	—	5
disabled	是否为只读	boolean	—	false
allow-half	是否允许半选	boolean	—	false
low-threshold	低分和中等分数的界限值，值本身被划分在低分中	number	—	2
high-threshold	高分和中等分数的界限值，值本身被划分在高分中	number	—	4
colors	icon 的颜色。若传入数组，共有 3 个元素，为 3 个分段所对应的颜色；若传入对象，可自定义分段，键名为分段的界限值，键值为对应的颜色	array/object	—	['#F7BA2A', '#F7BA2A', '#F7BA2A']
void-color	未选中 icon 的颜色	string	—	#C6D1DE
disabled-void-color	只读时未选中 icon 的颜色	string	—	#EFF2F7
icon-classes	icon 的类名。若传入数组，共有 3 个元素，为 3 个分段所对应的类名；若传入对象，可自定义分段，键名为分段的界限值，键值为对应的类名	array/object	—	['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	分值改变时触发	改变后的分值