---
url: /components/rate.md
---
# Rate 评分

星级评分控件：支持半星、鼠标悬停预览、键盘方向键步进（allow-half 时步进 0.5）；填充色按 low/high 阈值分三档取色，可展示分级文案或总分。组件获得焦点后可用方向键调整分值。

## 基础用法

`v-model` 绑定分值；`allow-half` 开启半星（悬停星左半取 0.5），`clearable` 时再次点击当前分值清零。

## 尺寸

`size` 影响图标大小（large 24px / default 18px / small 14px）。

## 最大分值

`max` 决定星星数量，分值范围 0 到 max；`texts` 文案数量应与 max 匹配。

## 分档颜色

`colors` 接受三档色数组 \[低, 中, 高]（按 low-threshold / high-threshold 分档），或 `{ 阈值: 色 }` 对象（取分值命中的最小阈值档）；`void-color` 为未选中星颜色。

## 分级文案与总分

`show-text` 显示 `texts` 中的分级文案（按当前分值向上取整取用）；`show-score` 优先级更高，按 `score-template`（`{value}` 为分值占位）显示总分。

## 自定义图标

`icon` / `void-icon` 传 registry 图标名，选中与未选中可用不同图标；图标颜色随分档取色。

## 只读与禁用

`readonly` 用于展示场景（无交互但保持正常配色），`disabled` 禁用并按 `disabled-color` 置灰选中星。

## API