Widget "Navigation" is used to create page-based navigation.
The following properties cannot be used in compound widget "Mapping":
zIndex, left, top, height, width
Appearance
|
|
Editor |
Web browser |
The buttons in the "Navigation" widget cannot be seen in the editor because they are created at runtime.
Widget "NavigationBar" is not visible at runtime.
Properties
Type |
Description |
Bindable |
Necessary |
Default value |
|
alignment |
Orientation of the widget elements. Possible values: horizontal: Elements are arranged from left to right (no line break). vertical: Elements are arranged from left to right (with line break). "alignment" is only applied if childPositioning has value "relative". |
|
|
vertical |
|
autoScroll |
Defines whether a scrollbar is shown when needed. If "autoScroll" is true, childPositioning is relative and the available space is not big enough, a scrollbar is shown in order to be able to navigate to the hidden elements. The direction of the scrollbar depends on the value of property alignment. If "autoScroll" is false, a scrollbar is not shown. |
|
|
false |
|
breakWord |
Defines whether a string without spaces that is too long can be split up in the middle. This option has no effect if multiLine is set to value false. For more information, see here. |
|
|
false |
|
buttonHeight |
Height of the buttons. |
|
|
30 |
|
buttonImageAlign |
Position of the images in relation to the text. |
|
|
left |
|
buttonStyle |
Reference to a widget style created by the user to be used for a "SystemNavButton" widget. |
|
|
default |
|
buttonWidth |
Defines the width of the button. |
|
|
100 |
|
ellipsis |
Defines whether a text that is too long should be indicated by an ellipsis, e.g. "This text is..." instead of "This text is too long". For more information, see here. Defines whether a number that is too long should be indicated by an ellipsis, e.g. "12012 ..." instead of "120125100". Defines whether a number in the ValueDisplaybox that is too long should indicated by an ellipsis, e.g. "12..." instead of "12.000". If true, ellipses are applied; if false, the width of the ValueDisplaybox is adjusted exactly to the number width so that the whole number can be displayed. |
|
|
false |
|
Defines the usability of the widget. A disabled widget (enable=false) does not react to user interaction and does not trigger events. The "enable" behavior is inherited from the container widgets to the child widgets. |
|
|
true |
||
multiLine |
Defines whether the text can be shown in multiple lines. If "wordWrap" has value true, a break is added to the text after a word or at an explicitly defined line break (\n) if necessary. For more information, see here. |
|
|
false |
|
Navigation file ID. The navigation file can be added to the Configuration View in the mapp View folder. For additional information, see here. Example: "mynav" |
|
|
|
||
permissionOperate |
Defines the roles that are permitted to use the widget. For roles without sufficient rights, the widget does not react to user interaction and does not trigger events. |
|
|
|
|
permissionView |
Defines the roles that are permitted to see the widget. For roles without sufficient rights, the widget is hidden. |
|
|
|
|
Defines the index of the child element to be selected (widget). The first child element has index 0. |
|
|
0 |
||
Reference to a customizable widget style. |
|
|
default |
||
Defines the visibility of the widget. The widget can be hidden with visible=false. (visible = true, hidden = false). The "visible" behavior is inherited from the container widget to the child widgets. |
|
|
true |
||
wordWrap |
Defines whether a break will be added to the text after a word if necessary. This option has no effect if "multiLine" is set to value false. For more information, see here. |
|
|
false |
|
zIndex determines the z-order of the widget. With overlapping widgets, the zIndex determines which widget is on the top and which one is on the bottom. The widget with the larger zIndex is on top, and the one with the smaller zIndex is on the bottom. The zIndex must be unique within a piece of content or a container widget. The zIndex is automatically assigned by the visual editor and can therefore be changed via the toolbar. |
|
|
|
||
left |
Absolute position measured from the left border of the surrounded element (e.g. container widget or content). |
|
|
|
|
top |
Absolute position measured from the top border of the surrounded element (e.g. container widget or content). |
|
|
|
|
height |
Defines the total height of the widget in pixels. A value in % refers to the height of the surrounding element. |
|
|
30 |
|
width |
Defines the total width of the widget in pixels. A value in % refers to the width of the surrounding element. |
|
|
150 |
|
tooltip |
Defines the text that should appear as information when the tooltip indicator is pressed. You can use a static text or a text from the text system. For more information, see here. Mode "Tooltip" must be enabled for this. There are two different options for this: •Using action "ShowTooltip" •Using action "Client system" ShowTooltips. |
|
|
|
|
tabIndex |
Property tabIndex is used to manage the tab order during keyboard operation. For additional information, see Keyboard operation. ENTER triggers event Click if tabIndex ≥0. |
|
|
-1 |
Styleable properties
Type |
Description |
Default value |
|
buttonMargin |
Distance between buttons and to the navigation widget. |
0px |