共用方式為

內嵌解決方案的輔助功能

  • 發行項

使用 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 屬性

人員可以使用鍵盤瀏覽您的內嵌報表。 您可以使用 tabindex 屬性，將索引標籤焦點新增至報表中的元素，否則當使用者按下 tab Tab時會略過。若要設定內嵌元件的 tabindex 屬性，請使用 setComponentTabIndex。

setComponentTabIndex(tabIndex?: number): void

您可以使用 removeComponentTabIndex 來移除 tabindex 屬性

removeComponentTabIndex(tabIndex?: number): void

Tabindex 屬性範例

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

若要深入瞭解 tabindex 屬性，請參閱 MDN Web Docstabindex 一文。

內嵌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 報表的縮放層級

為了協助視覺或身體障礙的使用者受益於內嵌報表，您可以將報表縮放層級調整為高於或低於預設層級。

您可以將單一參數新增至內嵌設定，或使用報表載入之後的 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%） 和四 （400%） 之間。

相關內容