This field allows the developer to create a field for rating using stars (or any other image), where the final user will be able to select a rate option according to the configuration made by the developer.
Description of the attributes availables for configuration.
Define the type of the field in the application. In this case we must select the type Rating.
Define the application title that will be showed when the application is executed. The terminology used in the interface of your application is very important for the usability, and we need to use familiar terms for the final user, instead of use terms from the system.
Example, this field “rating” that is named cmp_rating however, the customer would have a better understanding if the label uses Product Rating.
Besides use a fixed text, the Label attribute allows the use of Langs to define the field title, allowing the internationalization of your application.
Define the subtitle that will be shown in the field below the ratings. Example: “Thank you for your feedback!”.
As in the Label, the subtitle attribute also allows the use of Langs for internationalization of your application.
Amount of icons
Define the number of icons that will be displayed in the field. The value set in this attribute must be according to the way the evaluation will be realized.
To evaluate using Stars normally it is used five stars, so , we must to inform 5 in this attribute. After we set the images that will be displayed in the attributes Enabled icon and Disabled icon the result will be the same as in the example:
To use Like/Dislike for example we must inform 1 in the amount of icons, so only one image will be displayed and will change according to the click. In this case, the storage in the database will be 1 for like (enabled icon) and 0 for dislike (disabled icon). You can see the field configured below as like/dislike:
Define the icon that will be shown for the amount selected. Following the like/dislike example, in this option, we must insert the Like image. We must do the same for a star evaluation, where for default we must insert the stars filled .
Define the icon that will be shown for the not selected icons. In this attribute, we set an image to represent the opposite of the previous images set in the Enabled icon.
Still referring the example of the Like/Dislike, in this attribute we must set the Dislike .
As in the stars example, we must insert the image with the empty stars .
Initial Value (type)
Allow the definition of an initial value for the field when the form application is in insert mode. The only option available in this field is Defined. Selecting this option the attribute Initial Value will be showed for set the value.
Example: The initial value is 3 when inserting a new record, the rate field will initiate with 3 stars already selected.
The value defined in this attribute will overlap any value defined previously.
Allow saving a session variable(Global variable) with the field value for being used in other applications.
Example: In the login form, the user name can be saved in the session and used to be displayed in the header of other applications.
In this attribute, we must define a name for the session variable that was enabled previously to receive the field value.
We must inform only the variable name, - var_rating.
We can recover the value as a global variable.
HTML object used to show the form field.
Inform the type of the field in the database.
The Display Settings allows to define the CSS values individually for each field. For each Display schema of scriptcase, there are the same attributes available in Interface.
Display Settings configuration Interface.
- CSS of the Title
- Font : Allows to choose the font type, that will be applied to the application field title.
- Font Size : Allows to choose the the font size, that will be applied to the application field title.
- Font Color : Allows to choose a color for the font from the color pallete.
- Background Color : Allows to define the color for the field, the color can be seleted from the color pallete.
- Bold : Applies the bold style to the font.
- Underline : Applies the underline style to the font.
- Border style : Allows to choose a style for the border.
- Collapse : Allows to define the collapse for the border.
- Border Size : Applies the border size to the title of the field.
- Border Color : Allows to choose a color for the border, using a color pallete to apply to the title.
- Horizontal Alignment : Allows to position the label of the field in the desired position (left,rigth,center and justify).
- Vertical Alignment : Allows to position the label of the field in the desired position (baseline, sub, super, top, text-top, middle, bottom, text-bottom).
- Width : To define a width for the title of the field.
- Height : To define a height for the title of the field.
Allow the developer to set up instructions and hints about the field’s use, allowing the developer to help the users about the system usage.
Description of the settings attributes.
In this area, you can set up a text that will be shown in the application according to the type of help selected below.
Pop-up - Display a default icon ! beside the field. To display the message just click in the icon that a Pop-up will be displayed with the help text.
Hint - Display a default icon ! beside the field. When the mouse is above the icon a help text will be displayed.
The icon displayed when selecting the types Hint or Popup vary according to the theme that is being used in the application. This icon can be modified in the CSS Buttons.
Text - Display a text inside of a
<span></span> beside the field.
Help button position
Allow to set up where the help button will be displayed in the field, there are two options:
Beside: The help icon will be displayed beside the field.
Column: The help icon will be displayed beside the label of the field.