评分 Rate
评分打星组件。
安装
npm install @arco-design/web-react@2.66.18
在入口引入 @arco-design/web-react/dist/css/arco.css,用 ConfigProvider 设置语言。React 19 项目还需在入口最先引入 @arco-design/web-react/es/_util/react-19-adapter,否则 Message、Modal 等命令式 API 无法渲染。
示例
- 基础用法:基础评分。
- 半选:指定
allowHalf来支持半选。 - 附有文案:含有文案的评分组件。
- 只读:通过
readonly指定Rate为只读。 - 支持清除:指定
allowClear来允许清除评分。 - 其他评分字符:可以将星星替换为其他字符,比如表情、字母,数字,字体图标甚至中文。
- 任意长度的评分:通过指定
count来打造任意长度的评分组件。 - 笑脸分级:通过
grading指定使用笑脸分级。 - 显示提示信息:通过
tooltips来为每一个评级提供鼠标悬浮时的提示信息。
示例来自 Arco Design 官方仓库(MIT),固定在 npm 2.66.18 对应的提交;部分示例使用在线图片或上传地址,预览中网络请求被禁用。
API
Rate
| 参数名 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| allowClear | 是否允许清除 | boolean | - |
| allowHalf | 是否允许半选 | boolean | - |
| disabled | 是否禁用 | boolean | - |
| grading | 笑脸分级 | boolean | - |
| readonly | 是否只读,不能选择 | boolean | - |
| count | 星的总数 | number | 5 |
| defaultValue | 默认值 | number | - |
| value | 星的个数,受控值 | number | - |
| className | 节点类名 | string | string[] | - |
| style | 节点样式 | CSSProperties | - |
| tooltips | 自定义每一项的提示信息 | string[] | - |
| character | 自定义字符 | ReactNode | ((index: number) => ReactNode) | <IconStarFill /> |
| onChange | 选择时的回调 | (value: number) => void | - |
| onHoverChange | 鼠标经过时数值变化的回调 | (value: number) => void | - |