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.