嵌入式解决方案的辅助功能

使用 Power BI 时，请考虑使嵌入报表可供可能与之交互的不同类型的用户访问。使报表更易于访问的一些简单方法是使用 title 和 tabindex 属性、键盘快捷方式和高对比度模式。

如何使用标题和 tabindex 属性

调用 powerbi.embed 或 powerbi.bootstrap 方法后，将获取嵌入类型的组件。

title 属性允许向它所属的元素添加文本。如果有人使用屏幕阅读器，它将读取有关其元素的其他信息。若要设置嵌入组件的 title 属性，请使用 setComponentTitle。

setComponentTitle(title: string): void

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

若要详细了解 title 属性，请参阅 MDN Web Docs标题一文。

用户可以使用键盘浏览嵌入的报表。可以使用 tabindex 属性将制表符焦点添加到报表中的元素，否则当用户按下 Tab Tab时跳过。若要设置嵌入组件的 tabindex 属性，请使用 setComponentTabIndex。

setComponentTabIndex(tabIndex?: number): void

可以使用 removeComponentTabIndex 删除 tabindex 属性

removeComponentTabIndex(tabIndex?: number): void

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

若要详细了解 tabindex 属性，请参阅 MDN Web Docstabindex 一文。

对于使用键盘浏览嵌入报表的人员，键盘快捷方式列表是一个宝贵的工具。如果要显示键盘快捷方式，请专注于嵌入的报表，然后按 Shift+？。

若要了解详细信息，请参阅 Power BI Desktop中的键盘快捷方式。

为了帮助具有视觉或物理障碍的用户受益于嵌入式报表，你可以将其设置为使用高对比度主题。

可以通过向应用程序的嵌入配置添加单个参数来设置高对比度模式。

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

可用的对比度模式包括：

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

默认值为 None = 0。

重要

如果同时提供高对比度模式和主题，Power BI 将仅应用高对比度模式。它不能同时应用两者。

为了帮助具有视觉或物理障碍的用户受益于嵌入报表，你可以将报表缩放级别调整为高于或低于默认级别。

可以通过向嵌入设置添加单个参数或在报表加载后使用 setZoom API 来设置报表的缩放级别。

缩放级别是根据报表的实际大小计算的。请参阅更改报表页的显示，了解有关报表显示选项的详细信息。

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

若要获取当前缩放级别或在报表加载后对其进行更改，可以使用 getZoom 和 setZoom API。

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

注意

缩放级别必须介于 0.25 （25%）和 4 （400%）之间。