Back to Tooljet

Star Rating

docs/versioned_docs/version-2.65.0/widgets/star-rating.md

3.20.154-lts4.5 KB
Original Source

Star Rating

The Star Rating widget can be used to display as well as input ratings. The widget supports half stars, and the number of stars can be set too.

<div style={{paddingTop:'24px', paddingBottom:'24px'}}>

Properties

<div style={{ width:"100px"}}> Property </div><div style={{ width:"100px"}}> Description </div><div style={{ width:"135px"}}> Expected Value </div>
LabelThe text to be used as the label for the star rating.This field expects a String value.
Number of starsInitial number of stars in the list on initial load. default: 5.This field expects an integer value.
Default no of selected starsThis property specifies the default count of stars that are selected on the initial load. default: 5 (integer).This field expects an integer value.
Enable half starToggle on to allow selection of half stars. default: false (bool).Click on Fx to programmatically define the value {{true}} or {{false}}.
TooltipsThis is used for displaying informative tooltips on each star, and it is mapped to the index of the star.default: [] (array of strings ).
</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>

Events

<div style={{ width:"100px"}}> Event </div><div style={{ width:"100px"}}> Description </div>
On ChangeThis event is triggered when a star is clicked.

:::info Check Action Reference docs to get the detailed information about all the Actions. :::

</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>

Component Specific Actions (CSA)

There are currently no CSA (Component-Specific Actions) implemented to regulate or control the component.

</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>

Exposed Variables

<div style={{ width:"100px"}}> Variables </div><div style={{ width:"135px"}}> Description </div><div style={{ width:"135px"}}> How To Access </div>
valueThis variable holds the value whenever a rating is added on the component. The variable holds a numerical value.Access the value dynamically using JS: {{components.colorpicker1.selectedColorHex}}
</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>

General

Tooltip

A Tooltip is often used to specify extra information about something when the user hovers the mouse pointer over the widget.

Under the <b>General</b> accordion, you can set the value in the string format. Now hovering over the widget will display the string as the tooltip.

</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>

Layout

<div style={{ width:"100px"}}> Layout </div><div style={{ width:"100px"}}> Description </div><div style={{ width:"135px"}}> Expected Value </div>
Show on desktopToggle on or off to display desktop view.You can programmatically determining the value by clicking on Fx to set the value {{true}} or {{false}}
Show on mobileToggle on or off to display mobile view.You can programmatically determining the value by clicking on Fx to set the value {{true}} or {{false}}
</div> <div style={{paddingTop:'24px', paddingBottom:'24px'}}>

Styles

<div style={{ width:"100px"}}> Style </div><div style={{ width:"100px"}}> Description </div><div style={{ width:"100px"}}> Default Value </div>
Star ColorDisplay color of the star. default: #ffb400 (color hex). Change color by providing Hex color code or choosing one from the picker.
Label colorChange the color of label in widget by providing Hex color code or choosing one from the picker.
VisibilityToggle on or off to control the visibility of the widget. You can programmatically change its value by clicking on the Fx button next to it. If {{false}} the widget will not be visible after the app is deployed.By default, it's set to {{true}}
DisableThis is off by default, toggle on the switch to lock the widget and make it non-functional. You can also programmatically set the value by clicking on the Fx button next to it. If set to {{true}}, the widget will be locked and becomes non-functional.By default, its value is set to {{false}}
</div>