Støtte tastaturnavigasjon i et egendefinert visualobjekt

Denne artikkelen forklarer hvordan du støtter navigasjon gjennom et Power BI-visualobjekt ved hjelp av tastaturet. Tastaturnavigasjon gjør Power BI mer tilgjengelig for personer med funksjonshemninger og gir flere alternativer for samhandling med rapporter.

Funksjonen supportsKeyboardFocus gjør det mulig å navigere i datapunktene i visualobjektet ved hjelp av bare tastaturet.

Grunnleggende tilgjengelighetsfunksjoner for tastaturet

Alle visualobjekter leveres med følgende grunnleggende tilgjengelighet for tastaturet:

  • Trykk esc for å flytte fokus fra innsiden av visualobjektet til den visuelle beholderen.
  • Trykk tab fra innsiden av et egendefinert visualobjekt for å navigere gjennom tabbable elementer i visualobjektet. Hvis du trykker tab etter det siste tababble-elementet, flyttes fokuset tilbake utenfor visualobjektet.

Forbedret tilgjengelighet for tastaturet

Hvis du vil gjøre det egendefinerte visualobjektet enda mer tilgjengelig, kan du legge til funksjonen i visualobjektet supportsKeyboardFocus ved å legge til følgende linje i «capabilities.json»-filen:

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

Denne funksjonen legger til følgende funksjoner i det egendefinerte visualobjektet:

  • Trykk enter når fokuset er på den visuelle beholderen for å flytte fokus til det egendefinerte visualobjektet.
  • Trykk tab fra innsiden av det egendefinerte visualobjektet for å navigere gjennom tabbable elementer. Fokuset forblir inne i visualobjektet til du trykker esc.

Merk

Ikke alle HTML-elementer kan brukes som standard (for eksempel div og span). Vurder å legge til riktig attributt (f.eks. tabindex) i disse elementene for å gjøre dem tabbable.

Hensyn og begrensninger

  • Denne funksjonen krever API v2.1.0 eller nyere.

  • Denne funksjonen kan ikke brukes på bildevisualobjekter.

  • Hvis du trykker enter på den visuelle beholderen, havner ikke alltid på det første fokuselementet i visualobjektet. Hvis du vil være sikker på å starte på det første elementet, fokuserer du det programmatisk etter at fokuset går inn i visualobjektet.

  • Når du har trykket ENTER på den visuelle beholderen og når du har trykket TAB på det siste fokuselementet, kan det hende at brukeren må trykke på TAB mer enn én gang for å komme til det første elementet.