Barrierefreiheit für Ihre eingebettete Lösung
Wenn Sie mit Power BI arbeiten, können Sie Ihre eingebetteten Berichte für verschiedene Benutzertypen zugänglich machen, die möglicherweise mit ihnen interagieren. Einige einfache Möglichkeiten, um Ihre Berichte barrierefreier zu machen, besteht darin, die attribute title und tabindex Attribute, Tastenkombinationen und modus mit hohem Kontrast zu verwenden.
Verwenden von Titel- und Tabindexattributen
Nachdem Sie die powerbi.embed oder die powerbi.bootstrap-Methode aufgerufen haben, erhalten Sie eine Komponente des eingebetteten Typs.
Title-Attribut
Mit dem attribut title können Sie dem Element, zu dem es gehört, Text hinzufügen. Wenn jemand eine Sprachausgabe verwendet, werden die zusätzlichen Informationen zum Element für sie gelesen. Verwenden Sie setComponentTitle, um das title-Attribut der Einbettungskomponente festzulegen.
setComponentTitle(title: string): void
Title-Attribut (Beispiel)
let component = powerbi.embed(…);
component.setComponentTitle(“Analytics report”);
Weitere Informationen zum title-Attribut finden Sie im MDN Web DocsTitel Artikel.
Tabindex-Attribut
Benutzer können ihre Tastatur verwenden, um durch Ihre eingebetteten Berichte zu navigieren. Sie können das attribut tabindex verwenden, um den Fokus auf Registerkarten zu Elementen in Ihrem Bericht hinzuzufügen, die andernfalls übersprungen werden, wenn der Benutzer TAB-drückt. Verwenden Sie setComponentTabIndex, um das tabindex-Attribut der Einbettungskomponente festzulegen.
setComponentTabIndex(tabIndex?: number): void
Sie können das attribut tabindex mithilfe von removeComponentTabIndex entfernen.
removeComponentTabIndex(tabIndex?: number): void
Beispiel für tabindex-Attribut
let component = powerbi.embed(...);
component.setComponentTabIndex(0);
Weitere Informationen zum tabindex-Attribut finden Sie im tabindex Artikel "MDN Web Docs".
Tastenkombinationen in eingebetteten Power BI-Berichten
Für die Benutzer, die ihre Tastaturen verwenden, um Ihre eingebetteten Berichte zu erkunden, ist eine Liste der Tastenkombinationen ein unschätzbares Tool. Wenn Sie die Tastenkombinationen anzeigen möchten, konzentrieren Sie sich auf den eingebetteten Bericht, und drücken Sie UMSCHALT-+?.
Weitere Informationen finden Sie unter Tastenkombinationen in Power BI Desktop.
Modus mit hohem Kontrast in eingebetteten Power BI-Berichten
Um Benutzern mit sehbehinderten oder körperlichen Beeinträchtigungen zu helfen, von Ihren eingebetteten Berichten profitieren zu können, können Sie sie so festlegen, dass ein Design mit hohem Kontrast verwendet wird.
Sie können den Modus für hohen Kontrast festlegen, indem Sie der Einbettungskonfiguration Ihrer Anwendung einen einzelnen Parameter hinzufügen.
let embedConfig = {
…
contrastMode: models.ContrastMode.HighContrast1
};
Die verfügbaren Kontrastmodi sind:
enum ContrastMode {
None = 0,
HighContrast1 = 1,
HighContrast2 = 2,
HighContrastBlack = 3,
HighContrastWhite = 4
}
Der Standardwert ist None = 0.
Wichtig
Wenn Sie sowohl einen Modus mit hohem Kontrast als auch ein Design bereitstellen, wendet Power BI nur den Modus für hohen Kontrast an. Beides kann nicht gleichzeitig angewendet werden.
Anpassen des Zoomfaktors für Power BI-Berichte
Um Benutzern mit sehbehinderten oder körperlichen Beeinträchtigungen zu helfen, von Ihren eingebetteten Berichten profitieren zu können, können Sie den Zoomfaktor des Berichts so anpassen, dass er höher oder niedriger als die Standardstufe ist.
Sie können den Zoomfaktor des Berichts festlegen, indem Sie den Einbettungseinstellungen einen einzelnen Parameter hinzufügen oder die setZoom-API verwenden, nachdem der Bericht geladen wurde.
Der Zoomfaktor wird basierend auf der tatsächlichen Größe des Berichts berechnet. Weitere Informationen zu den Berichtsanzeigeoptionen finden Sie unter Ändern der Anzeige einer Berichtsseite.
let embedConfig = {
…
settings: {
zoomLevel: 2 // 200% zoom
}
};
Um den aktuellen Zoomfaktor abzurufen oder ihn zu ändern, nachdem der Bericht geladen wurde, können Sie die getZoom und setZoom-APIs verwenden.
let currentZoom = await report.getZoom();
await report.setZoom(0.5); // 50% zoom
Anmerkung
Der Zoomfaktor muss zwischen 0,25 (25%) und vier (400%) betragen.