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

Специальные возможности для внедренного решения

  • Статья

При работе с Power BI рекомендуется сделать внедренные отчеты доступными для различных типов пользователей, которые могут взаимодействовать с ними. Несколько простых способов сделать отчеты более доступными— использовать title и tabindex атрибуты, сочетания клавиш и режим высокой контрастности.

Использование атрибутов title и tabindex

После вызова powerbi.embed или метода powerbi.bootstrap вы получите компонент внедренного типа.

Атрибут title

Атрибут title позволяет добавлять текст в элемент, к которому он принадлежит. Если кто-то использует средство чтения с экрана, он считывает дополнительные сведения об элементе для них. Чтобы задать атрибут title компонента внедрения, используйте setComponentTitle.

setComponentTitle(title: string): void

Пример атрибута title

let component = powerbi.embed(…);
component.setComponentTitle(“Analytics report”);

Дополнительные сведения о атрибуте title см. в статье веб-документации MDN.

Атрибут Tabindex

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

setComponentTabIndex(tabIndex?: number): void

Вы можете удалить атрибут tabindex с помощью removeComponentTabIndex

removeComponentTabIndex(tabIndex?: number): void

Пример атрибута Tabindex

let component = powerbi.embed(...);
component.setComponentTabIndex(0);

Дополнительные сведения о атрибуте tabindex см. в статье веб-документация MDNtabindex.

Сочетания клавиш в внедренных отчетах Power BI

Для тех, кто использует свои клавиатуры для изучения внедренных отчетов, список сочетаний клавиш является бесценным инструментом. Если вы хотите отобразить сочетания клавиш, сосредоточьтесь на внедренном отчете и нажмите клавишу SHIFT +?.

Дополнительные сведения см. в сочетания клавиш в Power BI Desktop.

Режим высокой контрастности в внедренных отчетах Power BI

Чтобы помочь пользователям с визуальными или физическими нарушениями воспользоваться внедренными отчетами, можно настроить их для использования темы высокой контрастности.

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

let embedConfig = {
    …
    contrastMode: models.ContrastMode.HighContrast1
};

Доступны режимы контрастности:

enum ContrastMode {
    None = 0,
    HighContrast1 = 1,
    HighContrast2 = 2,
    HighContrastBlack = 3,
    HighContrastWhite = 4
}

Значение по умолчанию — None = 0.

Важный

Если вы предоставляете режим высокой контрастности и тему, Power BI будет применять только режим высокой контрастности. Оно не может применяться одновременно.

Настройка уровня масштабирования для отчетов Power BI

Чтобы помочь пользователям с визуальными или физическими нарушениями воспользоваться внедренными отчетами, можно настроить уровень масштабирования отчета на более высокий или низкий, чем уровень по умолчанию.

Вы можете задать уровень масштабирования отчета, добавив один параметр в параметры внедрения или используя API setZoom после загрузки отчета.

Уровень масштабирования вычисляется на основе фактического размера отчета. Дополнительные сведения о параметрах отображения отчета см. в статье Изменение отображения страниц ы отчета.

let embedConfig = {
    …
    settings: {
        zoomLevel: 2 // 200% zoom
    }
};

Чтобы получить текущий уровень масштабирования или изменить его после загрузки отчета, можно использовать интерфейсы API getZoom и setZoom.

let currentZoom = await report.getZoom();
await report.setZoom(0.5); // 50% zoom

Заметка

Уровень масштабирования должен быть от 0,25 (25%) до четырех (400%).

Связанное содержимое