You are here: Toolbar Widget
Toolbar Widget
The Toolbar Widget allows you to add native iOS toolbars to your application. This widget is applicable for the iOS platform only.
A toolbar appears at the bottom of a application and contains context sensitive buttons for performing actions relevant to the current form. Toolbars are translucent, may have a background tint, and can be hidden when the user is unlikely to need them. Use a toolbar when navigation isn’t needed, or you want multiple controls for managing content. If navigation is needed, consider using an app menu.
Don't use a toolbar and an app menu on the same form. If you do this, the app menu items appear at the bottom of the form and the toolbar shows above app menu items.
Following are real-time use cases of Tool Bar widget:
-
In music apps, tool bar is used to display controls such as play, pause, skip, etc.,
-
In social networking apps, tool bar can be used to display icons for the actions such as deleting a specific message and composing a new message.
For more information see the Toolbars topic in Apple's developer documentation.
The Toolbar widget capabilities can be broadly categorized into the following:
UI Appearance
| Properties | Description |
|---|---|
| barStyle | Determines the toolbar bar appearance. |
| barTintColor | Determines the tint color of the toolbar bar background. |
| tintColor | Determines the tint color to apply to the toolbar items and bar button items. - hex string |
| translucent | Indicates if the toolbar is translucent. |
| Methods | Description |
|---|---|
| setBarButtonItems | Allows you to set the buttons on the toolbar. |
| setBackgroundImage | Allows you to set the background image for the toolbar. |
| setShadowImage | Allows you to specify the shadow image for the toolbar. |
Enabling RTL
| Properties | Description |
|---|---|
| retainContentAlignment | Helps to retain the content alignment of the widget while applying RTL. |
| retainFlexPositionProperties | Helps to retain the left, right and padding properties while applying RTL. |
| retainFlowHorizontalAlignment | Enables you to change the horizontal flow of the widget from left to right. |
Miscellaneous
| Properties | Description |
|---|---|
| barButtonItems | Contains an array of BarButtonItem objects. |
| isToolBarBottomAttached | Determines if the toolbar is docked to the bottom of the form. |
Toolbar Widget Basics
For an overview of using this widget see Tool and Navigation bars for iOS.