|
| 1 | +# Navigation |
| 2 | + |
| 3 | +**Navigation** aggregates your apps onto the left sidebar and guides you to quickly find the needed app. |
| 4 | + |
| 5 | +<figure><img src="../.gitbook/assets/navigation1.png" alt=""><figcaption></figcaption></figure> |
| 6 | + |
| 7 | +On Openblocks homepage, click **New** and select **Navigation** to create a navigation page. |
| 8 | + |
| 9 | +<figure><img src="../.gitbook/assets/navigation2.png" alt=""><figcaption></figcaption></figure> |
| 10 | + |
| 11 | +## Menu items |
| 12 | + |
| 13 | +In the **Navigation** editor, click **+ New** to add menu items. |
| 14 | + |
| 15 | +<figure><img src="../.gitbook/assets/navigation3.png" alt=""><figcaption></figcaption></figure> |
| 16 | + |
| 17 | +Select a menu item, choose the app to navigate to, and change the label and icon if needed. The app is displayed on the canvas in real time. |
| 18 | + |
| 19 | +<figure><img src="../.gitbook/assets/navigation4.png" alt=""><figcaption></figcaption></figure> |
| 20 | + |
| 21 | +### Add submenu items |
| 22 | + |
| 23 | +To add submenu items, click `···` > **Add submenu item**, or drag `⋮⋮` to make one menu item subordinated to another. |
| 24 | + |
| 25 | +<figure><img src="../.gitbook/assets/navigation5.png" alt=""><figcaption></figcaption></figure> |
| 26 | + |
| 27 | +<figure><img src="../.gitbook/assets/navigation6.gif" alt=""><figcaption></figcaption></figure> |
| 28 | + |
| 29 | +{% hint style="warning" %} |
| 30 | +A parent menu item can only expand or fold the submenu items. You cannot link an app to it. |
| 31 | + |
| 32 | +When you delete a parent menu item, all submenu items under it are deleted at the same time. |
| 33 | +{% endhint %} |
| 34 | + |
| 35 | +<figure><img src="../.gitbook/assets/navigation7.png" alt=""><figcaption></figcaption></figure> |
| 36 | + |
| 37 | +### Add URL parameters |
| 38 | + |
| 39 | +Add URL query parameters or hash parameters to a menu item with `key` and `value`. |
| 40 | + |
| 41 | +Then click the menu item on the canvas, and the parameters are appended to the URL of the app to be opened. You can check in **Globals** tab in the left pane. |
| 42 | + |
| 43 | +{% hint style="info" %} |
| 44 | +To reference the url parameters, use `{{url.query.key1}}` or `{{url.hash.key1}}` in your app. |
| 45 | +{% endhint %} |
| 46 | + |
| 47 | +For more information of URL parameters, see Go to app. |
| 48 | + |
| 49 | +### Visability of menu items |
| 50 | + |
| 51 | +By default, a menu item is hidden for users without app permission. When you toggle this option off, the users can see the menu item but can not view the app it references to. |
| 52 | + |
| 53 | +## Permissions |
| 54 | + |
| 55 | +The permissions for navigations are the same as those for modules and apps. See Permissions for resources. |
0 commit comments