Supportare lo spostamento tramite tastiera in un oggetto visivo personalizzato

  • Articolo

Questo articolo illustra come supportare lo spostamento tramite un oggetto visivo di Power BI usando la tastiera. Lo spostamento tramite tastiera rende Power BI più accessibile alle persone con disabilità e offre altre opzioni per interagire con i report.

La supportsKeyboardFocus funzionalità consente di esplorare i punti dati dell'oggetto visivo usando solo la tastiera.

Funzionalità di accessibilità della tastiera di base

Tutti gli oggetti visivi sono dotati della seguente accessibilità della tastiera di base:

  • Premere ESC per spostare lo stato attivo dall'interno dell'oggetto visivo al contenitore visivo.
  • Premere TAB all'interno di un oggetto visivo personalizzato per spostarsi tra gli elementi tabulabili nell'oggetto visivo. Premendo TAB dopo l'ultimo elemento tababble lo stato attivo viene spostato all'esterno dell'oggetto visivo.

Accessibilità avanzata tramite tastiera

Per rendere ancora più accessibile l'oggetto visivo personalizzato, aggiungere la supportsKeyboardFocus funzionalità all'oggetto visivo aggiungendo la riga seguente al file "capabilities.json":

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

Questa funzionalità aggiunge le funzionalità seguenti all'oggetto visivo personalizzato:

  • Premere INVIO quando lo stato attivo si trova sul contenitore visivo per spostare lo stato attivo all'interno dell'oggetto visivo personalizzato.
  • Premere TAB dall'interno dell'oggetto visivo personalizzato per spostarsi tra gli elementi tabulabili. Lo stato attivo rimane all'interno dell'oggetto visivo finché non si preme ESC.

Nota

Non tutti gli elementi HTML sono tabulabili per impostazione predefinita (ad esempio, div e span). Prendere in considerazione l'aggiunta dell'attributo corretto (ad esempio tabindex) a questi elementi per renderli tabulabili.

Considerazioni e limitazioni

  • Questa funzionalità richiede l'API v2.1.0 o versione successiva.

  • Questa funzionalità non può essere applicata agli oggetti visivi delle immagini.

  • Premendo INVIO nel contenitore visivo non viene sempre attivato il primo elemento attivabile dell'oggetto visivo. Per assicurarsi di iniziare al primo elemento, attivarlo a livello di codice dopo che lo stato attivo passa all'oggetto visivo.

  • Dopo aver premuto INVIO nel contenitore visivo e dopo aver premuto TAB sull'ultimo elemento attivabile, l'utente potrebbe dover premere TAB più volte per passare al primo elemento.

Contenuto correlato