Compartir a través de

Accesibilidad para la solución insertada

  • Artículo

Al trabajar con Power BI, considere la posibilidad de hacer que los informes insertados sean accesibles para diferentes tipos de usuarios que puedan interactuar con ellos. Algunas formas fáciles de hacer que los informes sean más accesibles es usar los atributos title y tabindex, métodos abreviados de teclado y el modo de contraste alto.

Uso de atributos title y tabindex

Después de llamar al powerbi.embed o al método powerbi.bootstrap, obtendrá un componente del tipo que insertó.

Atributo Title

El atributo title permite agregar texto al elemento al que pertenece. Si alguien usa un lector de pantalla, lee la información adicional sobre el elemento para ellos. Para establecer el atributo title del componente de inserción, use setComponentTitle.

setComponentTitle(title: string): void

Ejemplo de atributo title

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

Para obtener más información sobre el atributo title, consulte el artículo documento web de MDNtítulo.

Atributo Tabindex

Los usuarios pueden usar su teclado para navegar por los informes insertados. Puede usar el atributo tabindex para agregar el foco con tabulaciones a los elementos del informe que, de lo contrario, se omitirían cuando el usuario presiona Tab. Para establecer el atributo tabindex del componente de inserción, use setComponentTabIndex.

setComponentTabIndex(tabIndex?: number): void

Puede quitar el atributo tabindex mediante removeComponentTabIndex

removeComponentTabIndex(tabIndex?: number): void

Ejemplo de atributo Tabindex

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

Para obtener más información sobre el atributo tabindex, consulte el artículo documentos web de MDNtabindex.

Métodos abreviados de teclado en informes insertados de Power BI

Para que las personas que usan sus teclados exploren los informes incrustados, una lista de métodos abreviados de teclado es una herramienta inestimable. Si desea mostrar los métodos abreviados de teclado, céntrese en el informe incrustado y presione Mayús+?.

Para más información, consulte métodos abreviados de teclado de en Power BI Desktop.

Modo de contraste alto en informes insertados de Power BI

Para ayudar a los usuarios con discapacidades visuales o físicas a beneficiarse de los informes insertados, puede establecerlos para que usen un tema de contraste alto.

Puede establecer el modo de contraste alto agregando un único parámetro a la configuración de inserción de la aplicación.

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

Los modos de contraste disponibles son:

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

El valor predeterminado es None = 0.

Importante

Si proporciona un modo de contraste alto y un tema, Power BI solo aplicará el modo de contraste alto. No se pueden aplicar ambos al mismo tiempo.

Ajuste del nivel de zoom para los informes de Power BI

Para ayudar a los usuarios con discapacidades visuales o físicas a beneficiarse de los informes insertados, puede ajustar el nivel de zoom del informe para que sea superior o inferior al nivel predeterminado.

Puede establecer el nivel de zoom del informe agregando un único parámetro a la configuración de inserción o mediante la API de setZoom después de cargar el informe.

El nivel de zoom se calcula en función del tamaño real del informe. Consulte Cambiar la presentación de una página de informe para obtener más información sobre las opciones de visualización del informe.

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

Para obtener el nivel de zoom actual o cambiarlo una vez cargado el informe, puede usar las API de getZoom y setZoom.

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

Nota

El nivel de zoom debe estar comprendido entre 0,25 (25%) y cuatro (400%).

Contenido relacionado