Accessibilité pour votre solution incorporée

  • Article

Lorsque vous utilisez Power BI, envisagez de rendre vos rapports incorporés accessibles à différents types d’utilisateurs qui peuvent interagir avec eux. Quelques façons simples de rendre vos rapports plus accessibles consiste à utiliser les attributs title et tabindex, les raccourcis clavier et le mode contraste élevé.

Comment utiliser des attributs de titre et de tabindex

Après avoir appelé la powerbi.embed ou la méthode powerbi.bootstrap, vous obtenez un composant du type que vous avez incorporé.

Attribut title

L’attribut title vous permet d’ajouter du texte à l’élément auquel il appartient. Si quelqu’un utilise un lecteur d’écran, il lit les informations supplémentaires sur l’élément pour eux. Pour définir l’attribut title du composant incorporé, utilisez setComponentTitle.

setComponentTitle(title: string): void

Exemple d’attribut title

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

Pour en savoir plus sur l’attribut title, consultez l’article mdN Web Docstitre.

Attribut Tabindex

Les utilisateurs peuvent utiliser leur clavier pour parcourir vos rapports incorporés. Vous pouvez utiliser l’attribut tabindex pour ajouter le focus tablé aux éléments de votre rapport qui seraient ignorés autrement lorsque l’utilisateur appuie sur Tab. Pour définir l’attribut tabindex du composant incorporé, utilisez setComponentTabIndex.

setComponentTabIndex(tabIndex?: number): void

Vous pouvez supprimer l’attribut tabindex à l’aide de removeComponentTabIndex

removeComponentTabIndex(tabIndex?: number): void

Exemple d’attribut Tabindex

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

Pour en savoir plus sur l’attribut , consultez l’articletabindex MDN Web Docs.

Raccourcis clavier dans les rapports Power BI incorporés

Pour les personnes qui utilisent leurs claviers pour explorer vos rapports incorporés, une liste de raccourcis clavier est un outil inestimable. Si vous souhaitez afficher les raccourcis clavier, concentrez-vous sur le rapport incorporé et appuyez sur Maj+?.

Pour plus d’informations, consultez raccourcis clavier dans Power BI Desktop.

Mode contraste élevé dans les rapports Power BI incorporés

Pour aider les utilisateurs présentant des déficiences visuelles ou physiques à tirer parti de vos rapports incorporés, vous pouvez les définir pour utiliser un thème à contraste élevé.

Vous pouvez définir le mode contraste élevé en ajoutant un paramètre unique à la configuration incorporée de votre application.

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

Les modes de contraste disponibles sont les suivants :

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

La valeur par défaut est None = 0.

Important

Si vous fournissez à la fois un mode contraste élevé et un thème, Power BI applique uniquement le mode contraste élevé. Il ne peut pas appliquer les deux en même temps.

Ajuster le niveau de zoom pour les rapports Power BI

Pour aider les utilisateurs présentant des déficiences visuelles ou physiques à tirer parti de vos rapports incorporés, vous pouvez ajuster le niveau de zoom du rapport pour qu’il soit supérieur ou inférieur au niveau par défaut.

Vous pouvez définir le niveau de zoom du rapport en ajoutant un seul paramètre aux paramètres incorporés ou en utilisant l’API setZoom une fois le rapport chargé.

Le niveau de zoom est calculé en fonction de la taille réelle du rapport. Consultez Modifier l’affichage d’une page de rapport pour en savoir plus sur les options d’affichage du rapport.

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

Pour obtenir le niveau de zoom actuel ou le modifier une fois le rapport chargé, vous pouvez utiliser les getZoom et les API setZoom.

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

Note

Le niveau de zoom doit être compris entre 0,25 (25%) et quatre (400%).

Contenu connexe