Rating 评分
如果项目中使用的是 1.x 版本的基础组件(@alifd/next),请在左侧导航顶部切换组件版本。
安装方法
- 在命令行中执行以下命令
npm install @icedesign/base@latest -S
Guide
评分组件通常用于用户反馈场景。
API
评分
参数 | 说明 | 类型 | 默认值 |
---|---|---|---|
prefix | 样式的品牌前缀 | String | 'next-' |
defaultValue | 默认值 | Number | 0 |
value | 值 | Number | - |
count | 评分的总数 | Number | 5 |
type | 类型可选值:'normal', 'grade' | Enum | 'normal' |
size | 尺寸可选值:'small', 'medium', 'large' | Enum | 'medium' |
allowHalf | 是否允许半星评分 | Boolean | false |
onChange | 用户点击评分时触发的回调签名:Function(value: String) => void参数:value: {String} 评分值 | Function | () => {} |
disabled | 是否禁用 | Boolean | false |
showInfo | 是否展示文本信息 | Boolean/Function | false |
className | 自定义样式名 | String | - |
代码示例
最简单的用法。
查看源码在线预览
import { Rating } from "@icedesign/base";
ReactDOM.render(
<div>
<Rating defaultValue={3.2} onChange={val => console.log(val)} />
</div>,
mountNode
);
设置 disabled
属性后,评分组件仅展示模式,不可选择。
查看源码在线预览
import { Rating } from "@icedesign/base";
ReactDOM.render(<Rating defaultValue={3.2} disabled />, mountNode);
设置 type
属性取值为 grade
,使评分组件具有等级提示信息。
查看源码在线预览
import { Rating } from "@icedesign/base";
ReactDOM.render(<Rating defaultValue={2} type="grade" />, mountNode);
默认情况下评分组件只支持整数评分,通过开启 allowHalf
属性可以支持半星评分。
查看源码在线预览
import { Rating } from "@icedesign/base";
ReactDOM.render(<Rating defaultValue={3.2} allowHalf />, mountNode);
评分组件提供了 showInfo
属性,它支持传入一个函数来返回组件展示的文案信息。
查看源码在线预览
import { Rating } from "@icedesign/base";
ReactDOM.render(
<div>
<Rating
defaultValue={3.2}
onChange={val => console.log(val)}
showInfo={val => val}
/>
</div>,
mountNode
);
默认尺寸为 medium
。通过 size
属性可以控制评分组件的大小,支持三种尺寸 small
, medium
, large
。
查看源码在线预览
import { Rating } from "@icedesign/base";
ReactDOM.render(
<div>
<Rating defaultValue={3.2} size="small" />
<br />
<br />
<Rating defaultValue={3.2} />
<br />
<br />
<Rating defaultValue={3.2} size="large" />
</div>,
mountNode
);