Ofereça suporte à navegação pelo teclado em um visual personalizado

  • Artigo

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 para pessoas com deficiências e fornece mais opções para interagir com os relatórios.

O recurso supportsKeyboardFocus possibilita a navegação pelos pontos de dados do visual usando apenas o teclado.

Recursos básicos de acessibilidade do teclado

Todos os visuais vêm com a seguinte acessibilidade básica do teclado:

  • Pressione Esc para mover o foco de dentro do visual para o contêiner de visuais.
  • Pressione Tab de dentro de um visual personalizado para navegar pelos elementos de tabulação no visual. Pressionar a Guia após o último elemento de tabulação move o foco de volta para fora do visual.

Acessibilidade aprimorada do teclado

Para tornar seu visual personalizado ainda mais acessível, adicione a capacidade supportsKeyboardFocus ao seu visual adicionando a seguinte linha ao arquivo "capabilities.json":

    {   
        ...
        "supportsKeyboardFocus": true
        ...
    }

Esse recurso adiciona as seguintes funcionalidades ao seu visual personalizado:

  • Pressione Enter quando o foco estiver no contêiner de visuais para mover o foco para dentro do visual personalizado.
  • Pressione a Guia de dentro do visual personalizado para navegar pelos elementos da tabela. O foco permanece dentro do visual até você pressionar Esc.

Observação

Nem todos os elementos HTML são tabuláveis por padrão (por exemplo, div e span). Considere adicionar o atributo correto (por exemplo, tabindex) a esses elementos para torná-los tabuláveis.

Considerações e limitações

  • Esse recurso requer a API v 2.1.0 ou superior.

  • Esse recurso não pode ser aplicado a visuais de imagem.

  • Pressionar Enter no contêiner visual nem sempre aterrissa no primeiro elemento focalizável do visual. Para ter certeza de que começará no primeiro elemento, focalize-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.

Conteúdo relacionado