> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# RateField Rating

> Reference for the RateField rating component, covering property configurations such as total rating count and display style. Commonly used in feedback scenarios like satisfaction surveys.

## 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](/open/yida/components/interface#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](/open/yida/components/interface#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](/open/yida/components/interface#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](/open/yida/guide/concept/validation) | [Validation\[\]](/open/yida/components/interface#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`        |