Navigation Document

Last update: Edit

1 Introduction

A navigation document in Mendix Studio shows a configured menu of your app in a form of a tree. You can create items and sub-items in your navigation.

Open the Navigation Document by clicking the corresponding icon in the left menu bar.

2 Properties of Menu Items

Properties of the menu items consists of the following sections:

2.1 Events Section

You can choose the On Click Action in the Events section. The On Click Action defines what action is performed when the user clicks a menu item. The available actions are described in the table below:

Action Description
Nothing No action is taken.
Page The specified page is opened.
Microflow The selected microflow is executed.
Save Changes Saves (commits) all changes made in the currently opened page and closes the page.
Cancel Changes Rolls back all changes made in the currently opened page and closes the page.
Close Page Closes the pop-up window (for pop-up pages) or navigates to the previously visited page. Note that this action will close the page and the changes if any will not be saved. Use Save Changes for this purpose.
Sign Out The current user is signed out of the app.
Open Link Triggers an action based on the link type:
  • Web – navigates to a website
  • Email – composes an email
  • Phone Call – starts a phone call
  • Text Message - sends a text message
Note When you configure Email, Phone Call or Message options, the corresponding default app will be opened on the device when the action is triggered, for example, the default email client will be opened to compose a message.

2.2 General

The properties that can be configured in the General section, are described in the table below.

Property Description Depends on
Caption Fill out the name of the menu item here. Nothing
Icon Set the icon for the menu item here. Nothing
Set As Homepage Allows you to set the menu icon as a homepage, as in, the first page that the user sees when opening your app. On Click Action, available only when a page or a microflow is selected as an On Click Action. For more information, see Events Section.

3 Creating a Menu Item

To create a new navigation item, do the following:

  1. Click the Navigation Document icon in the left menu bar to open the Navigation.

  2. Click a plus at the end of the navigation tree to create a menu item, or click a plus next to the existing navigation item to create its sub-item

  3. Specify the properties of the created item if needed (For more information, see Properties of Menu Items).

4 Read More