The Toolbar UI element is a collection of tools that can be accessed using UI elements. Therefore, toolbars provide an additional way of grouping UI elements functionally.
A toolbar can contain the following elements:
● ToolBarButton, ToolBarButtonChoice, ToolBarLinkToAction, ToolBarLinkToURL, ToolBarDropDownByIndex, ToolBarDropDownByKey, ToolBarInputField, ToolBarSeparator, ToolBarToggleButton, ToolBarLinkChoice.
● CalendarPaginator. The CalendarPaginator allows the user to browse through an assigned Calendar UI element.
These toolbar elements are horizontally arranged in one row of the toolbar. The size and position of the individual UI elements are automatically calculated. You can use the wrapping property to determine whether a line break can be applied to the elements in a row.
Each individual element has the collapsible property, with which it can be hidden. If you have set at least one of these elements to collapsible, a triangle symbol appears in the toolbar at runtime via which the user can hide these elements. This is demonstrated by the following screenshots:
● collapsed
● not collapsed
You can create all elements as ToolBarRightItems. These are then arranged starting from the right. ToolBarRightItems cannot be collapsed.
It’s recommended to use the ToolBar inside the following elements:
● Group, Tab, Table, Tray
● accessibilityDescription
When accessibility is activated, the assigned text is added to the tooltip. This description provides semantic details of the UI element and is only read by the screen reader if the user focuses the complete Ul element.
● design
Specifies the display style of the ToolBar on the screen. The design property is represented by the enumeration type WDToolBarDesign and has the values:
emphasized |
Highlights the ToolBar. |
Standard |
Displays the ToolBar in the standard design. |
● enabled
Specifies whether or not the ToolBar is activated. If you deactivate the ToolBar, all elements of the ToolBar are deactivated. Some renderer implementations can ignore this behavior.
● wrapping
Specifies whether or not the ToolBar elements can be wrapped.
Name |
Interface |
Type |
Initial Value |
Bindable |
accessibilityDescription |
IWDToolBar |
String |
|
bindable |
design |
IWDToolBar |
WDToolBarDesign |
Standard |
bindable |
enabled |
IWDToolBar |
boolean |
true |
bindable |
visible |
IWDToolBar |
WDVisibility |
visible |
bindable |
wrapping |
IWDToolBar |
boolean |
true |
bindable |