Enhanced Object Navigation.

• Author: Emil-18.
• NVDA compatibility: 2023.1 and beyond.
• Download: Stable version.

This addon adds improvements to object navigation. Note that as of now, it doesn't work in java applications.

Navigation mode.

To enter navigation mode, press NVDA+shift+control+space. This will turn navigation mode on or off until the focus is moved. Press it twice to save the current state. When navigation mode is turned on in this way, it will automaticly be turned on when focus moves, unless the focus lands in an editable control, a menu, a document that supports browse mode, or a virtual control created by NVDA, such as an OCR result document. In these cases, it will be turned off. If you landed in an editable control or a menu, you can turn it back on by pressing escape.

Navigation mode can be turned on in any application.

Note:

All navigation commands described below will only navigate to objects in the same process that the navigator object is located in, unless stated otherwise.

They will also navigate to objects regardless of hierarchy, unless stated otherwise.

Basic navigation mode commands.

• Left and right arrow: move the navigator object to the previous and next object.
• Up and down arrow: move the navigator object to the previous and next object depending on the rotor setting.
• Page up and down: move to the next/previous rotor setting.
• Space: interact with the control where the navigator object is located. This can include pressing a button, checking a check box, or setting focus to an edit field so you can start typing.
• Enter, applications key, shift+f10: set focus to the navigator object, and then send the pressed key through to the application.

Advanced navigation.

To turn advanced navigation on, press NVDA+A while you are in navigation mode. NVDA will remember the state of the advanced navigation mode between sessions.

When advanced navigation is turned on, The arrow keys will move you around in the same way as normal object navigation. The "Simple review mode" setting will affect what you can navigate to. When using these commands, you can navigate outside of the current process. When advanced navigation is turned on, the rotor is not available, but all other commands works as normal, except for the arrow keys as described above.

single letter navigation.

When navigation mode is turned on, you can use single letter navigation, like in browse mode, to jump to different types of objects.

The following single letter navigation keys are supported at this time. Press the key on its own to jump to the next object, add shift to jump to the previous object, and add shift and control to list up all objects.

• b: button.
• c: combo box.
• d: document.
• e: edit controls.
• f: form field.
• g: graphic.
• h: heading (only supported in edge).
• i: list item.
• j: focusable control.
• k: link.
• l: list.
• m: menu, menu bar or menu item.
• n: landmark.
• o: tool bar.
• p: text.
• q: tab or tab item.
• r: radio button.
• s: same item.
• t: table.
• u: group.
• v: tree or tree item.
• w: control (areas that can be redefined with the Enhanced control support add-on).
• x: check box.
• z: status bar.

All of these are available in the rotor as well.

The search list.

The search list is a virtual list that contains the objects you have listed up, for example by pressing control+shift+b while in navigation mode to list buttons. To list objects regardless of role, press NVDA+control+enter. This command is available even when navigation mode is turned off. Since the list is virtual, you can do things such as list all the objects in a menu, without the menu closing, because the system focus is not moved.

When you are in the list, you can start typing to filter the list. Hold down left alt and type a character to move to the next object starting with that character.

You can use the following commands while in the list.

• enter: move the navigator object to the selected item and close the search list.
• backspace or delete: remove the search text and return all items to the list.
• up and down arrow: move to the next or previous item.
• left and right arrow: move to the next or previous item starting with a different character.
• Home and end: move to the beginning and end of the list.
• shift+backspace or shift+delete: reset the searchText. This will keep the list in its current state, but removes the search text, so you can start a new search.
• escape: exit the search list and return the focus and the navigator object to where they were before you opened the list.

Enhanced touch support.

A new touch mode has been added, called navigation. This is not complete yet. The gestures for this mode are as follows.

• 1 finger flick up/down: move to the next/previous object depending on the rotor setting.
• 2 finger flick write/left: move to the next/previous rotor setting.
• 3 finger flick right/left: press tab/shift+tab.
• 3 finger flick up/down: press f6/shift+f6.
• 2 finger flick up: press escape.
• 2 finger tripple tap: list all objects in the window where the navigator object is located.

Settings.

• Use navigation mode by default. This setting determines if navigation mode should be turned on when focus moves, same as pressing NVDA+shift+control+space twice.
• When searching, sort the items in tab order instead of alphabetically. When turned on, The search list will be sorted in tab order instead of alphabeticly.
• Search scope. This is a combo box that allows you to choose the scope when searching for objects. You can as of now choose between 3 options.
  • The foreground window.
  • All objects in the operating system.
  • The current control that the navigator object is in, e.g a list or a web page.
• Use enhanced detection while searching for same item. When checked, the s single letter navigation key will include only objects that are programmaticly the same, instead of all objects with the same role.
• Report object context while navigating in the search list. When checked, NVDA will report objects contaning the object you landed in when navigating in the list if it differes from the previous object, like NVDA does normaly when you move focus.
• Set focus to the item selected in the search list. When checked, NVDA will try to automaticly set focus to the object, in addition to move the navigator object to it, when pressing enter in the search list.
• Activate the item selected in the search list. When checked, NVDA will automaticly perform the default action on the object selected in the search list.
• When in navigation mode or in the search list, automatically update the braille display when the content of the shown object changes. Disable if you incounter problems using the add-on, such as lag. Self explanatory.
• When in the search list and holding down left alt, use first letter navigation. When checked, You can hold down left alt while you are in the search list and press characters to move to the next item starting with that character.
• Use sounds to indicate if navigation mode has been toggled. Self explanatory.

Change log.

v0.1.1

• The gestures in the search list should now work everywhere
• You should be able to use navigation mode in more situations

v0.1.

Initial release.