Compatibilidad con la navegación por teclado en un objeto visual personalizado
En este artículo se explica cómo dar soporte a la navegación por medio de un objeto visual de Power BI mediante el teclado. La navegación mediante teclado hace que Power BI sea más accesible para las personas con discapacidades y proporciona más opciones para interactuar con informes.
La característica supportsKeyboardFocus permite desplazarse por los puntos de datos del objeto visual usando solo el teclado.
Características básicas de accesibilidad del teclado
Todos los objetos visuales incluyen la siguiente accesibilidad básica del teclado:
- Presione Esc para mover el foco desde dentro del objeto visual al contenedor visual.
- Presione Tab desde dentro de un objeto visual personalizado para navegar por los elementos tabulables en el objeto visual. Al presionar Tab después del último elemento de tabulación, el foco se mueve fuera del objeto visual.
Accesibilidad mejorada del teclado
Para que el objeto visual personalizado sea aún más accesible, agregue la funcionalidad supportsKeyboardFocus al objeto visual agregando la siguiente línea al archivo "capabilities.json":
{
...
"supportsKeyboardFocus": true
...
}
Esta funcionalidad agrega las siguientes características al objeto visual personalizado:
- Presione Entrar cuando el foco esté en el contenedor visual para mover el foco dentro del objeto visual personalizado.
- Presione Tab desde dentro del objeto visual personalizado para navegar por los elementos tabulables. El foco permanece dentro del objeto visual hasta que presione Esc.
Nota
No todos los elementos HTML son tabulables de forma predeterminada (por ejemplo, div y span). Considere la posibilidad de agregar el atributo correcto (por ejemplo, tabindex) a estos elementos para que sean tabulables.
Consideraciones y limitaciones
Esta característica requiere la API v2.1.0 o una versión posterior.
Esta característica no se puede aplicar a los objetos visuales de imagen.
Al presionar Entrar en el contenedor visual, no siempre se colocará en el primer elemento con foco del objeto visual. Para asegurarse de empezar en el primer elemento, céntrelo mediante programación después de que el foco entre en el objeto visual.
Después de presionar Entrar en el contenedor visual y después de presionar Tab en el último elemento con foco, es posible que el usuario tenga que presionar Tab más de una vez para llegar al primer elemento.