Share via

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 susceptibles d’interagir avec eux. Pour rendre vos rapports plus accessibles, vous pouvez utiliser les attributs et tabindex , les raccourcis clavier et le title mode contraste élevé.

Utilisation des attributs title et tabindex

Après avoir appelé la powerbi.embedpowerbi.bootstrap méthode ou, 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 lui. 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’attributtitle, consultez l’article intituléMDN Web Docs.

Attribut Tabindex

Personnes pouvez utiliser leur clavier pour parcourir vos rapports incorporés. Vous pouvez utiliser l’attribut pour ajouter le tabindex focus à onglets aux éléments de votre rapport qui seraient sinon ignorés 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 à l’aide tabindex de removeComponentTabIndex

removeComponentTabIndex(tabIndex?: number): void

Exemple d’attribut Tabindex

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

Pour en savoir plus sur l’attribut tabindex , consultez l’article mdn Web Docstabindex .

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 ayant 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 de contraste élevé en ajoutant un seul paramètre à 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
}

Par défaut, il s’agit de None = 0.

Important

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

Ajuster le niveau de zoom pour les rapports Power BI

Pour aider les utilisateurs ayant 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 d’incorporation ou en utilisant l’API setZoom après le chargement du rapport.

Le niveau de zoom est calculé en fonction de la taille réelle du rapport. Pour en savoir plus sur les options d’affichage d’un rapport, consultez Modifier l’affichage d’une page de 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 API et setZoom .

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

Notes

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

Contenu connexe