NoesisGUI
 

📘 Digital Navigation

🏘️ NoesisGUI ▸ 🏠 Noesis Studio ▸ 📘 Working With Interactivity ▸ 📘 Digital Navigation

Overview

In addition to robust mouse and touch-based navigation, Noesis comes built-in with full support for Digital Navigation. This allows an entire interface to be effectively interacted with using keyboard keys, as well as controller buttons.

Although many Elements within the framework come with a set of default navigation mechanics, they can be fully customized through 📑 Digital Navigation Configuration. In this system, exactly which Element gets 📑 Focus when any directional input is actuated can be precisely tailored to best fit the desired outcome within any context.

Anatomy of Digital Navigation

In the framework, Digital Navigation is structured in a way where all Elements within a context are spatially placed within an invisible grid, where each Element is interpreted one-against-another along a horizontal (X) and vertical (Y) axis.

The system is composed of two core principles:

  • 📑 Focus, which dictates which of the Elements within the layout currently serves as the 'center' of navigation from which an input actuation will take place when performed. This includes both actuating the 'focused' Element itself, as well as it serving as the origin for any directional movements away from it to another Element within the shared grid.
  • 📑 Directionality, which dictates which Element will 'focus' next, when a directional input is actuated, in either a North, South, East, or West direction.
Documentation_Guide_Interactivity_DigitalNavigation_NavigationAnatomy.png

Focus

For any Digital Navigation to function, an Element must have Focus. Within the context of Digital Navigation, Focus serves two essential purposes:

  1. If a 'selection' input is actuated, it determines which Element receives the input. For example, pressing Space on a focused Element will 'press' it.
  2. If a 'directional' input is actuated, it sets the origin point within a layout from where the directional input begins. For example, pressing ArrowKey (Up) will move focus from the currently-focused Element, to the next focusable Element directly 'North' of it.
Documentation_Guide_Interactivity_DigitalNavigation_Focus_Video.gif

Directionality

In order to move 'focus' from one Element to another, Directionality can be used to navigate the grid of Elements North, South, East, and West, relative to the 'focused' Element.

Documentation_Guide_Interactivity_DigitalNavigation_Directionality_Video.gif

By default, the direction in which focus moves is determined with ArrowKey (Up/Down/Left/Right) on the keyboard, and D-Pad (Up/Down/Left/Right) or LeftJoystick (Up/Down/Left/Right) on a controller.

This can however be changed, either at the engine level, or in Noesis Studio using 📑 Directional Navigation.

Digital Navigation Configuration

When designing a Digital Navigation system using the principles above, a selection of mechanics can be leveraged to ensure control over the end-user's navigational experience:

Setting Focus

The 'Focusable' Property in an Element's 📘 Properties Panel, can be used to determine if it is capable of receiving 'focus' as part of the digital navigation system.

Many Elements have this value 'checked' by default, and will thus automatically be included as a candidate for being 'focusable' within the overall grid of Elements. For others, they can be manually included by simply checking their 'Focusable' Property.

Documentation_Guide_Interactivity_DigitalNavigation_Property_Focusable.png

It is also through the 'Focusable' Property that Elements can be intentionally excluded from the digital navigation system.

Documentation_Guide_Interactivity_DigitalNavigation_Unfocusable_Video.gif

To provide the best possible user experience, it is usually best-practice to manually establish which Element should be focused upon opening a Page. This can be achieved through 📘 Triggers, in which a Page contains an EventTrigger which specifies that when the Page is 'Loaded', to SetFocusAction on a specific Element within the scope.

Documentation_Guide_Interactivity_DigitalNavigation_SetFocusAction.png

The system will however still function even without setting a 'starting Focus' manually. When landing on a Page for the first time, in a scenario where more than one Element capable of receiving 'focus' is present in a hierarchy:

  • Pressing 'up' will set focus on the bottom-most and left-most focusable Element.
  • Pressing 'down' will set focus on the second-to-top-most and left-most focusable Element.
  • Pressing 'left' will set focus on the right-most and top-most focusable Element.
  • Pressing 'right' will set focus on the second-left-most and bottom-most focusable Element.
Documentation_Guide_Interactivity_DigitalNavigation_StartingFocus_Video.gif

Directional Navigation

Within Studio, Directional Navigation is handled through two primary methods, each with their own default inputs:

  • Omni-Directional Navigation (Up/Down/Left/Right), using ArrowKey (Up/Down/Left/Right) on the keyboard, and D-Pad (Up/Down/Left/Right) or LeftJoystick (Up/Down/Left/Right) on a controller.
  • Bi-Directional Navigation (Prev/Next) using Tab and Shift (Hold) + Tab on the keyboard to move forward and backward respectively through the array. When using a controller, ShoulderButton (Right) and ShoulderButton (Left) are used to move to the next or previous item.
Documentation_Guide_Interactivity_DigitalNavigation_NavigationModes_Video.gif

Selection

Within Studio, 'selecting' an Element is handled with the framework's defaults using Space on the keyboard, A on Xbox, Nintendo, and Steam Deck controllers, and X on PlayStation controllers.

Escaping Focus

Focus can be disabled at any time using 📘 Triggers and using either a KeyTrigger or a GamepadTrigger containing a ChangePropertyAction which sets the 'Focusable' Property of the desired Element to 'False'.

Documentation_Guide_Interactivity_DigitalNavigation_RemoveFocus.png

Custom Inputs

Inputs other than the defaults listed above can be easily set up using 📘 Triggers, by customizing bespoke 📘 Trigger Types set to use KeyTriggers or GamepadTriggers.

Documentation_Guide_Interactivity_DigitalNavigation_KeyTrigger.png

In the framework, all input events are processed using Noesis Keys. The 📑 Platform Map can be used to determine which Noesis Key corresponds to a specific input device's button.

Digital Navigation Preview Mode

When a Page is in 'Play Mode', Noesis Studio offers a handy Digital Navigation Preview which can be toggled on or off by pressing F9 on the keyboard, and allows creators to easily visualize the Digital Navigation system through a series of overlays drawn on top of the interface.

The Digital Navigation Preview provides three key pieces of information:

  1. Which of the Elements on-screen is currently-focused, as displayed by the bright magenta border.
  2. Which Elements are candidates to have the current 'focus' moved to them in the event of a directional input actuation, as displayed by the subdued magenta borders.
  3. Where focus will move to when a directional input is actuated in the North, South, East, or West directions, as displayed by the up, down, left, and right arrows overlaid on directionally-adjacent focusable Elements.

Platform Map

How Noesis inputs are mapped into engine inputs is determined by each individual implementation, and its own configuration.

With that said, Noesis Studio includes its own input system, ensuring that throughout development, in addition to mouse navigation, entire interfaces can be navigated within the application using a keyboard or controller.

How each 'Noesis Key' is mapped to all supported input devices is as follows:

Noesis Key Keyboard Xbox / Steam Deck PlayStation Nintendo
Key_GamepadLeft ArrowKey (Left)
D-Pad (Left)
LS (Left)
D-Pad (Left)
LS (Left)
D-Pad (Left)
LS (Left)
Key_GamepadUp ArrowKey (Up)
D-Pad (Up)
LS (Up)
D-Pad (Up)
LS (Up)
D-Pad (Up)
LS (Up)
Key_GamepadRight ArrowKey (Right)
D-Pad (Right)
LS (Right)
D-Pad (Right)
LS (Right)
D-Pad (Right)
LS (Right)
Key_GamepadDown ArrowKey (Down)
D-Pad (Down)
LS (Down)
D-Pad (Down)
LS (Down)
D-Pad (Down)
LS (Down)
Key_GamepadAccept Space A ✕ A
Key_GamepadCancel Esc B ◯ B
Key_GamepadMenu   Menu Options +
Key_GamepadView   View Create -
Key_GamepadPageUp PageUp LT L2 ZL
Key_GamepadPageDown PageDown RT R2 ZR
Key_GamepadPageLeft   LB L1 L
Key_GamepadPageRight   RB R1 R
Key_GamepadContext1   X ◻ Y
Key_GamepadContext2   Y △ X
Key_GamepadContext3   LS (Press) LS (Press) / L3 LS (Press) / L3
Key_GamepadContext4   RS (Press) RS (Press) / R3 RS (Press) / R3

For a full technical overview of features, refer to 📘 Input Management.

 
© 2017 Noesis Technologies