The Star Ratings component displays a row of star icons, such as you might see for online ratings.
To use the Star Ratings component in your project:
- Open the Components panel, then the Miscellaneous folder.
- Drag the Star Ratings component to the stage.
- In the Properties panel, find the Star Ratings properties section and change the Rating Value to the number of stars you want.
- To customize the component some more, adjust the other properties (described below).
Change the appearance and behavior of the Star Ratings component in the Properties panel.
|Name||The component name.|
|Rating Value||The numeric rating. Decimals are allowed, and fractional parts from 0.29 to 0.71 show a half-star (e.g., entering 4.29 shows 4½ stars). Can be bound to dynamic data.|
|Icon Size||The size of each star, from 5 to 50 pixels.|
|Show Empty||Check this box to show empty stars if Rating Value is less than Max Value.|
|Fill Empty||Check this box to fill empty stars with a translucent shade of the primary color if Show Empty is enabled. If this box is unchecked, empty stars show only as outlines.|
|Primary Color||The fill color used for stars (if Gradient Type is set to none) or the first color used for the gradient fill.|
|Secondary Color||The second color used for the gradient fill. (Not used if Gradient Type is set to none.)|
|Gradient Type||The gradient fill type. Select linear, radial, or none (the default).|
|Max Value||The highest rating shown by this component, even if Rating Value is set higher. The default is 5.|
|Min Value||The lowest rating shown by this component. If Rating Value is set lower, such as by dynamic data, the component displays nothing. (You can use the Rating value less than minimum event to detect when this happens.) The default Min Value is 3.|
Examples of customizing star appearance
The following examples are all for a Star Ratings component with Rating Value set to 3 and Max Value set to 5.
Events and actionsEvents sent by the Star Ratings component
You can trigger other actions based on the following Star Ratings component events:
|Star ratings created||Sent when the star ratings icons have been created.|
|Rating value less than minimum||Sent when either Rating Value or Max Value is less than Min Value.|
To select one of these events in the Event dialog, set the Star Ratings component as the target.
Learn how to configure events.