ElementPlus Rate 評分

2021-09-24 21:06 更新

評分組件

基礎(chǔ)用法


默認(rèn)不區(qū)分顏色

區(qū)分顏色

評分默認(rèn)被分為三個等級,可以利用顏色數(shù)組對分?jǐn)?shù)及情感傾向進行分級(默認(rèn)情況下不區(qū)分顏色)。三個等級所對應(yīng)的顏色用colors屬性設(shè)置,而它們對應(yīng)的兩個閾值則通過 low-threshold 和 high-threshold 設(shè)定。你也可以通過傳入顏色對象來自定義分段,鍵名為分段的界限值,鍵值為對應(yīng)的顏色。

<template>
  <div class="block">
  <span class="demonstration">默認(rèn)不區(qū)分顏色</span>
  <el-rate v-model="value1"></el-rate>
</div>
<div class="block">
  <span class="demonstration">區(qū)分顏色</span>
  <el-rate v-model="value2" :colors="colors"> </el-rate>
</div>
</template>

<script>
  export default {
    data() {
      return {
        value1: null,
        value2: null,
        colors: ['#99A9BF', '#F7BA2A', '#FF9900'], // 等同于 { 2: '#99A9BF', 4: { value: '#F7BA2A', excluded: true }, 5: '#FF9900' }
      }
    },
  }
</script>

允許半選


屬性 allow-half 允許出現(xiàn)半星

<template>
  <div class="block">
  <el-rate v-model="value" allow-half />
</div>
</template>

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

輔助文字


用輔助文字直接地表達(dá)對應(yīng)分?jǐn)?shù)

為組件設(shè)置 show-text 屬性會在右側(cè)顯示輔助文字。通過設(shè)置 texts 可以為每一個分值指定對應(yīng)的輔助文字。texts 為一個數(shù)組,長度應(yīng)等于最大值 max。

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

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

其它 icon


當(dāng)有多層評價時,可以用不同類型的 icon 區(qū)分評分層級

設(shè)置icon-classes屬性可以自定義不同分段的圖標(biāo)。若傳入數(shù)組,共有 3 個元素,為 3 個分段所對應(yīng)的類名;若傳入對象,可自定義分段,鍵名為分段的界限值,鍵值為對應(yīng)的類名。本例還使用void-icon-class指定了未選中時的圖標(biāo)類名。

<template>
  <el-rate
  v-model="value"
  :icon-classes="iconClasses"
  void-icon-class="icon-rate-face-off"
  :colors="['#99A9BF', '#F7BA2A', '#FF9900']"
>
</el-rate>
</template>

<script>
  export default {
    data() {
      return {
        value: null,
        iconClasses: [
          'icon-rate-face-1',
          'icon-rate-face-2',
          'icon-rate-face-3',
        ], // 等同于 { 2: 'icon-rate-face-1', 4: { value: 'icon-rate-face-2', excluded: true }, 5: 'icon-rate-face-3' }
      }
    },
  }
</script>

只讀


只讀的評分用來展示分?jǐn)?shù),允許出現(xiàn)半星

 為組件設(shè)置 disabled 屬性表示組件為只讀,支持小數(shù)分值。此時若設(shè)置 show-score,則會在右側(cè)顯示目前的分值??梢蕴峁?nbsp;score-template 作為顯示模板,模板為一個包含了 {value} 的字符串,{value} 會被解析為分值。

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

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

Attributes

參數(shù)說明類型可選值默認(rèn)值
model-value / v-model綁定值number0
max最大分值number5
disabled是否為只讀booleanfalse
allow-half是否允許半選booleanfalse
low-threshold低分和中等分?jǐn)?shù)的界限值,值本身被劃分在低分中number2
high-threshold高分和中等分?jǐn)?shù)的界限值,值本身被劃分在高分中number4
colorsicon 的顏色。若傳入數(shù)組,共有 3 個元素,為 3 個分段所對應(yīng)的顏色;若傳入對象,可自定義分段,鍵名為分段的界限值,鍵值為對應(yīng)的顏色array/object['#F7BA2A', '#F7BA2A', '#F7BA2A']
void-color未選中 icon 的顏色string#C6D1DE
disabled-void-color只讀時未選中 icon 的顏色string#EFF2F7
icon-classesicon 的類名。若傳入數(shù)組,共有 3 個元素,為 3 個分段所對應(yīng)的類名;若傳入對象,可自定義分段,鍵名為分段的界限值,鍵值為對應(yīng)的類名array/object['el-icon-star-on', 'el-icon-star-on','el-icon-star-on']
void-icon-class未選中 icon 的類名stringel-icon-star-off
disabled-void-icon-class只讀時未選中 icon 的類名stringel-icon-star-on
show-text是否顯示輔助文字,若為真,則會從 texts 數(shù)組中選取當(dāng)前分?jǐn)?shù)對應(yīng)的文字內(nèi)容booleanfalse
show-score是否顯示當(dāng)前分?jǐn)?shù),show-score 和 show-text 不能同時為真booleanfalse
text-color輔助文字的顏色string#1F2D3D
texts輔助文字?jǐn)?shù)組array['極差', '失望', '一般', '滿意', '驚喜']
score-template分?jǐn)?shù)顯示模板string{value}

?Events

事件名稱說明回調(diào)參數(shù)
change分值改變時觸發(fā)改變后的分值


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號