Rating

Overview

The Rating widget allows users to intuitively rate items in their applications, with multiple options to customize the rendering and behavior: rating scale (including handling avg. values), custom icons (stars, hearts, circles and more), single and continuous selection of items, keyboard navigation and accessibility.
Tooltip

Each item displays a tooltip that is enabled by default and contains text equal to the item's value. Its content can be modified through the tooltip.template option. Setting tooltip to false prevents displaying the tooltip.
Precision
The widget allows the user to control the precision with which an item is selected by configuring the precision option:
- item - selecting the whole item.
- half - selecting half of the item.
Selection
The widget allows the user to control the selection behavior by configuring the selection option:
- single - allows selecting a single item.
- continuous - allows selecting all items from the start to the end.
Handling Average Values

The widget allows the user to set values with one decimal point (e.g. 0.4, 0.5, 0.5, etc.) for scenarios where an average rating needs to be displayed. The number is rounded during the rendering phase for the purpose of displaying full/half full item based on the value (> .5 shows full star, <= .5 shows half star). The value itself is displayed in the label of the widget.
Keyboard Navigation and Accessibility

The Rating possesses full keyboard navigation functionalities and ensures accessibility by rendering the needed WAI-ARIA attributes.