Switching pages using Page Navigators

If you can edit pages, you can use the Page Navigator widget to switch the page that a user can see.

About this task

A Page Navigator switches pages in response to receiving an event through a wire. The Page Navigator uses wiring to determine when it opens the page and what data it can pass to the opening page.

The page that the Page Navigator switches to is a page in the current space or a page in another space. If the page is in the current space, the space displays the page as if the user had selected the tab for that page. If the page is from a different space, the current space closes and the other space opens to the page that specified in the Page Navigator. In both cases, the Page Navigator might pass data that widgets on that page can display. For example, if a Page Navigator opens a page in which a user updates an address, the Page Navigator might pass the old address to prefill the address fields.

Procedure

  1. Click Edit Page.
  2. Add a Page Navigator widget to the page.
  3. Wire the source widget to the Page Navigator:
    1. From the Page Navigator widget menu, click Edit Wiring. The Wiring window opens.
    2. Click Add Incoming Wire and then, from the list, select the source widget. The Wiring window adds the widget and the wire to the diagram. The wire displays the default events for the wire. For the Page Navigator, this event is the Page Navigation event and you do not need to change it.
    3. For the source widget, select the appropriate event. For example, select the Item Selected event for a source widget that has a list of selectable customers.
    4. Click Save. The Wiring window closes.
  4. From the Page Navigator widget menu, click Edit Settings.
  5. Set the values for the fields in the following order:
    1. Set the action to Switch Page.
    2. Select the space that contains the page that you want the user to see. You can now edit the Page field, which lists the pages in that space.
    3. Select the page that you want the user to see. You can now edit the Target Event field, which lists the events that the widgets on that page receive.
    4. Select the target event.
  6. Click OK.
  7. Optional: From the Page Navigator widget menu, click Hide. Hiding the Page Navigator is a recommended step to reduce clutter on the page. Hiding the widget does not impact how the widget performs.

Results

The Page Navigator switches the page whenever the user performs an action that triggers the navigation event. If you set the Space field to the current space, the user sees the page that you specified. If you set the Space field to another space, the user sees the current space close and the other space open to the page that you specified.
Parent topic: Page Navigator