Accessibilità per la soluzione incorporata
Quando si usa Power BI, è consigliabile rendere i report incorporati accessibili a diversi tipi di utenti che potrebbero interagire con essi. Alcuni semplici modi per rendere i report più accessibili è usare gli attributi title e tabindex, i tasti di scelta rapida e la modalità a contrasto elevato.
Come usare gli attributi title e tabindex
Dopo aver chiamato il powerbi.embed o il metodo powerbi.bootstrap, si ottiene un componente del tipo incorporato.
Attributo Title
L'attributo title consente di aggiungere testo all'elemento a cui appartiene. Se un utente usa un'utilità per la lettura dello schermo, legge le informazioni aggiuntive sull'elemento per loro. Per impostare l'attributo title del componente di incorporamento, usare setComponentTitle.
setComponentTitle(title: string): void
Esempio di attributo title
let component = powerbi.embed(…);
component.setComponentTitle(“Analytics report”);
Per altre informazioni sull'attributo title, vedere l'articolo titolo della documentazione Web MDN.
Attributo Tabindex
Gli utenti possono usare la tastiera per spostarsi tra i report incorporati. È possibile utilizzare l'attributo tabindex per aggiungere lo stato attivo a schede agli elementi del report che altrimenti verrebbero ignorati quando l'utente preme Tab. Per impostare l'attributo tabindex del componente di incorporamento, utilizzare setComponentTabIndex.
setComponentTabIndex(tabIndex?: number): void
È possibile rimuovere l'attributo tabindex usando removeComponentTabIndex
removeComponentTabIndex(tabIndex?: number): void
Esempio di attributo Tabindex
let component = powerbi.embed(...);
component.setComponentTabIndex(0);
Per altre informazioni sull'attributo
Tasti di scelta rapida nei report di Power BI incorporati
Per gli utenti che usano le loro tastiere per esplorare i report incorporati, un elenco di scelte rapide da tastiera è uno strumento prezioso. Se si desidera visualizzare i tasti di scelta rapida, concentrarsi sul report incorporato e premere MAIUSC+?.
Per altre informazioni, vedere tasti di scelta rapida in Power BI Desktop.
Modalità a contrasto elevato nei report di Power BI incorporati
Per aiutare gli utenti con problemi visivi o fisici a trarre vantaggio dai report incorporati, è possibile impostarli per l'uso di un tema a contrasto elevato.
È possibile impostare la modalità a contrasto elevato aggiungendo un singolo parametro alla configurazione di incorporamento dell'applicazione.
let embedConfig = {
…
contrastMode: models.ContrastMode.HighContrast1
};
Le modalità di contrasto disponibili sono:
enum ContrastMode {
None = 0,
HighContrast1 = 1,
HighContrast2 = 2,
HighContrastBlack = 3,
HighContrastWhite = 4
}
Il valore predefinito è None = 0.
Importante
Se si specifica sia una modalità a contrasto elevato che un tema, Power BI applicherà solo la modalità a contrasto elevato. Non può essere applicato contemporaneamente.
Regolare il livello di zoom per i report di Power BI
Per aiutare gli utenti con problemi visivi o fisici a trarre vantaggio dai report incorporati, è possibile modificare il livello di zoom del report in modo che sia superiore o inferiore al livello predefinito.
È possibile impostare il livello di zoom del report aggiungendo un singolo parametro alle impostazioni di incorporamento oppure usando l'API setZoom dopo il caricamento del report.
Il livello di zoom viene calcolato in base alle dimensioni effettive del report. Per altre informazioni sulle opzioni di visualizzazione del report, vedere Modificare la visualizzazione di una pagina del report.
let embedConfig = {
…
settings: {
zoomLevel: 2 // 200% zoom
}
};
Per ottenere il livello di zoom corrente o modificarlo dopo il caricamento del report, è possibile usare le API getZoom e setZoom.
let currentZoom = await report.getZoom();
await report.setZoom(0.5); // 50% zoom
Nota
Il livello di zoom deve essere compreso tra 0,25 (25%) e quattro (400%).