Star Rating

This element allows the user to give his/her feedback in the form of stars (For example: -one star, two stars, etc.). When the rating is given, the selected stars should be highlighted in different colors.

Usage

When to use

Use when a frequent user’s feedback is required.Show evaluation.A quick rating operation on something.

Star Rating Configuration

The “Star Rating” element consists of the following properties:

• UI Configuration
• Event Configuration

UI Configuration

For the “Star Rating” element, you can configure the following UI properties:

Tab	Property Name	Description	Mandatory	New Default Value	Visibility Rules
Basic	Reference Name	Specifies a unique name of the element. At the application level, an element is identified and managed by the reference name.	Yes	StarRating 1
Basic	Caption	Specifies the title of the element.	No	Star Rating
Basic	Rating Value	This property allows you to configure the value of the rating. # Sample Rating Value static(‘3.0′,’double’)	No	static(“3.0″,”double”)
Basic	Total Star Count	This property allows you to configure the total number of the stars that the application displays to capture the user’s rating.	No	5
Basic	Default Value	This property allows you to define the default value of an element. To define the default value: –> Click in this box, and it displays the list of the pre-define functions, attributes, and element IDs. –> In the list, select an attribute from which the application will fetch the default value and then display it in the element.
Basic	Star Size	In this box, enter the size (For example: – 24) of the star that the application will display to the user.	No	20
Basic	Read Only	This property is configured to make the values of rating only readable. It provides the following options: Yes: – Selecting this value means that the user cannot select the stars to give the rating No: – Selecting this value means that the user can select the stars to give the rating.	No	marked
Basic	Visible	Allows you to define the default visibility of the UI element.	No	marked
Basic	Business Rule	Click this list and then select a pre-defined business rule that will determine the element’s visibility. If the user’s action satisfies the condition in the business rule, the application will display or hide the element. To define the business rule, access the Business Rule Manager module.	No
Basic	Enable	Allows the user to enable/disable an element. You can decide whether the element needs to be clickable and usable.	No	marked
Basic	Business Rule	Click this list and then select a business rule to make the element active or inactive. If the user’s action satisfies the condition in the business rule, the application will make the element active or inactive in the application. To define the business rule, access the Business Rule Manager module.	No
Basic	Mandatory	Allows you to configure the element as a mandatory element.	No	unmarked
Basic	Half Rating	This property allows the user to select half of the stars when the user gives the rating. It provides the following options: Yes: – Selecting this value means that the user can select half of the stars to give the rating. No: – Selecting this value means that the app will not allow the user to select half of the total stars to give the rating.	No	marked
Basic	Message on Failure	This property becomes visible when you select Yes under Mandatory. In the Message on Failure box, enter the error message that the application will display if the user does not perform the function on the element.	No	Required	when mandatory = checked
UI Properties	Styles	Allows you to select a specific style for the element from the list of pre-defined styles. The vDesigner module offers pre-defined styles that you can apply to the element. These pre-defined styles are: –> Primary –> Warning –> Success –> Danger –> Info –> Secondary	No	Primary
UI Properties- Alignment & Spacing	Margin	Allows you to desirably define margin around each side of the element. It provides four different boxes to define the margin outside the right, left, top, and bottom border of the element.	No	Theme Variable (Margin)
UI Properties- Alignment & Spacing	Element’s Alignment	This property contains three tabs. You can use these tabs as follows: 1. Left:- By default, this tab is selected. It aligns the element to the left of the page. 2. Center:- If you select this tab, it aligns the element at the center of the page. 3. Right:- If you select this tab, it aligns the element to the right of the page.	No	Left
UI Properties-Caption	Font	Select the font type (For example: – Arial) of the element’s caption.	No	Theme Variable (Font Family)
UI Properties-Caption	Size	Enter the font size of the caption.	No	12
UI Properties-Caption	Color	Select the color of the font of the caption.	No	Theme Variable (Caption)
UI Properties-Caption	Bold	Enter the thickness of the character of the element’s caption in the range of values from 1 to 9.	No	4
UI Properties-Caption	Style	Select the style of font (For example:- Italic) of the caption	No	Normal
UI Properties- Shape & Decoration	Type	Under the Shape and Decoration section, this property has the two following options: Autofill:- If you select this option, the element will occupy the available space of the parent layout. Manual:- If you select this option, you can define a specific size of the element.
UI Properties- Shape & Decoration	X	Allows you to move the element along the X-axis; when the value increases, the element moves from left to right.	No	Show & Disable
UI Properties- Shape & Decoration	Y	Allows you to move the element along the Y-axis; when the value increases, the element moves from top to bottom.	No	Show & Disable
UI Properties- Shape & Decoration	Border Color	Click the Color box and then define the color of the border of the star shape.	No	Theme Variable (Primary)
UI Properties- Shape & Decoration	Opacity	Opacity is the degree to which content behind an element is hidden, and is the opposite of transparency.	Yes	100%
UI Properties- Shape & Decoration	Select Color	Click the Color box and then define the color of the star shape.	No	Theme Variable (Primary)
UI Properties- Shape & Decoration	Opacity	Opacity is the degree to which content behind an element is hidden, and is the opposite of transparency.	Yes	100%
UI Properties-Tooltip	Show Tooltip	Click this check box to make a tooltip available with the element.	No	Clear Check box
UI Properties-Tooltip	Message	This property allows you to configure the message for a tooltip. To configure the message: Click in this box, and a smart selector expands. In the smart selector, you can select the following: 1. Static Function:- By using the static function, you can manually define the message inside the static function. 2. Element:- If you select the element, the application will fetch the message that is linked to the selected element. 3. Entity:- If you select an entity, the app will fetch the message from the entity.	Yes	{{fx}}	When the Show Tooltip check box is selected
UI Properties-Tooltip	Color	This property allows you to define the color of the tooltip’s message. To define the message’s color: 1. Click the left Color box, a color canvas opens. 2. On the color canvas, move the circle on the upper bar to select the color of the tooltip’s text. 3. Move the circle on the lower bar to define the transparency of the selected color.	No	#6F6F6F	When the Show Tooltip check box is selected
Data	Entity Path	This property allows you to map an attribute to the element. You define the JSON based attributes in the entity in the Data Modeler module. To define the entity path: –> Click in the Entity Path box, and a list expands. –> The list displays several attributes from the entity. –> In the list, select an attribute to map it to the element. After the user performs the function on the element, the application can perform the following functions: a. Fetches data from the attribute and then displays it in the element. b. Stores data in the attribute.	No		Entity Name = “entity”

Event Configuration

On the “Star Rating” element, you can configure the following event:

• onClick