JGuang

评分

Rate · Arco Design

交互预览
npm install @arco-design/web-react@2.66.18

评分 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星的总数number5
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-