# Rate 评分 用星星给出或展示评分。 ## 基础用法 值是数字,`0` 表示还没有评分。指针悬停时预览将要选中的分数。 ## 半星与清除 `allowHalf` 允许半星:点在星星左半边就是半颗。`clearable` 让再次点击当前分数时清零。 ## 语气、文字与图标 `tone="warning"` 用暖色填充。默认插槽显示在星星后面,参数是当前分数;`icon` 插槽替换星星本身,它同样会画两次(空的一层和填满后裁剪的一层),所以用 `currentColor` 的线条或实心图形都可以。 ## 尺寸与状态 `readonly` 只展示分数,`disabled` 同时变灰。 ## 键盘与读屏 整排星星是一个 `role="slider"`,`aria-valuetext` 读出“3 星,共 5 星”。没有可见标签时用 `aria-label` 命名;在 `DouFormItem` 里会自动关联标签。 | 按键 | 行为 | | --------- | -------------------------------- | | `→` `↑` | 加一颗星(`allowHalf` 时加半颗) | | `←` `↓` | 减一颗星(`allowHalf` 时减半颗) | | `Home` | 清零 | | `End` | 满分 | | `0` – `9` | 直接设为这个分数 | ## API ### Rate Props | 名称 | 说明 | 类型 | 默认值 | | ------------ | -------------------------- | ------------------------ | ----------- | | `modelValue` | 分数,配合 `v-model` | `number` | `0` | | `max` | 星星个数 | `number` | `5` | | `allowHalf` | 允许半星 | `boolean` | `false` | | `clearable` | 再次点击当前分数时清零 | `boolean` | `false` | | `readonly` | 只展示,不可修改 | `boolean` | `false` | | `disabled` | 禁用 | `boolean` | `false` | | `size` | 尺寸,默认取表单或全局配置 | `'sm' \| 'md' \| 'lg'` | `'md'` | | `tone` | 填充的颜色 | `'neutral' \| 'warning'` | `'neutral'` | | `ariaLabel` | 没有可见标签时的名称 | `string` | — | ### Rate Events | 名称 | 说明 | 参数 | | ------------------- | ------------ | ----------------- | | `update:modelValue` | 分数变化 | `(value: number)` | | `change` | 用户改了分数 | `(value: number)` | ### Rate Slots | 名称 | 说明 | | --------- | ---------------------------------- | | `default` | 星星后面的内容,参数为 `{ value }` | | `icon` | 替换星星,参数为 `{ index }` |