Поделиться через

Поддержка навигации по клавиатуре в пользовательском визуальном элементе

  • Статья

В этой статье объясняется, как поддерживать навигацию по визуальному элементу Power BI с помощью клавиатуры. Навигация по клавиатуре делает Power BI более доступными для людей с ограниченными возможностями и предоставляет дополнительные возможности для взаимодействия с отчетами.

Эта supportsKeyboardFocus функция позволяет перемещать точки данных визуального элемента только с помощью клавиатуры.

Основные функции специальных возможностей клавиатуры

Все визуальные элементы содержат следующие основные специальные возможности клавиатуры:

  • Нажмите клавишу ESC , чтобы переместить фокус из визуального элемента в визуальный контейнер.
  • Нажмите клавишу TAB внутри настраиваемого визуального элемента, чтобы перемещаться по элементам табуляции в визуальном элементе. Нажатие клавиши TAB после последнего элемента табуляции перемещает фокус назад за пределами визуального элемента.

Расширенные специальные возможности клавиатуры

Чтобы сделать настраиваемый визуальный элемент еще более доступным, добавьте supportsKeyboardFocus его в визуальный элемент, добавив следующую строку в файл capabilities.json:

    {   
        ...
        "supportsKeyboardFocus": true
        ...
    }

Эта возможность добавляет следующие функции в пользовательский визуальный элемент:

  • Нажмите клавишу ВВОД , когда фокус находится в визуальном контейнере, чтобы переместить фокус в пользовательский визуальный элемент.
  • Нажмите клавишу TAB внутри пользовательского визуального элемента, чтобы перейти к элементам табуляции. Фокус остается внутри визуального элемента, пока не нажимаете клавишу ESC.

Примечание.

Не все ЭЛЕМЕНТЫ HTML по умолчанию доступны для табуляции (например, div и span). Попробуйте добавить правильный атрибут (например табиндекс) в эти элементы, чтобы сделать их табуляемыми.

Рекомендации и ограничения

  • Для этой функции требуется API версии 2.1.0 или более поздней версии.

  • Эту функцию нельзя применить к визуальным элементам изображения.

  • Нажатие клавиши ВВОД в визуальном контейнере не всегда приземлится на первом фокусируемом элементе визуального элемента. Чтобы обязательно начать с первого элемента, сосредоточьтесь на нем программным способом после того, как фокус перейдет в визуальный элемент.

  • После нажатия клавиши ВВОД в визуальном контейнере и после нажатия клавиши TAB на последнем фокусируемом элементе пользователю может потребоваться несколько раз, чтобы перейти к первому элементу.

Связанный контент