Introduction

Last updated 22/01/2025

This how to guide will demonstrate how to navigate through actions via code. You will learn how to use the following functions inbuilt in Five:

• selectAction()
  - Will select an action to take place of the current action without leaving the current menu item.


• previousAction()
  - Returns to the previously selected or replaced action. This will restore selected actions by default, but by setting the
  revertSelect
  parameter to false, you can restore replaced actions as well. Optionally, you can pass in a number of actions you want to go back (in the case of more than one action being selected or replaced).


• replaceAction()
  - Replace an action on a dashboard. The chosen action will replace the action in the dashboard area that the function is being run from.


• restoreAction()
  - Restores a selected or replaced action to it's original state. This will restore selected actions by default, but by setting the
  revertSelect
  parameter to false, you can restore replaced actions as well.

If you are coding along with these tutorials, you will need to add the Action Navigation application. The Action Navigation application is built sequentially. It is highly recommended to complete all sections before moving on as each subsequent module relies on the data established in previous chapters and are designed to give you a thorough knowledge of all of Five's action navigation functions.

Create the Action Navigation Application

1. Click the Applications menu item.

Figure 1 - Applications menu item

2. Click the Add Item button.

Figure 2 - Add Item button

3. Type Action Navigation in the Title field.

4. Click the Save button in the form app bar.

Figure 3 - Save button

5. Click the Manage button in the form app bar.

Figure 4 - Manage button