EnhancedObjectNavigation (Улучшенная навигация по объектам)

• Автор: Emil-18.
• Совместимость с NVDA: 2024.1 и новее.
• Скачать: Стабильная версия.

Это дополнение улучшает навигацию по объектам. Прочтите это, если вы не знаете, что такое навигация по объектам или как её использовать. Дополнение добавляет следующее:

• Режим навигации, который позволяет использовать клавиши со стрелками для перемещения объекта навигатора между объектами. Вы также можете использовать команды быстрой навигации (b для кнопки, x для флажка и т.д.), чтобы переместить объект навигатора к следующему/предыдущему объекту указанного типа.
• Возможность выводить список объектов, искать нужный объект и перемещаться к нему напрямую.
• Улучшенная поддержка сенсорного ввода.

Все эти возможности зависят от настройки «Простой режим обзора» (Simple review mode), поэтому, когда эта настройка выключена, вы сможете находить больше объектов, которые не обязательно актуальны для обычного пользователя.

Режим навигации.

Чтобы включить режим навигации, нажмите NVDA+Shift+Ctrl+Пробел. Режим навигации можно включить в любом приложении.

Примечание:

Все описанные ниже команды навигации будут перемещать только к объектам в том же процессе, в котором находится объект навигатора, если не указано иное.

Они также будут перемещаться к объектам независимо от иерархии, если не указано иное.

Основные команды режима навигации.

• Стрелка влево и вправо: переместить объект навигатора к предыдущему и следующему объекту.
• Стрелка вверх и вниз: переместить объект навигатора к предыдущему и следующему объекту в зависимости от настройки ротора (rotor).
• Page Up и Page Down: перейти к следующей/предыдущей настройке ротора.
• Пробел: взаимодействовать с элементом управления, в котором находится объект навигатора. Это может включать нажатие кнопки, установку флажка или установку фокуса на поле редактирования, чтобы начать ввод текста.
• Enter, Applications (Menu), Shift+F10: установить фокус на объект навигатора, а затем передать нажатую клавишу приложению.

Расширенная навигация.

Чтобы включить или выключить расширенную навигацию, нажмите NVDA+A, находясь в режиме навигации. NVDA будет запоминать состояние режима расширенной навигации между сеансами.

Когда расширенная навигация включена, клавиши со стрелками будут перемещать вас так же, как и обычная навигация по объектам, например, стрелка вверх для перехода к объекту, содержащему объект навигатора, стрелки влево и вправо для перехода к предыдущему/следующему объекту, а стрелка вниз — к первому объекту внутри объекта навигатора. При использовании этих команд вы можете выйти за пределы текущего процесса. Когда расширенная навигация включена, ротор недоступен, но все остальные команды работают как обычно, за исключением клавиш со стрелками, как описано выше.

Навигация по одной букве.

Когда включен режим навигации, вы можете использовать навигацию по одной букве, как в режиме просмотра, для перехода к объектам разных типов.

На данный момент поддерживаются следующие клавиши навигации по одной букве. Нажмите клавишу отдельно, чтобы перейти к следующему объекту; добавьте Shift, чтобы перейти к предыдущему объекту; добавьте Shift и Ctrl, чтобы вывести список всех объектов.

• b: кнопка (button).
• c: раскрывающийся список (combo box).
• d: документ (document).
• e: поле редактирования (edit control).
• f: поле формы (form field).
• g: изображение (graphic).
• h: заголовок (heading).
• 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: элемент управления (areas that can be redefined with the Enhanced control support add-on).
• x: флажок (check box).
• y: фокусируемое поле формы (focusable form field).
• z: строка состояния (status bar).

Все они также доступны в роторе.

Режим навигации с использованием UIA vs без UIA

По умолчанию это дополнение использует UI Automation при навигации в режиме навигации. Это делает её быстрее, и она будет работать в местах, где обычная навигация по объектам NVDA имеет проблемы, однако у этого есть некоторые побочные эффекты.

• Некоторые объекты могут распознаваться странным образом, например, текст в приложениях Mozilla может распознаваться как поля редактирования, а во многих ситуациях заголовки не будут распознаваться.
• Не будут распознаваться объекты, которые NVDA (либо в ядре, либо через другие дополнения) настроила особым образом. Например, если объект обычно появляется для программ чтения с экрана как панель, но NVDA настроена обрабатывать его как поле редактирования, в режиме навигации при использовании UI Automation он будет обрабатываться как панель.

Вы можете настроить дополнение так, чтобы оно явно не использовало UI Automation в режиме навигации. Когда вы это сделаете, дополнение будет перемещаться по объектам так, как NVDA видит их обычно, и вы не столкнетесь ни с одним из перечисленных выше побочных эффектов.

Список поиска.

Список поиска позволяет отображать объекты в виде списка, искать нужный объект и перемещаться к нему напрямую. Вы можете выбрать: вывести все объекты в текущем окне, все объекты в текущем документе режима просмотра или все объекты в операционной системе. Независимо от этого, вы можете выбрать: вывести все типы объектов или только тип, связанный с определённым символом, например, вы можете нажать Ctrl+Shift+B в режиме навигации, чтобы вывести только кнопки. Чтобы вывести объекты независимо от их роли, нажмите NVDA+Ctrl+Enter. Эта команда доступна даже когда режим навигации выключен. Вы также можете нажать NVDA+Shift+F7 в любом месте, а затем нажать клавишу навигации, например, b для кнопок, чтобы вывести только кнопки.

Виртуальный список поиска.

По умолчанию дополнение использует виртуальный список для отображения объектов. Это означает, что когда вы открываете список и перемещаетесь по нему, ничего не отображается на экране, и системный фокус не перемещается. Это имеет несколько преимуществ и недостатков.

Преимущества:

• Меньше время загрузки и отсутствие времени загрузки во время ввода текста в список, так как системе не нужно отображать элементы списка.
• Возможность использования в областях, которые исчезают при перемещении фокуса от них.
• Озвучивание фактического объекта, включая, при желании, объекты, внутри которых он находится, при перемещении по списку.

Недостатки:

• Не работает с диктовкой Windows (Windows dictation).
• Исчезает при перемещении фокуса от него.
• Плохо работает с сенсорным вводом.

Находясь в списке, вы можете начать ввод текста для фильтрации списка. Удерживайте левый Alt и введите символ, чтобы перейти к следующему объекту, начинающемуся с этого символа. В списке можно использовать следующие команды.

• Enter: перейти к выбранному элементу и закрыть список поиска.
• Backspace или Delete: удалить текст поиска и вернуть все элементы в список.
• Стрелка вверх и вниз: перейти к следующему или предыдущему элементу.
• Стрелка влево и вправо: перейти к следующему или предыдущему элементу, начинающемуся с другого символа.
• Home и End: перейти к началу или концу списка.
• Shift+Backspace или Shift+Delete: сбросить текст поиска. Это сохранит список в текущем состоянии, но удалит текст поиска, чтобы вы могли начать новый поиск. Например, вы можете ввести «NV», нажать эту команду, ввести «A», и появятся элементы, содержащие «NVDA».
• Escape: выйти из списка поиска и вернуть фокус и объект навигатора туда, где они были до открытия списка.

Физический список поиска.

Физический список поиска всегда используется в Java-приложениях, так как виртуальный список поиска в них не поддерживается. Вы также можете настроить дополнение на его использование везде.

Преимущества:

• Отображается визуально на экране и с ним можно взаимодействовать, как с любым другим приложением.

Недостатки:

• Требуется больше времени для поиска или отображения элементов.
• Не может использоваться в областях, которые исчезают при перемещении фокуса от них.

Элементы управления в физическом списке поиска.

• Поле редактирования «Фильтр по типу элемента управления» (Filter by control type): Это поле позволяет искать объекты, тип элемента управления которых начинается с вашего запроса. Например, если вы ищете «button», будут показаны все кнопки, а элементы управления, такие как переключатели (radio buttons), которые содержат, но не начинаются со слова «button», показаны не будут.
• Поле редактирования «Фильтр по имени» (Filter by name): Это поле позволяет искать объекты в списке по их имени.
• Список объектов (Objects list): Этот список содержит объекты, которые вы искали. Вы можете использовать навигацию по первой букве для быстрого перехода к элементу. Если вы нажмёте Пробел, находясь в списке, объект навигатора будет перемещён к объекту, представленному выбранным элементом списка, но список поиска не закроется.
• Кнопка «Переместить объект навигатора» (Move navigator object): Эта кнопка закрывает диалог и перемещает объект навигатора к объекту, представленному выбранным элементом списка, независимо от того, в каком режиме вы находились до открытия списка поиска.
• Кнопка «OK»: Это кнопка по умолчанию, активируемая нажатием Enter. Это переместит активный курсор к объекту, представленному выбранным элементом списка, так же, как нажатие Enter в виртуальном списке поиска.

Что происходит при нажатии Enter в списке поиска?

Список закроется, и:

• Если вы находились в режиме навигации до открытия списка поиска, объект навигатора будет перемещён к объекту, представленному текущим элементом списка.
• Если объект, представленный текущим элементом списка, находится в документе режима просмотра и для этого документа включён режим просмотра, курсор режима просмотра будет перемещён.
• В противном случае фокус будет перемещён. Если фокус не может быть перемещён, вместо этого будет перемещён объект навигатора.

Улучшенная поддержка сенсорного ввода.

Добавлен новый сенсорный режим под названием «навигация» (navigation). Он ещё не завершён. Жесты для этого режима следующие:

• Проведите одним пальцем вверх/вниз: перейти к следующему/предыдущему объекту в зависимости от настройки ротора.
• Проведите двумя пальцами вправо/влево: перейти к следующей/предыдущей настройке ротора.
• Проведите тремя пальцами вправо/влево: нажать Tab/Shift+Tab.
• Проведите тремя пальцами вверх/вниз: нажать F6/Shift+F6.
• Проведите двумя пальцами вверх: нажать Escape.
• Тройное касание двумя пальцами: вывести список всех объектов в окне, где находится объект навигатора.

Настройки.

• Использовать режим навигации по умолчанию (Use navigation mode by default). Эта настройка определяет, должен ли режим навигации быть включен по умолчанию, аналогично нажатию NVDA+Shift+Ctrl+Пробел.
• При поиске сортировать элементы в порядке табуляции, а не по алфавиту (When searching, sort the items in tab order instead of alphabetically). Если включено, список поиска будет отсортирован в порядке табуляции, а не по алфавиту.
• Область поиска (Search scope). Это раскрывающийся список, который позволяет выбрать область при поиске объектов. На данный момент можно выбрать из трёх вариантов.
  • Активное окно (The foreground window).
  • Все объекты в операционной системе (All objects in the operating system).
  • Текущий документ режима просмотра, в котором находится объект навигатора (The current browse mode document that the navigator object is in).
• Использовать улучшенное обнаружение при поиске объектов того же типа (Use enhanced detection while searching for same item). Если отмечено, клавиша навигации s будет включать только объекты, которые программно идентичны, вместо всех объектов с той же ролью.
• Использовать UI Automation в режиме навигации, когда это возможно (Use UI automation in navigation mode when available). См. раздел «Режим навигации с использованием UIA vs без UIA».
• Отключить асинхронную навигацию, полезно, если вы сталкиваетесь с проблемами при навигации, такими как отсутствие речи NVDA или воспроизведение звуков ошибок (disable asynchronous navigation, useful if you encounter problems while navigating, such as NVDA becoming silent or playing error sounds). Когда эта опция не отмечена, и когда вы ищете такие элементы, как кнопки, в режиме навигации, NVDA не будет зависать во время поиска. Применяется только когда включена настройка «Use UI automation in navigation mode when available». Если она не включена, эта опция считается отмеченной.
• Использовать виртуальный список при выводе объектов (не работает в Java-приложениях) (Use a virtual list when listing up objects (does not work in Java applications)). См. раздел «Список поиска».
• Настройки для виртуального списка поиска:
  • Озвучивать контекст объекта при навигации в списке поиска (Report object context while navigating in the search list). Если отмечено, NVDA будет озвучивать объекты, содержащие объект, на который вы перешли при навигации по списку, если он отличается от предыдущего объекта, как NVDA делает обычно при перемещении фокуса.
  • В списке поиска при удерживании левого Alt использовать навигацию по первой букве (When in the search list and holding down left alt, use first letter navigation). Если отмечено, вы можете удерживать левый Alt в списке поиска и нажимать символы для перехода к следующему элементу, начинающемуся с этого символа.
• Настройки для физического списка поиска:
  • Использовать UI Automation при выводе объектов (как в виртуальном списке поиска) (Use UI automation when listing objects (same as in the virtual search list)).
  • Использовать регулярные выражения при поиске (Use Regular expressions when searching). Если отмечено, для поиска по имени объектов можно использовать регулярные выражения.
• В режиме навигации или в списке поиска автоматически обновлять брайлевский дисплей при изменении содержимого отображаемого объекта (When in navigation mode or in the search list, automatically update the braille display when the content of the shown object changes). Отключите, если вы столкнулись с проблемами при использовании дополнения, такими как задержки (lag). Самоочевидно.
• Использовать звуки для индикации включения/выключения режима навигации (Use sounds to indicate if navigation mode has been toggled). Самоочевидно.

Перевод

• Валентин Куприянов: Русский язык

Журнал изменений.

v0.3.1

• Добавлена ​​совместимость с NVDA 2026.1.

v0.3

• Добавлен опциональный физический список поиска.
• Добавлена поддержка Java-приложений.
• Добавлена возможность не использовать UI Automation при навигации в режиме навигации.
• Дополнение теперь учитывает настройку «Простой режим обзора» (simple review mode).
• При нажатии Пробела на поле редактирования дополнение автоматически перейдёт в режим форм (forms mode). Вам больше не нужно нажимать Пробел дважды.

v0.2.2

• Добавлена совместимость с NVDA 2025.1.

v0.2

• Удалена концепция сохранения режима навигации. Теперь он будет автоматически сохраняться при нажатии жеста один раз.
• Режим навигации больше не будет автоматически выключаться при перемещении фокуса, за исключением случая, когда фокус попадает в документ режима просмотра, для которого включён режим просмотра. Для входа в режим форм необходимо нажать Пробел на редактируемом элементе управления: один раз, если элемент управления имеет фокус, и дважды в противном случае.
• При нажатии Enter на элемент в списке поиска будет перемещён активный курсор. Если активен режим навигации, будет перемещён объект навигатора. Если объект, представленный текущим элементом, находится в документе режима просмотра и для него включён режим просмотра, будет перемещён курсор режима просмотра. В противном случае перемещается фокус. Если фокус не может быть перемещён, вместо этого перемещается объект навигатора.
• Исправлена ошибка, из-за которой NVDA иногда аварийно завершала работу при выходе или перезапуске.
• Сделана асинхронной функция поиска следующего и предыдущего объекта в режиме навигации.
• Добавлена новая клавиша быстрой навигации y для фокусируемых полей формы.
• Удалены настройки «Set focus to the item selected in the search list» и «Activate the item selected in the search list».

v0.1.1

• Жесты в списке поиска теперь должны работать везде.
• Режим навигации теперь должен работать в большем количестве ситуаций.

v0.1.

Первоначальный выпуск.