RateField Rating - DingTalk Help Center

When to Use

Typically used in user feedback scenarios.

Component Example

Component Properties

Attribute	Description	Type	Default
`allowHalf`	Whether half-star ratings are supported	`boolean`	`false`
`behavior`	Display state of the form component	Behavior	`'NORMAL'`
`count`	Total number of rating stars	`number`	`5`
`label`	Title of the form component	`string`	-
`labelAlign`	Location of the form component Title	`'left' \| 'top'`	`'top'`
`labelColOffset`	Offset position of the Title. The value is a grid value, where 1 represents 1/24	`number`	`0`
`labelColSpan`	Width of the Title. The value is a grid value, where 1 represents 1/24	`number`	`4`
`labelTextAlign`	Title alignment of the form component	`'left' \| 'right'`	`'right'`
`labelTipsIcon`	Entry icon for the Title Tips of the form component. Takes effect when labelTipsTypes is set to Text or render	`string`	-
`labelTipsRender`	Custom render method for the Title Tips of the form component. Takes effect when labelTipsTypes is set to render	`(props: IComponentProps) => ReactNode`	-
`labelTipsText`	Title Tips Text of the form component. Takes effect when labelTipsTypes is set to Text	`string`	-
`labelTipsTypes`	Type setting for the form component Title Tips	LabelTipsTypes	`'none'`
`onChange`	Triggered when the user clicks a rating	`({ value: number }) => void`	-
`onHoverChange`	Triggered when the user hovers over a rating	`(value: number) => void`	-
`showGrade`	Whether to display the score	`boolean`	`false`
`size`	Size of the form component	Size	`'medium'`
`tips`	Description of the form component, displayed below the control	`string`	-
`validation`	Validation settings of the form component. For details, see the Form Validation Document	Validation[]	`[]`
`value`	Default value of the form component	`number`	`2.5`
`wrapperColOffset`	Offset position of the form component. The value is a grid value, where 1 represents 1/24	`number`	`0`
`wrapperColSpan`	Width of the form component. The value is a grid value, where 1 represents 1/24	`number`	`0`