HTML Element Inspector (Инспектор HTML-элементов)

Автор: Amir Soleimani
Совместимость с NVDA: 2026.1 и новее

HTML Element Inspector — это небольшой инструмент для инспектирования, вдохновлённый функцией «Информация об элементе» в JAWS. Он создаёт компактный семантический отчёт для текущего веб-элемента, находящегося в фокусе.

Сочетания клавиш

• NVDA + Shift + F1 — Инспектирование элемента в фокусе.
• Control + NVDA + Shift + F1 — Расширенный инспекторский отчёт (включает исследование дочерних элементов с навигацией по заголовкам).

Версия 1.1.0

• Добавлен расширенный инспекторский отчёт (Control + NVDA + Shift + F1) с деталями элемента в фокусе, контекстом ориентиров и опциональным исследованием дочерних элементов.
• Как базовый, так и расширенный отчёты поддерживают навигацию по заголовкам (H / Shift+H) для более быстрого структурного обзора.
• Улучшено сообщение доступного имени с консервативными подсказками об источнике и добавлено explicit-name-from, когда explicit-name=true, без угадывания ARIA-источников.
• Более чистый вывод за счёт исключения пустых свойств и уменьшения шума в родительских элементах.

Версия 1.1.1

• Улучшено отображение ссылок для элементов-якорей: когда целевой объект ссылки представлен как значение URL и отсутствует явный атрибут href, отчёт теперь показывает его как href=... (консервативное сопоставление для tag=a).
• Улучшена навигация в расширенном отчёте: каждый блок Tag X has Y parameters в разделе «Focused element» теперь отображается как заголовок уровня 3 для быстрой навигации между блоками тегов с помощью H / Shift+H.

Требования

• Используйте дополнение на веб-контенте, когда NVDA находится в режиме просмотра (виртуальный буфер).
• Это дополнение ничего не копирует в буфер обмена; оно только показывает отчёт.

Тестирование в браузерах

Это дополнение протестировано в основном с NVDA + Google Chrome. Совместимость с Firefox пока полностью не проверена.

Из чего строится отчёт

• Объектная модель NVDA (роль, состояния, имя/значение/описание, если доступно)
• Атрибуты IA2 / Web (тег, роль/xml-roles, ARIA-отношения, setsize/posinset и т.д.)
• Короткая цепочка родительских элементов для обеспечения контекста

Философия

• Семантика прежде всего: предпочтение значимым атрибутам, а не необработанному шуму.
• Консервативность: избегание небезопасных догадок (например, tabindex сообщается только когда он явно предоставлен, за исключением role="tab", где это помогает отладке паттернов «roving tabindex»).
• Читаемость: стабильное форматирование, которое легко сравнивать с другими инструментами.

Обратная связь и вклад

Приветствуются отзывы и вклад в улучшение этого дополнения.