• Vant React

Rate 评分

介绍

用于对事物进行评级操作。

引入

import { Rate } from "@taroify/core"

代码演示

基础用法

通过 value 来绑定当前评分值。

<Rate value={3} />

自定义图标

通过 fullIcon 属性设置选中时的图标,voidIcon 属性设置未选中时的图标。

<Rate defaultValue={3} icon={<Like />} emptyIcon={<LikeOutlined />} />

自定义样式

通过 size 属性设置图标大小,css 设置选中时的颜色,emptyIcon 设置未选中时的颜色。

 <Rate className="custom-color" defaultValue={3} allowHalf size={25} emptyIcon={<Star />} />
.custom-color {
  --rate-icon-empty-color: #eee;
  --rate-icon-full-color: #ffd21e;
}

半星

设置 allowHalf 属性后可以选中半星。

<Rate defaultValue={3} allowHalf />

自定义数量

通过 count 属性设置评分总数。

<Rate defaultValue={3} count={6} />

禁用状态

通过 disabled 属性来禁用评分。

<Rate defaultValue={3} disabled />

只读状态

通过 readonly 属性将评分设置为只读状态。

<Rate defaultValue={3} readonly />

只读状态显示小数

设置 readonlyallowHalf 属性后,Rate 组件可以展示任意小数结果。

<Rate defaultValue={3.3} readonly allowHalf />

API

Props

参数说明类型默认值
defaultValue默认当前分值number-
value当前分值number-
count图标总数number | string5
size图标大小,默认单位为pxnumber | string20px
gutter图标间距,默认单位为pxnumber | string4px
icon选中时的图标string<Star />
emptyIcon未选中时的图标string<StarOutlined />
allowHalf是否允许半选booleanfalse
readonly是否为只读状态,只读状态下无法修改评分booleanfalse
disabled是否禁用评分booleanfalse
touchable是否可以通过滑动手势选择评分booleantrue

Events

事件名说明回调参数
onChange当前分值变化时触发的事件value :number

主题定制

样式变量

组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 组件。

名称默认值描述
rate-icon-size20px * $hd-
rate-icon-guttervar(—padding-base)-
rate-icon-empty-colorvar(—gray-5)-
rate-icon-full-colorvar(—danger-color)-
rate-icon-disabled-colorvar(—gray-5)-