Rating
一排星,点哪颗打几分,悬停预览。键盘上方向键在星之间移动、空格或回车选定(漫游焦点,不是原生单选那样移动即选中),读屏念「第 n 颗,共 5 颗」。
整星、半星与只读
3 分(再点当前分清零)
3.5 分
只读展示、改用主色
step取1(缺省)或0.5。半星时每颗星分两格,每格是裁到一半宽的实心星叠在空心星上。clearable再点当前分清零;readonly只展示不能改,也不变淡(与disabled区分)。- 星的颜色是
currentColor,缺省警示色(黄),用class的text-*改。星的边长比图标档大一圈,跟size走。
API
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
length | number | undefined | 5 | 几颗星,缺省 5 |
step | 1 | 0.5 | undefined | 1 | 最小单位:1(缺省)、0.5 半星 |
clearable | boolean | undefined | false | 再点当前分可以清零 |
readonly | boolean | undefined | false | 只读展示:不能改,也不变淡 |
disabled | boolean | undefined | false | — |
ariaLabel | string | undefined | undefined | — |
size | "mini" | "small" | "medium" | "large" | "super" | undefined | undefined | 尺寸:mini / small / medium(默认) / large / super;不传则跟随环境 data-size |
modelValue | number | undefined | 0 | — |
Emits
| 事件 | 载荷 | 说明 |
|---|---|---|
update:modelValue | [value: number] | — |