Rate 评分

优质
小牛编辑
141浏览
2023-12-01

Rate 评分

评分组件

基本用法

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

render() {
  return (
    <div className="intro-block">
      <div className="block">
        <span className="demonstration">默认不区分颜色</span>
        <span className="wrapper">
          <Rate onChange={(val) => alert(val)} />
        </span>
      </div>
      <div className="block">
        <span className="demonstration">区分颜色</span>
        <span className="wrapper">
          <Rate colors={['#99A9BF', '#F7BA2A', '#FF9900']} />
        </span>
      </div>
    </div>
  )
}

:::

允许半选

可支持鼠标选择半星

::: demo 为组件设置 allowHalf 属性点击图标左侧可选择半星。

render() {
  return <Rate allowHalf={true} onChange={(val) => console.log(val)} />
}

:::

辅助文字

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

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

render() {
  return <Rate showText={true} />
}

:::

只读

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

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

render() {
  return <Rate disabled={true} value={3.9} showText={true} />
}

:::

Attributes

参数说明类型可选值默认值
max最大分值number5
disabled是否为只读booleanfalse
allowHalf是否允许半选booleanfalse
lowThreshold低分和中等分数的界限值,值本身
被划分在低分中
number2
highThreshold高分和中等分数的界限值,值本身
被划分在高分中
number4
colorsicon 的颜色数组,共有 3 个元素,
为 3 个分段所对应的颜色
array['#F7BA2A', '#F7BA2A', '#F7BA2A']
voidColor未选中 icon 的颜色string#C6D1DE
disabledVoidColor只读时未选中 icon 的颜色string#EFF2F7
iconClassesicon 的类名数组,共有 3 个元素,
为 3 个分段所对应的类名
array['el-icon-star-on', 'el-icon-star-on',
'el-icon-star-on']
voidIconClass未选中 icon 的类名stringel-icon-star-off
disabledVoidIconClass只读时未选中 icon 的类名stringel-icon-star-on
showText是否显示辅助文字booleanfalse
textColor辅助文字的颜色string1F2D3D
texts辅助文字数组array['极差', '失望', '一般', '满意', '惊喜']
textTemplate只读时的辅助文字模板string{value}

Events

事件名称说明回调参数
onChange分值改变时触发改变后的分值