评分 Rate - Ant Design

何时使用

对评价进行展示。
对事物进行快速的评级操作。

代码演示

最简单的用法。

normal

给评分组件加上文案展示。

allowClear: true

allowClear: false

支持允许或者禁用清除。

1
1
2
2
3
3
4
4
5
5

自定义字符

可以使用 (RateProps) => ReactNode 的方式自定义每一个字符。

支持选中半星。

只读，无法进行鼠标交互。

A
A
A
A
A
A
A
A
A
A

好
好
好
好
好
好
好
好
好
好

可以将星星替换为其他字符，比如字母，数字，字体图标甚至中文。

API

通用属性参考：通用属性

属性	说明	类型	默认值	版本
allowClear	是否允许再次点击后清除	boolean	true
allowHalf	是否允许半选	boolean	false
autoFocus	自动获取焦点	boolean	false
character	自定义字符	ReactNode \| (RateProps) => ReactNode	<StarFilled />	function(): 4.4.0
className	自定义样式类名	string	-
count	star 总数	number	5
defaultValue	默认值	number	0
disabled	只读，无法进行交互	boolean	false
keyboard	支持使用键盘操作	boolean	true	5.18.0
style	自定义样式对象	CSSProperties	-
tooltips	自定义每项的提示信息	string[]	-
value	当前数，受控值	number	-
onBlur	失去焦点时的回调	function()	-
onChange	选择时的回调	function(value: number)	-
onFocus	获取焦点时的回调	function()	-
onHoverChange	鼠标经过时数值变化的回调	function(value: number)	-
onKeyDown	按键回调	function(event)	-

方法

名称	描述
blur()	移除焦点
focus()	获取焦点

主题变量（Design Token）

组件 Token如何定制？

Token 名称	描述	类型	默认值
starBg	星星背景色	string	rgba(0,0,0,0.06)
starColor	星星颜色	string	#fadb14
starHoverScale	星星悬浮时的缩放	undefined \| readonly string[] \| Transform \| readonly Transform[] \| { _multi_value_?: boolean; _skip_check_?: boolean; value: readonly string[] \| Transform \| (readonly string[] \| Transform \| undefined)[] \| undefined }	scale(1.1)
starSize	星星大小	number	20

全局 Token如何定制？