DeveloperToolkit (Инструменты разработчика)

Developer toolkit (DTK) — это дополнение для NVDA, которое помогает незрячим и слабовидящим разработчикам самостоятельно создавать визуально привлекательные пользовательские интерфейсы и веб-контент.
Оно предоставляет жесты, которые позволяют вам перемещаться по объектам и получать информацию о них, такую как их размер, положение и характеристики.
Чтобы начать использовать DTK, установите фокус на элемент управления, затем нажмите ALT+WINDOWS+K.
Чтобы отключить его, снова нажмите ALT+WINDOWS+K.
При работе в вебе нажмите NVDA+ПРОБЕЛ, чтобы перевести NVDA в режим фокуса, и нажмите NVDA+SHIFT+ПРОБЕЛ, чтобы отключить навигацию по одной букве.

Жесты

Следующие жесты доступны, когда DTK включен.

• ALT+WINDOWS+K — Включить или отключить функции DTK.
• СТРЕЛКА ВЛЕВО — Перейти к предыдущему соседнему элементу (sibling).
• СТРЕЛКА ВПРАВО — Перейти к следующему соседнему элементу (sibling).
• СТРЕЛКА ВВЕРХ — Перейти к родительскому элементу (parent).
• СТРЕЛКА ВНИЗ — Перейти к первому дочернему элементу (child).
• CTRL+HOME — Перейти к самому верхнему родительскому элементу.
• HOME — Перейти к относительному родительскому элементу, если он назначен.
• A — В веб-контенте озвучить HTML-атрибуты. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• B — Озвучить положение нижнего края объекта. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• SHIFT+B — Озвучить расстояние между нижним краем объекта и нижним краем относительного родительского элемента. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• C — Озвучить количество дочерних элементов внутри объекта. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• control+c — Переключиться между значениями цветов RGB, Hex и Name.
• CTRL+D — Включить или отключить подробные сообщения.
• F — В веб-контенте озвучивает информацию о шрифте и форматировании объекта. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• H — Озвучить высоту объекта. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• L — Озвучить положение левого края объекта. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• n — Озвучить имя объекта. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• CTRL+P — Установить относительный родительский элемент для получения размера/местоположения объектов.
• P — Озвучить имя относительного родительского элемента. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• R — Озвучить положение правого края объекта. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• SHIFT+R — Озвучить расстояние между правым краем объекта и правым краем относительного родительского элемента. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• ALT+R — Озвучить Роль/тип элемента управления объекта. Быстро нажмите дважды, чтобы скопировать это в буфер обмена.
• S — Озвучить количество соседних элементов (siblings) относительно объекта. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• SHIFT+S — Озвучить состояния элемента управления объекта. Быстро нажмите дважды, чтобы скопировать это в буфер обмена.
• T — Озвучить положение верхнего края объекта. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• V — Озвучить версию Developer toolkit. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• W — Озвучить ширину объекта. Быстро нажмите дважды, чтобы скопировать в буфер обмена.

Примечания

• При использовании клавиши Home или любой ее модифицированной версии использование клавиши Home на цифровой клавиатуре не работает, потому что NVDA отправляет нажатие клавиши Numpad7 вместо NumpadHome. Другие дополнения для клавиатуры, которые пытаются переназначить Numpad7 на клавишу Home, не будут работать в этом дополнении.
• При использовании функции относительного родительского элемента DTK установит относительного родителя на рабочий стол при следующих условиях.
  • Фокусируемый объект и относительный родитель совпадают.
  • Относительный родитель не является прямым предком фокусируемого объекта.
• DTK не может получить доступ к такой информации, как правила CSS, отступы (padding), границы (borders) или z-index. Для этого требуется доступ к ним вне контекста NVDA, что представляет проблему безопасности для пользователей.

Известные проблемы

• Настраиваемый список атрибутов шрифта, найденный в настройках Developer toolkit, может быть неудобен в использовании. Это ограничение библиотеки пользовательского интерфейса NVDA.

История версий

25.1.8

• Изменен манифест для совместимости с NVDA 2025.1.
• Это не официальный выпуск.

24.1.5

• Изменен манифест для совместимости с NVDA 2024.1.
• Обновлен русский перевод.
• Это не официальный выпуск.

22.1.5

• Новая схема нумерации версий xx.yy.zz, где xx = основная версия NVDA, yy = дополнительная версия NVDA, а zz = номер редакции Developer toolkit (месяц текущего года).
• Обновлено для работы с NVDA 2022.1 и новее.
• Более старые версии NVDA до 2022.1 больше не поддерживаются.

20.06

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

20.05

• Обновлено для работы с текущими версиями NVDA.

20.04

• Добавлен жест (Home), который дает возможность перейти к определенному относительному родительскому элементу.

20.03

• Добавлен жест (ALT+R), который получает тип элемента управления текущего объекта в фокусе. Примеры включают button, listitem, list, checkbox и section.
• Добавлен жест (SHIFT+S), который получает состояния элемента управления текущего объекта в фокусе. Примеры включают focused, focusable, selected, checked, pressed и readonly.
• Удалена поддержка уникального ID IAccessible, так как он ненадежен в большинстве контекстов.
• Сокращен номер версии до xx.yy, где xx — последние две цифры текущего года, а yy — номер обновления за текущий год. Таким образом, 20.03 — это третье крупное обновление в 2020 году.

2020.2

• Запуск DTK сохраняет текущее положение курсора в веб-контенте. Если объект под курсором не может получить фокус, DTK установит фокус на первого доступного предка.
• Удалена устаревшая поддержка Unicode-строк.
• Удалена настройка включения/отключения функций Developer toolkit из диалога настроек Developer toolkit, который находится в меню NVDA>Параметры>Настройки. Пользователи по-прежнему могут включать/отключать функции, нажимая alt+windows+k.
• Атрибуты форматирования, получаемые нажатием ‘f’ при включенном Developer toolkit, теперь можно настраивать в Параметры>Настройки>Developer toolkit.
  • Добавьте новые атрибуты форматирования, нажав кнопку ’new attribute’. Введите имя действительного атрибута форматирования, нажмите Tab, чтобы поместить его в список, затем нажмите Escape, чтобы выйти из режима редактирования.
  • Удалите атрибут, выбрав его в списке и нажав кнопку ‘delete attribute’.
  • Переименуйте атрибут, нажав кнопку ‘Rename attribute’, введя новое имя, нажав Tab, чтобы поместить его в список, затем нажав Escape, чтобы выйти из режима редактирования.
  • Переместите атрибут вверх по списку, выбрав его и нажав кнопку ‘Move up’. Повторяйте это, пока он не достигнет нужного места в списке.
  • Переместите атрибут вниз по списку, выбрав его и нажав кнопку ‘Move down’. Повторяйте это, пока он не достигнет нужного места в списке.
• Пользователи теперь имеют возможность изменить способ отображения значений цветов при получении информации о форматировании. Настройка находится в Параметры>Настройки>Developer toolkit, затем выберите формат отображения цвета. Формат отображения цвета также можно изменить, нажав control+c при включенных функциях Developer toolkit.
  • RGB — значение Красный/Зеленый/Синий. Определяет цвет через комбинацию красного, зеленого и синего цветов. Хорошо подходит для графического искусства, особенно для цветов, не входящих в веб-палитру.
  • Hex — строка, начинающаяся с ‘#’ и followed by 6 characters состоящая из 1-0 и A-F. Обычно хорошо подходит для веб-контента.
  • Name — Человекочитаемое значение цвета. Хорошо подходит для общего использования и проверки других форматов значений цветов.

2020.1.1

• Улучшена поддержка Unicode.

2020.1.0

• Разработчики теперь имеют возможность фокусироваться на меньших областях своих пользовательских интерфейсов, нажимая CTRL+p, чтобы установить относительного родителя. Используйте относительного родителя в качестве точки отсчета при получении информации о размере и местоположении. Чтобы использовать эту функцию, включите функции DTK, перейдите к объекту, который хотите использовать в качестве относительного родителя, затем нажмите CTRL+p. Затем вернитесь к своей работе как обычно.
• Нажмите букву p при работе в DTK, чтобы получить имя относительного родительского элемента. Быстро нажмите дважды, чтобы скопировать в буфер обмена.
• Используйте SHIFT+b, чтобы получить расстояние между нижним краем фокусируемого объекта и нижним краем относительного родительского элемента. Функции DTK должны быть включены, чтобы использовать эту функцию.
• Используйте SHIFT+r, чтобы получить расстояние между правым краем фокусируемого объекта и правым краем относительного родительского элемента. Функции DTK должны быть включены, чтобы использовать эту функцию.
• DTK теперь корректно обрабатывает переключения профилей конфигурации.
• Удалено ‘-preview’ из номера версии, чтобы избежать проблем с номером версии в обновлении дополнений.

2020.0 preview

• Изменен номер версии на 2020.0 preview, чтобы отразить предстоящий переход на Python 3.
• Добавлена совместимость с Python 3.
• Добавлен новый жест “n”, который озвучивает имя объекта. Если оно не назначено, озвучивает слово ’None’ как имя объекта.
• DTK больше не добавляет повторяющиеся панели настроек в окне настроек NVDA при перезагрузке дополнений.

2019.1.2

• DTK теперь будет сообщать значения размера и положения, даже если они равны 0.
• Навигация теперь учитывает настройку подробных сообщений.
• Сделана более лаконичной отчетность информации о размере/положении.
• Улучшения стабильности.

2019.1.1

• DTK больше не будет пытаться загружаться multiple times при объявлении номера версии.
• Функции DTK будут отключены при установке. Ранее функции DTK были включены при установке. Это отличается от включения или отключения дополнения в окне Сервис NVDA>Управление дополнениями.
• Сообщения, представляемые пользователю, теперь могут содержать non-ASCII символы.
• Нажатие жестов, таких как a, b, c, f, h, l, r, s, t, v и w, больше не прерывает речь NVDA при копировании в буфер обмена.

2019.1

• Исправлена проблема совместимости, при которой DTK объявлял минимальную версию NVDA, которая еще не была выпущена.

2019.0 (initial stable release)

• Первоначальная сборка с базовой навигацией.