* Добавлена поддержка NVDA 2026.1
    * Добавлены украинский, русский, немецкий и турецкий переводы.
    * Улучшена идентификация элементов управления с использованием исходного имени элемента управления.
    * Исправлена проблема с работой меток в веб-приложениях (Electron, WebView2).
    * Исправлена проблема, из-за которой в некоторых приложениях все кнопки получали одинаковую метку.
    * Добавлена поддержка установки меток для редактируемого текста.
    * Добавлена опция озвучивания описания для неподписанных элементов управления, что значительно улучшает доступность в приложениях на Java (Настройки > Пользовательские метки).

Custom Labels (Пользовательские метки)

• Автор: Kefas Lungu

Примечание: это дополнение требует NVDA 2025.1 или более новой версии.

Обзор

Custom Labels (Пользовательские метки) — это дополнение для NVDA, которое позволяет добавлять собственные метки для неподписанных элементов управления и редактировать существующие. Это особенно полезно для приложений, в которых кнопки или элементы управления не имеют подписей или NVDA не может их правильно идентифицировать.

Возможности

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

Поддерживаемые типы элементов управления

Для следующих типов элементов управления можно устанавливать метки:

• Кнопки
• Кнопки меню
• Переключаемые кнопки (Toggle buttons)
• Флажки
• Переключатели (Radio buttons)
• Поля со списком (Combo boxes)
• Ползунки
• Вкладки
• Пункты меню
• Редактируемый текст

Жесты

• NVDA+Control+L: Установить или изменить пользовательскую метку для текущего элемента управления.
• NVDA+Control+Delete: Удалить пользовательскую метку с текущего элемента управления.
• NVDA+Control+J: Проверить, есть ли у текущего элемента управления пользовательская метка.
• NVDA+Control+; (точка с запятой): Открыть настройки пользовательских меток.

Использование

Установка пользовательской метки

1. Перейдите на элемент управления, который хотите подписать.
2. Нажмите NVDA+Control+L.
3. Появится диалоговое окно с информацией об элементе управления.
4. Введите желаемую метку в текстовое поле.
5. Нажмите OK, чтобы сохранить метку.

Редактирование существующей метки

1. Перейдите на элемент управления, для которого установлена пользовательская метка.
2. Нажмите NVDA+Control+L.
3. Измените метку в текстовом поле.
4. Нажмите OK, чтобы сохранить изменения.

Удаление метки

Удалить метку можно двумя способами:

1. Перейдите на элемент управления и нажмите NVDA+Control+Delete.
2. Или откройте диалог установки метки (NVDA+Control+L) и нажмите кнопку «Удалить».

Управление всеми метками

1. Нажмите NVDA+Control+; чтобы открыть панель настроек «Пользовательские метки».
2. Просматривайте метки, сгруппированные по приложениям.
3. Используйте кнопки «Изменить», «Удалить», «Удалить приложение» или «Удалить всё» по мере необходимости.

Панель настроек

Панель настроек «Пользовательские метки» можно открыть следующими способами:

• С помощью сочетания клавиш NVDA+Control+;
• Меню NVDA > Параметры > Настройки > Пользовательские метки

На панели отображаются все пользовательские метки, организованные в виде дерева по приложениям. Вы можете:

• Изменить: изменить выбранную метку.
• Удалить: удалить выбранную метку.
• Удалить приложение: удалить все метки для выбранного приложения.
• Удалить всё: удалить все пользовательские метки.

Кроме того, есть настройка, которая позволяет использовать описание элемента управления в качестве его метки, если у элемента управления нет метки. Но обратите внимание: если установлена пользовательская метка, она будет иметь приоритет над описанием, а также над исходной меткой элемента управления.

Хранение

Метки хранятся в JSON-файлах в каталоге конфигурации NVDA в папке customLabels. Для каждого приложения создается отдельный JSON-файл, что упрощает резервное копирование или обмен метками для конкретных приложений.

Известные ограничения

• Веб-приложения: Для приложений, созданных на основе веб-технологий (таких как новая Outlook, Microsoft Teams, Slack, TeamViewer, WhatsApp, Discord и другие приложения Electron/WebView2), пользовательские метки работают только в режиме фокуса. Нажмите NVDA+Пробел, чтобы переключиться в режим фокуса перед использованием пользовательских меток в этих приложениях. Это связано с тем, как NVDA обрабатывает режим обзора с использованием виртуального буфера, который не использует те же «живые» объекты, на которые полагаются пользовательские метки.
• Элементы управления с идентичными свойствами: Если в приложении есть несколько элементов управления одного типа с одинаковым именем (или без имени), иногда пользовательские метки не могут их различить. Установка метки для одного из них приведет к тому, что метка применится ко всем совпадающим элементам управления. На практике это встречается редко, так как большинство приложений присваивают своим элементам управления уникальные идентификаторы.

Участники

• Leonardo Marenda (@LeonardoMarenda): Добавил итальянский перевод. (#1)
• Kostenkov-2021 (@Kostenkov-2021): Добавил русский файл README и локализацию. (#3)
• Umut KORKMAZ (umutkork@gmail.com): Добавил турецкий перевод.
• George-br (@George-br): Добавил украинский перевод. (#6)
• Brell Rainer (Rainer.Brell@bfw-wuerzburg.de): Добавил немецкий перевод.

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

Версия 2026.02

• Добавлена поддержка NVDA 2026.1.
• Добавлены украинский, русский, немецкий и турецкий переводы.
• Улучшена идентификация элементов управления с использованием исходного имени элемента управления.
• Исправлена проблема с работой меток в веб-приложениях (Electron, WebView2).
• Исправлена проблема, из-за которой в некоторых приложениях все кнопки получали одинаковую метку.
• Добавлена поддержка установки меток для редактируемого текста.
• Добавлена опция озвучивания описания для неподписанных элементов управления, что значительно улучшает доступность в приложениях на Java (Настройки > Пользовательские метки).
• Добавлена документация об известных ограничениях.

Версия 2026.0

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