Rate 評分

評分組件

基礎用法

評分被分為三個等級，可以利用顏色對分數及情感傾向進行分級（默認情況下不區分顏色）。三個等級所對應的顏色用過colors屬性設置，而它們對應的兩個閾值則通過 low-threshold 和 high-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	分值改變時觸發	改變后的分值