# Rating

## Basic #### Default Value Enter the default number to decide the rate when the widget is loaded. This can also be retrieved from the backend using query or loaded using low-code.

#### Max Rating The value set here will be the maximum rate value for the widget. Any value beyond this will be considered as the maximum rating. Typically, it is 5 for collecting feedback from users.

## Interaction #### Event Handlers | Event | Description | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **`Change`** |

The "Change" event is activated when the value of the widget is changed. When this event triggers, the associated action gets executed.

| #### Disabled Disables the user interaction with the element on the page. It visually indicates that the element is inactive and prevents users from interacting with it when applied. Shows a red-crossed warning symbol and can be customized to disable the widget according to certain conditions using low-code.

#### Hide This sets whether the widget has to be displayed on the screen when the program is loaded. This shows/hides the widget both on desktop and mobile devices.

## Advanced #### Allow Half Rating Points The user can pick half rate and submit the value only if this is enabled using the boolean value `True`. For example - the user can click part of the rate start to set 2.5/5.

## Layout #### Widget Tooltip This tooltip pops up when the user moves the mouse over the input area of the widget. It is commonly used to hint at the type of input the user needs to provide. The tooltip will be immediately shown when the user's mouse hovers over the widget, and immediately hides when the user's mouse leaves. This information will be contextual, useful, and informative.

## Label Represents the caption for the widget in the user interface. It is recommended to keep the label string short and convey the usage of the widget in the UI #### Position | Property | Description | | :------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Left` |

Shows the label on the left side of the widget entry

| | `Top` |

Shows the label on top of the widget entry

| #### Alignment | Property | Description | | :------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Left` |

Align the text on the left corner of the label area

| | `Right` |

Align the text on the right corner of the label area near the tree view

| #### Width Enter a number value to set the width of the widget. It can be set in terms of pixels and percentage.

## Style

Property	Description
Label	Set the colour for the label text. Recommended to set in contrast with the background.
Checked	Set the colour for the checked or marked review star. It is set to yellow usually.
Unchecked	Set the colour for the unchecked or unmarked review star. It is set to light gray or white, usually.
Margin	This value is set in terms of "px" number which creates the space between the border and the content of the widget.
Padding	This value is set in terms of "px" number which creates the space between the border and outer elements.