ContextGestures (Контекстнозависимый список жестов)

## Введение

Дополнение Context Gestures предназначено для помощи в изучении горячих клавиш (жестов) NVDA. Оно позволяет просматривать список всех команд, доступных в текущем контексте, в удобном формате. Вместо того чтобы угадывать, какая клавиша что делает, или просматривать обширный диалог «Жесты ввода», это дополнение показывает именно те команды, которые активны здесь и сейчас.

Основная функция дополнения — это «слой помощи». Активировав этот слой специальной комбинацией клавиш, вы можете нажать цифровые клавиши 1, 2 или 3, чтобы открыть подробный HTML-отчет о командах.

Активация слоя помощи

Работа с дополнением построена на использовании временного режима (слоя). Чтобы его активировать:

1. Нажмите сочетание клавиш NVDA+H.
2. Вы услышите короткий высокий звуковой сигнал и сообщение «Слой вкл».

Теперь слой активен, и следующие команды (цифры 1, 2, 3) будут обрабатываться не как обычно, а как запросы на создание отчетов.

• Если вы случайно активировали слой и не хотите ничего нажимать, просто нажмите NVDA+H еще раз. Вы услышите низкий звуковой сигнал и сообщение «Слой выкл», что вернет клавиатуру в обычный режим.
• Если во время активного слоя вы нажмете любую другую клавишу, кроме 1, 2 или 3, слой автоматически деактивируется, и эта клавиша будет отправлена в активное приложение для обычной обработки.

Команды слоя и создаваемые отчеты

Когда слой активирован (вы слышите «Слой вкл»), у вас есть три варианта действий.

Просмотр команд текущего контекста (Цифра 1)

Нажмите клавишу 1, находясь в любом окне или элементе.

Дополнение соберет и покажет вам команды, относящиеся строго к текущему объекту. В этот список войдут:

• Скрипты, принадлежащие самому объекту (например, команды для конкретного типа элемента управления, такого как список, поле ввода или кнопка).
• Скрипты из модуля приложения (appModule), которое управляет текущей программой. Это команды, специфичные для данного приложения.
• Скрипты из перехватчика дерева (tree interceptor), если он активен (например, в режиме навигации браузера или документа Adobe Reader).
• Общие команды NVDA из модуля globalCommands (например, основные команды чтения, настройки голоса и т.д.).

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

Просмотр команд, связанных с процессом (Цифра 2)

Нажмите клавишу 2.

Эта функция отфильтровывает и показывает только те команды, которые имеют отношение к текущей запущенной программе (процессу). Сюда относятся:

• Скрипты из основного модуля приложения (appModule).
• Скрипты, найденные в папке appModules для данного процесса.
• Скрипты из глобальных плагинов (globalPlugins), в названии которых встречается имя текущего процесса (например, плагин, написанный специально для Notepad++).

Этот режим удобен, когда вам нужно изучить все дополнительные жесты, которые NVDA добавляет для работы в конкретной программе.

Просмотр всех доступных команд (Цифра 3)

Нажмите клавишу 3.

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

Формат отчета

Каждый из трех отчетов открывается в новом окне в виде HTML-страницы, которую можно читать с помощью NVDA, как обычный документ. Отчет имеет следующую структуру:

• Заголовок отчета.
• Список категорий жестов (например, «Работа с текстом», «Навигация по объектам», «Параметры NVDA»).
• Внутри каждой категории — таблица с двумя колонками:
  • Команда: Понятное название действия (например, «Произнести всё», «Переключение синтезаторов»).
  • Жест: Назначенная комбинация клавиш (например, NVDA+Стрелка вниз, NVDA+Ctrl+S). Если у команды несколько жестов, они будут перечислены через вертикальную черту (|). Если жест не назначен, будет указано «Не назначено».

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

Пример использования

1. Откройте веб-браузер и перейдите на любую страницу.
2. Активируйте режим навигации (если он не включен), нажав NVDA+Пробел.
3. Активируйте слой помощи (NVDA+H).
4. Нажмите 1.
5. Перед вами откроется отчет, в котором вы увидите категорию «Режим навигации», а внутри нее — все команды для навигации по странице: переход по заголовкам, ссылкам, элементам форм и т.д., а также назначенные для них клавиши.
6. Закройте отчет, вернитесь к браузеру и, не активируя слой, попробуйте применить одну из найденных команд.