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 loro. Alcuni modi semplici per rendere più accessibili i report è usare gli title
attributi e tabindex
, i tasti di scelta rapida e la modalità a contrasto elevato.
Come usare gli attributi titolo e tabindex
Dopo aver chiamato o il powerbi.embed
powerbi.bootstrap
metodo, si ottiene un componente del tipo incorporato.
Attributo title
L'attributo title
consente di aggiungere testo all'elemento a cui appartiene. Se qualcuno usa un lettore 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 titolo
let component = powerbi.embed(…);
component.setComponentTitle(“Analytics report”);
Per altre informazioni sull'attributo, vedere l'articolo title
titolomdN Web Docs.
Attributo Tabindex
Persone può usare la tastiera per spostarsi nei report incorporati. È possibile usare l'attributo per aggiungere lo tabindex
stato attivo a schede agli elementi del report che altrimenti verranno ignorati quando l'utente preme tabulazione. Per impostare l'attributo tabindex
del componente di incorporamento, usare 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, vedere l'articolo tabindex
tabindexdi MDN Web Docs.
Tasti di scelta rapida nei report di Power BI incorporati
Per le persone che usano le loro tastiere per esplorare i report incorporati, un elenco di tasti di scelta rapida è 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 usare 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 fornisce sia una modalità a contrasto elevato che un tema, Power BI applica solo la modalità a contrasto elevato. Non può applicare entrambi allo stesso tempo.
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. Vedere Modificare la visualizzazione di una pagina di report per altre informazioni sulle opzioni di visualizzazione del report.
let embedConfig = {
…
settings: {
zoomLevel: 2 // 200% zoom
}
};
Per ottenere il livello di zoom corrente o modificarlo dopo che il report è stato caricato, è possibile usare le getZoom
API 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%).