The NavOverflow control allows to use a navigation bar in your apps. The navigation bar can have any number of items and subitems. It's responsive and customizable with the properties that you can see below. You can also take a look at the Navbar control.
The NavOverflow controls is different than the Navbar control. Can be used also as an app navigation bar, but, the NavOverflow do not use a drawer menu when the items are collapsed, but a menu similar to the one used by the Dropdown control menu.
This control has a default style, and, some control JavaScript properties (see below), can also changes the control style, not to mention the Classes property, that you can use to establish one or more CSS classes to be applied to the control.
In addition to that style, you can also set custom CSS rules for the control by using the IDE controls style inspector. If this is not enough, you can include any number of CSS stylesheets in the app by using the app files manager.
If you want to use CSS stylesheets, you need to know how to refer to the control, so take a look at the Runtime selectors help topic.
The NavOverflow control put at your disposition the below designtime properties or variables. Designtime means here that these properties are only available in designtime and not in runtime.
The NavOverflow control put at your disposition the below runtime properties or variables. You can set almost all these variables in designtime, and, they are also available to be use when the app is running. Note that we named here these variables in a capitalized way, because is like you can see it in the designtime control's inspector, however, at runtime we use the lower camel case way.
The NavOverflow control put at your disposition the below methods. You can use these methods in runtime in order to perform various control related tasks.
The NavOverflow control put at your disposition the below events handlers:
Designtime. Integer variable. The Top property stores the top position of the control in pixels. The pixels are relative to the app view, dialog or frame, and, is used "as is" if the app have the "Scale" app option is set to "false". Remember that this control property is only for designtime and is not available in runtime.
Designtime. Integer variable. The Left property stores the left position of the control in pixels. The pixels are relative to the app view, dialog or frame, and, is used "as is" if the app have the "Scale" app option is set to "false". Remember that this control property is only for designtime and is not available in runtime.
Designtime. Integer variable. The Width property stores the width of the control in pixels. The pixels are relative to the app view, dialog or frame, and, is used "as is" if the app have the "Scale" app option is set to "false". Remember that this control property is only for designtime and is not available in runtime.
Designtime. Integer variable. The Height property stores the height of the control in pixels. The pixels are relative to the app view, dialog or frame, and, is used "as is" if the app have the "Scale" app option is set to "false". Remember that this control property is only for designtime and is not available in runtime.
Designtime. Boolean variable. The Locked property determines if the control can be moved or resized in app view designer or not. Set a "false" value mean the control can be moved and resized. Set a "true" value (by default) mean the control cannot be moved nor resized. Remember that this control property is only for designtime and is not available in runtime.
Runtime. String variable. The Name control property stores the name of the NavOverflow control as you set in designtime. The Name property value must be unique for the same app view, dialog or frame, that is, it's possible to have more than one "navoverflow1" in the app, if that controls resides in different app views, dialogs or frames. Note that you must consider this variable as read only: change the name of a control in runtime can cause unexpected results.
Runtime. Mixed variable. The Event control property stores the "event" variable received in all the control events. This variable can contain the target (HTML element of the control) that fire the event and more useful stuff.
Runtime. String variable. The Title control property stores some small but descriptive text, mainly to be used to be show that text when the user place the mouse cursor into the control.
Runtime. Array of objects variable. The Items control property stores all the items of the NavOverflow control. This variable is an array of objects, since every NavOverflow item must be an object. You can set this property at runtime, but, also at designtime, by using the NavOverflow Items dialog These objects / items can have the below properties:
| Name | Type | Description |
|---|---|---|
| text | String | Mandatory. It's the item's text, like you want to show in the NavOverflow. |
| icon | String | Optional. One of the available Fontawesome icon classes, eg. "fa-solid fa-info-circle". |
| actived | Boolean | Optional. You can set this variable to "true" in order to made the item appear activated (with a different background color). |
| disabled | Boolean | Optional. You can set this variable to "true" in order to disable the item. Disabled elements cannot be pressed by the user. |
Runtime. Object variable. This variable is "null" by default, but, it's filled with the pressed NavOverflow Item in the ItemClick event. Take a look at the Items property, in which you can see the mandatory and optionals properties for every item in the NavOverflow control.
Runtime. Number variable. This variable is "-1" by default, but, it's filled with the pressed NavOverflow Item index in the ItemClick event. This item index is the index (starting by zero) of the pressed item, in the NavOverflow Items property.
Runtime. String variable. The Classes control property stores one or more additionals CSS classes (space separated) to be applied to the control.
Runtime. Boolean variable. The Hidden control property determines if the control appear visible to the user or not. Set to "true" to hide the control, or to "false" to show the control (by default).
Runtime method. You can use this NavOverflow control method in order to append a new text item at the end of the NavOverflow. This method admits the below arguments:
| Name | Type | Description |
|---|---|---|
| text | String | The item text for the new NavOverflow item. Can contain a bit of HTML if needed. |
| actived | Boolean | This is an optional boolean argument that determine if the item must appear actived or not. An actived text item appear with a different background color in the NavOverflow. |
| disabled | Boolean | This is an optional boolean argument that determine if the item must appear disabled or not. A disabled text item appear grayed in the NavOverflow and cannot be pressed by the user. |
Runtime method. You can use this NavOverflow control method in order to insert a new text item at the specified index of the NavOverflow. This method admits the below arguments:
| Name | Type | Description |
|---|---|---|
| index | Number | The item index for the new NavOverflow item. The NavOverflow items started by zero, so the first item is the zero index, the second item is the first index and so on. |
| text | String | The item text for the new NavOverflow item. Can contain a bit of HTML if needed. |
| actived | Boolean | This is an optional boolean argument that determine if the item must appear actived or not. An actived text item appear with a different background color in the NavOverflow. |
| disabled | Boolean | This is an optional boolean argument that determine if the item must appear disabled or not. A disabled text item appear grayed in the NavOverflow and cannot be pressed by the user. |
Runtime method. You can use this NavOverflow control method in order to remove a specific menu item of the NavOverflow. This method admits the below argument:
| Name | Type | Description |
|---|---|---|
| index | Number | The index of the item to be removed. The NavOverflow items started by zero, so the first item is the zero index, the second item is the first index and so on. |
The ItemClick event handler is fired when the user click in one of the NavOverflow items. The pressed item is stored in the NavOverflow Item property. See also the available events variables.
The Click event handler is fired when the user click or tap into the NavOverflow control. See also the available events variables.
The DblClick (Double Click) event handler is fired when the user double click or double tap into the NavOverflow control. See also the available events variables.
The Focus event handler is fired when the when the NavOverflow control receive the user focus. This event is the partner of the Blur event that you can see below. See also the available events variables.
The Blur event handler is fired when the when the NavOverflow control loss the user focus. This event is the partner of the Focus event that you can see above. See also the available events variables.
The MouseUp event handler is fired when the user up the mouse into the NavOverflow control. See also the available events variables.
The MouseDown event handler is fired when the user down the mouse into the NavOverflow control. See also the available events variables.
The MouseMove event handler is fired when the user move the mouse into the NavOverflow control. See also the available events variables.
The MouseEnter event handler is fired when the user enter the mouse into the NavOverflow control. See also the available events variables.
The MouseLeave event handler is fired when the user leave the mouse from the NavOverflow control. See also the available events variables.
The ContextMenu event handler is fired when the browser must shown the context menu of the the NavOverflow control, which occur when the user click with the right mouse button into the NavOverflow control. See also the available events variables.
The below JavaScript variables are available in all the referred NavOverflow control events handlers:
| Name | Type | Description |
|---|---|---|
| event | Mixed | This variable is received in almost all control events. You can use this variable to stop the propagation of the event, to access the HTML element who fire the event and more. |
| self | Object | Stores the control object. This is a shortcut to the control variable, and it's available since we are talking about specific control events. |
| view | Object |
Stores the current app view or dialog. This variable allow us to access to that view or dialog properties and methods and also their controls properties and methods. For example, you can access to a control properties using the variable "view.yourControlName", suposing the control is named "yourControlName". |
| views | Object | Stores all the loaded app views. Note that loaded views mean that the app views has been previously show to the user. It's possible to access to the app view controls properties like "views.view1.yourControlName", suposing the view is named "view1" and the control is named "yourControlName". In the same way we can access to other controls of the view and to other loaded views and their controls. |
| frames | Object | Stores all the app frames. You can use this variable to access to all the app frames and their controls. |
| dialogs | Object | Stores all the app dialogs. You can use this variable to access to all the app dialogs and their controls. |
| app | Object | Stores all the app properties and methods. You can use this variable to access to all the app properties and app methods. |