Ondersteuning voor toetsenbordnavigatie in een aangepast visueel element

  • Artikel

In dit artikel wordt uitgelegd hoe u navigatie via een Power BI-visual kunt ondersteunen met behulp van het toetsenbord. Toetsenbordnavigatie maakt Power BI toegankelijker voor mensen met een handicap en biedt meer opties voor interactie met rapporten.

De supportsKeyboardFocus functie maakt het mogelijk om door de gegevenspunten van de visual te navigeren met alleen het toetsenbord.

Basisfuncties voor toetsenbordtoegankelijkheid

Alle visuals hebben de volgende eenvoudige toetsenbordtoegankelijkheid:

  • Druk op Esc om de focus vanuit de visual naar de visualcontainer te verplaatsen.
  • Druk vanuit een aangepast visueel element op Tab om door tabbable elementen in de visual te navigeren. Als u op Tab drukt nadat het laatste tababble-element de focus weer buiten de visual verplaatst.

Verbeterde toetsenbordtoegankelijkheid

Als u uw aangepaste visual nog toegankelijker wilt maken, voegt u de supportsKeyboardFocus mogelijkheid toe aan uw visual door de volgende regel toe te voegen aan het bestand capabilities.json:

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

Met deze mogelijkheid worden de volgende functies toegevoegd aan uw aangepaste visual:

  • Druk op Enter wanneer de focus zich op de visualcontainer bevindt om de focus naar binnen de aangepaste visual te verplaatsen.
  • Druk vanuit de aangepaste visual op Tab om door tabbable elementen te navigeren. De focus blijft binnen de visual totdat u op Esc drukt.

Notitie

Niet alle HTML-elementen zijn standaard tabbable (bijvoorbeeld div en span). Overweeg om het juiste kenmerk (bijvoorbeeld tabindex) toe te voegen aan deze elementen om ze tabbable te maken.

Overwegingen en beperkingen

  • Voor deze functie is API v2.1.0 of hoger vereist.

  • Deze functie kan niet worden toegepast op afbeeldingsvisuals.

  • Als u op Enter drukt op de visualcontainer, komt het eerste focusbare element van de visual niet altijd aan. Als u zeker wilt beginnen bij het eerste element, moet u het programmatisch richten nadat de focus naar de visual is verplaatst.

  • Nadat u op Enter op de visualcontainer hebt gedrukt en na het drukken op Tab op het laatste focusbare element, moet de gebruiker mogelijk meerdere keren op Tab drukken om naar het eerste element te gaan.

Gerelateerde inhoud