Садовый альманахЗамечать, понимать, выращивать — в своём ритме
Корректировка питания после севооборота

Как проверить доступность элементов интерфейса после смены культуры (локали)

8 минут чтения
Содержание
  1. Почему доступность зависит от культуры
  2. Что именно проверять
  3. Инструменты для проверки
  4. Пошаговый порядок действий
  5. Типичные ошибки и как их избегать
  6. Сценарии для разных типов приложений
  7. FAQ
  8. Практический следующий шаг

Когда приложение меняет культуру (язык, региональные настройки), доступные свойства элементов интерфейса — такие как имя, описание, роль и подсказки — должны обновляться в соответствии с новой локалью. Если этого не происходит, пользователи с ограниченными возможностями могут столкнуться с непонятными или отсутствующими подсказками экранного диктора, что снижает удобство использования и может нарушать требования стандартов доступности (WCAG, Section 508, EN 301 549). Ниже описано, что именно проверять, какие инструменты применять и как организовать процесс проверки.

Почему доступность зависит от культуры

Доступные свойства часто формируются из локализованных строк ресурсов. При смене культуры:

  • Текстовое содержимое элементов (например, подписи кнопок) меняется на перевод из нового ресурсного файла.
  • Если доступное имя (accessible name) берётся из той же локализованной строки, оно также должно измениться.
  • В некоторых реализациях доступное имя задаётся явно в коде или разметке и не обновляется автоматически, что приводит к несоответствию между визуальным текстом и тем, что слышит пользователь экранного диктора.
  • Региональные настройки могут влиять на формат дат, чисел и единиц измерения, которые иногда выводятся в всплывающих подсказках или aria‑description.

Поэтому проверка доступности после смены культуры нужна, чтобы убедиться, что все доступные свойства синхронно обновляются и остаются понятными для пользователей assistive technologies.

Что именно проверять

Для каждого интерактивного элемента (кнопка, ссылка, поле ввода, переключатель, диалог и т.д.) следует оценить следующие аспекты:

  • Доступное имя (accessible name) – что объявляет экранный диктор при фокусе на элементе. Оно должно соответствовать визуальной подписи после смены культуры.
  • Доступное описание (accessible description) – дополнительная информация, например, подсказка или сообщение об ошибке, также должно быть локализовано.
  • Роль (role) – тип элемента (кнопка, флажок, список и т.д.) не меняется при смене культуры, но стоит убедиться, что роль правильно определена и не потерялась.
  • Состояние (state) – например, отмечен ли флажок, раскрыто ли меню; состояние должно оставаться корректным независимо от культуры.
  • Клавиатурная навигация – порядок фокусировки и возможность активации элемента клавиатурой не должны зависеть от языка.
  • Живые регионы (live regions) – если элемент объявляет динамические изменения (например, сообщение о валидации), текст объявления должен быть на текущей культуре.
  • Контраст и визуальное оформление – хотя контраст не зависит от языка, после смены культуры могут измениться размеры текста из‑за более длинных переводов, что иногда влияет на читаемость.

Инструменты для проверки

Для автоматизированного и ручного тестирования доступности после смены культуры можно использовать следующие категории инструментов:

  • Автоматические сканеры доступности – например, axe-core, Axe Browser Extension, pa11y, Lighthouse (в режиме accessibility). Они анализируют DOM и выдают сообщения о пропущенных или некорректных доступных свойствах.
  • Инспекторы UI Automation / Accessibility Insights – Microsoft Accessibility Insights for Windows, Android, Web; inspect.exe (Windows); UI Automation Viewer. Позволяют посмотреть реальные свойства accessibility tree (имя, роль, состояние) для каждого элемента.
  • Экранные дикторы – NVDA, JAWS, VoiceOver, TalkBack. Слушать, что объявляется при фокусе на элементе после смены культуры.
  • Инструменты локализации и псевдо‑локализации – псевдо‑локализация (добавление специальных символов к строкам) помогает быстро увидеть, используются ли локализованные строки в доступных именах.
  • Автотесты на базе фреймворков – интеграция проверок accessibility в unit/UI‑тесты (например, jest‑axe, cypress‑axe, selenium с axe‑selenium). Позволяют автоматически запускать проверки после каждого переключения культуры в тестовом сценарии.

Пошаговый порядок действий

  1. Подготовка тестового окружения
    • Убедитесь, что приложение может переключать культуру во время выполнения (например, через параметр запуска, настройку в UI или вызов CultureInfo.CurrentCulture в .NET).
    • Подготовьте набор тестовых культур, представляющих основные языки и региональные варианты, которые поддерживает продукт (как минимум один язык с правописанием слева‑направа и один справа‑налево, если применимо).
    • Переключение культуры
      • Измените культуру приложения выбранным способом.
      • Перезагрузите интерфейс (если требуется полная переинициализация ресурсов) – некоторые фреймворки обновляют строки только при повторном рендеринге.
      • Автоматический скан
        • Запустите выбранный сканер доступности (axe, Lighthouse и т.д.) на текущей странице или окне приложения.
        • Сохраните отчет; обратите внимание на правила, связанные с aria-label, aria-labelledby, aria-describedby, отсутствующим доступным именем и т.п.
        • Инспекция свойств accessibility tree
          • Откройте инспектор (Inspect.exe, Accessibility Insights, браузерные инструменты → вкладка «Accessibility»).
          • Выберите несколько представительных элементов (кнопка отправки формы, поле ввода с подсказкой, переключатель, диалоговое окно).
          • Сравните значения Name, Description, Role, State с ожидаемыми локализованными строками.
          • Проверка с экранным диктором
            • Включите экранный диктор (NVDA, VoiceOver и т.д.).
            • Последовательно перемещайте фокус по интерфейсу, слушая объявления.
            • Убедитесь, что объявленные имена и описания соответствуют визуальному тексту на текущей культуре и не содержат «ключевых» строк из ресурсов по умолчанию.
            • Ручная проверка живых регионов и сообщений
              • Выполните действия, вызывающие динамические обновления (валидация формы, обновление списка, уведомление о ошибке).
              • Прослушайте, что объявляет экранный диктор; текст должен быть на текущей культуре.
              • Анализ результатов и фиксирование дефектов
                • Сгруппируйте выявленные проблемы по типу (отсутствующее локализованное имя, жёстко закодированная строка, неверное описание и т.д.).
                • Создайте задачи в трекере с указанием шагов воспроизведения, ожидаемого и фактического результата, скриншотов и/или записей экранного диктора.
                • Повторение для остальных культур
                  • Повторите шаги 2‑6 для каждой выбранной культуры.
                  • Если проблема носит системный характер (например, доступное имя берётся из ресурса по умолчанию), её достаточно исправить один раз.

                  Типичные ошибки и как их избегать

                  При проверке доступности после смены культуры часто встречаются следующие недочёты:

                  • Жёстко закодированные строки в доступных свойствах – разработчик задаёт aria-label=»Submit» прямо в разметке, не используя ресурс. Решение: вынести все доступные имена и описания в файлы локализации и связывать их через механизм привязки (data‑binding, ресурсные ссылки).
                  • Доступное имя формируется из свойства, которое не обновляется при смене культуры – например, имя берётся из Text свойства элемента, которое не переводится. Решение: либо обеспечить перевод этого свойства, либо явно задавать доступное имя через локализованный ресурс.
                  • Отсутствие локализации для aria‑description или подсказок – разработчики переводят только видимый текст, забывая про дополнительные атрибуты. Решение: включить в процесс локализации все строки, используемые в aria-label, aria-describedby, title и аналогичных атрибутах.
                  • Изменение длины строки приводит к обрезанию или наложению – более длинный перевод может выйти за пределы контейнера, делая текст недоступным для чтения. Решение: использовать адаптивные Layouts, проверять минимальные и максимальные размеры, тестировать с псевдо‑локализацией.
                  • Живые регионы объявляют текст на языке по умолчанию – если обновление живого региона происходит через жестко закодированную строку. Решение: обеспечить, чтобы все сообщения, отправляемые в живые регионы, брались из локализованных ресурсов.

                  Сценарии для разных типов приложений

                  Веб‑приложения

                  Для веба удобно использовать браузерные расширения (axe, Lighthouse) и встроенные панельки разработчика. После смены культуры через document.lang или изменение html lang атрибута запустите сканер и проверьте дерево accessibility через вкладку «Accessibility» в DevTools.

                  Настольные приложения Windows (WinForms/WPF)

                  В WPF доступные свойства часто привязываются к свойствам зависимостей (AutomationProperties.Name). Убедитесь, что привязка использует ресурсы ({x:Static res:Strings.Submit}). Инспектировать можно через Inspect.exe или Accessibility Insights for Windows.

                  Мобильные приложения (Android/iOS)

                  На Android проверяйте через Accessibility Scanner или UI Automator Viewer; на iOS – через Xcode Accessibility Inspector. Убедитесь, что свойства contentDescription (Android) и accessibilityLabel (iOS) берутся из локализованных строк.

                  Кроссплатформенные фреймворки (Flutter, React Native, Xamarin)

                  Принцип тот же: локализованные строки должны передаваться в свойства, отвечающие за доступность. Используйте платформенно‑специфичные инспекторы и автоматические сканеры, поддерживающие выбранный фреймворк.

                  FAQ

                  • Нужно ли проверять доступность при каждой смене культуры?
                  • Да, если в приложении поддерживается более чем одна культура и доступные свойства формируются из локализованных ресурсов. При моноязычном продукте проверка достаточно однократной.
                  • Можно ли полагаться только на автоматический сканер?
                  • Автоматические сканеры выявляют формальные нарушения (отсутствие имени, неправильная роль), но не проверяют, насколько смысл объявленного текста соответствует ожиданиям пользователя. Поэтому ручная проверка с экранным диктором обязательна.
                  • Что делать, если обнаружилось, что доступное имя берётся из ресурса по умолчанию независимо от выбранной культуры?
                  • Это указывает на ошибку в привязке ресурсов. Нужно найти место, где задаётся доступное имя (часто в коде или разметке), и заменить жёстко закодированную строку на ссылку на локализованный ресурс. После исправления повторить проверку.
                  • Как проверить, что живые регионы объявят правильный текст после смены культуры?
                  • Выполните действие, вызывающее обновление живого региона (например, отправка формы с ошибкой). Включите экранный диктор и слушайте объявление. Если объявление на языке по умолчанию, проверьте, откуда берётся текст сообщения, и убедитесь, что он берётся из локализованного ресурса.

                  Практический следующий шаг

                  После прочтения этой статьи вы можете сразу начать проверку доступности в своём проекте:

                  1. Выберите одну из поддерживаемых культур, отличную от базовой.
                  2. Переключите культуру в приложении и перезагрузите интерфейс.
                  3. Запустите автоматический сканер доступности (например, расширение axe в браузере) и сохраните отчёт.
                  4. Проинспектируйте несколько ключевых кнопок и полей ввода с помощью Accessibility Inspectors, сравнив их имена с ожидаемыми переводами.
                  5. Включите экранный диктор и пройдитесь по основному сценарию использования, отмечая любые несоответствия между тем, что видно, и тем, что слышит пользователь.
                  6. Зафиксируйте все выявленные проблемы в вашей системе отслеживания задач, указав шаги воспроизведения и ожидаемый результат.

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

                  Эта статья носит информационный характер. При работе с продуктами, где доступность влияет на соблюдение законодательных требований (например, WCAG, Section 508, EN 301 549), рекомендуется дополнительно проводить аудит с привлечением специалистов по доступности и выполнять проверку на целевых устройствах и с использованием Assistive Technologies, актуальных на дату тестирования.

                  Продолжить чтениеВсе материалы