Stöd för tangentbordsnavigering i ett anpassat visuellt objekt

Den här artikeln beskriver hur du stöder navigering via ett visuellt Power BI-objekt med hjälp av tangentbordet. Tangentbordsnavigering gör Power BI mer tillgängligt för personer med funktionshinder och ger fler alternativ för att interagera med rapporter.

Funktionen supportsKeyboardFocus gör det möjligt att navigera i det visuella objektets datapunkter med hjälp av endast tangentbordet.

Grundläggande hjälpmedelsfunktioner för tangentbord

Alla visuella objekt har följande grundläggande tangentbordstillgänglighet:

  • Tryck på Esc för att flytta fokus inifrån det visuella objektet till den visuella containern.
  • Tryck på Tabb inifrån ett anpassat visuellt objekt för att navigera genom tabbbara element i det visuella objektet. Om du trycker på Tabb efter det sista tababble-elementet flyttas fokus tillbaka utanför det visuella objektet.

Förbättrad tangentbordstillgänglighet

Om du vill göra ditt anpassade visuella objekt ännu mer tillgängligt lägger du till supportsKeyboardFocus funktionen i ditt visuella objekt genom att lägga till följande rad i filen "capabilities.json":

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

Den här funktionen lägger till följande funktioner i ditt anpassade visuella objekt:

  • Tryck på Retur när fokus ligger på den visuella containern för att flytta fokus till i det anpassade visuella objektet.
  • Tryck på Tabb inifrån det anpassade visuella objektet för att navigera genom tabbbara element. Fokus ligger kvar i det visuella objektet tills du trycker på Esc.

Kommentar

Alla HTML-element är inte tabbbara som standard (till exempel div och span). Överväg att lägga till rätt attribut (t.ex. tabindex) till dessa element för att göra dem tabbbara.

Beaktanden och begränsningar

  • Den här funktionen kräver API v2.1.0 eller senare.

  • Den här funktionen kan inte tillämpas på visuella bildobjekt.

  • Om du trycker på Retur i den visuella containern hamnar det inte alltid på det första fokuserbara elementet i det visuella objektet. För att vara säker på att börja med det första elementet fokuserar du programmatiskt när fokus hamnar i det visuella objektet.

  • När du har tryckt på Retur i den visuella containern och efter att ha tryckt på Tabb på det sista fokuserbara elementet kan användaren behöva trycka på Tabb mer än en gång för att komma till det första elementet.