# 评分 Rate

- 页面: https://jiguang132.com/zh/resources/arco-design/docs/rate
- 资源: Arco Design (https://jiguang132.com/zh/resources/arco-design.md)
- 全部指南: https://jiguang132.com/zh/resources/arco-design/docs.md

评分打星组件。

## 安装

```bash
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 |`-`|

---

JGuang 全部资源索引: https://jiguang132.com/llms.txt