Suporte a navegação pelo teclado em um visual personalizado
Este artigo explica como dar suporte à navegação por meio de um visual do Power BI usando o teclado. A navegação pelo teclado torna o Power BI mais acessível a pessoas com deficiências e fornece mais opções para interagir com relatórios.
O supportsKeyboardFocus
recurso possibilita navegar pelos pontos de dados do visual usando apenas o teclado.
Recursos básicos de acessibilidade do teclado
Todos os elementos visuais vêm com a seguinte acessibilidade básica do teclado:
- Pressione Esc para mover o foco de dentro do contêiner visual para o visual.
- Pressione Tab de dentro de um visual personalizado para navegar pelos elementos ajustáveis no visual. Pressionar Tab após o último elemento tababble move o foco de volta para fora do visual.
Acessibilidade melhorada do teclado
Para tornar seu visual personalizado ainda mais acessível, adicione o supportsKeyboardFocus
recurso ao seu visual adicionando a seguinte linha ao arquivo "capabilities.json":
{
...
"supportsKeyboardFocus": true
...
}
Esse recurso adiciona os seguintes recursos ao seu visual personalizado:
- Pressione Enter quando o foco estiver no contêiner visual para mover o foco para dentro do visual personalizado.
- Pressione Tab de dentro do visual personalizado para navegar pelos elementos que podem ser tabulados. O foco permanece dentro do visual até que você pressione Esc.
Nota
Nem todos os elementos HTML podem ser tabulados por padrão (por exemplo, div e span). Considere adicionar o atributo correto (por exemplo, tabindex) a esses elementos para torná-los tabbable.
Considerações e limitações
Este recurso requer a API v2.1.0 ou superior.
Esse recurso não pode ser aplicado a imagens visuais.
Pressionar Enter no contêiner visual nem sempre pousará no primeiro elemento focalizável do visual. Para ter certeza de começar no primeiro elemento, concentre-o programaticamente depois que o foco for para o visual.
Depois de pressionar Enter no contêiner visual e depois de pressionar Tab no último elemento focalizável, o usuário pode ter que pressionar Tab mais de uma vez para chegar ao primeiro elemento.