Gli elementi interattivi, tra cui i controlli dei moduli, i link e i pulsanti, sono per impostazione predefinita attivabili e selezionabili con il tasto Tab. Gli elementi selezionabili con il tasto Tab fanno parte dell'ordine di navigazione sequenziale dello stato attivo del documento. Gli altri elementi sono inerti, ovvero non sono interattivi. Con gli attributi HTML, è possibile rendere inerti gli elementi interattivi e rendere interattivi gli elementi inerti.
Per impostazione predefinita, l'ordine di attivazione della navigazione è lo stesso dell'ordine visivo, ovvero l'ordine del codice sorgente. Esistono attributi HTML che possono alterare questo ordine e proprietà CSS che possono alterare l'ordine visivo dei contenuti. La modifica dell'ordine di tabulazione con HTML o dell'ordine di rendering visivo con CSS può danneggiare l'esperienza utente.
Non modificare l'ordine di tabulazione percepito ed effettivo con CSS e HTML. Come dimostrano i due esempi seguenti, gli ordini di tabulazione diversi dall'ordine visivamente previsto confondono gli utenti e compromettono l'esperienza utente.
Nell'esempio seguente, il valore dell'attributo tabindex ha reso caotico l'ordine di tabulazione:
In questo esempio, il CSS ha creato una divergenza tra l'ordine di tabulazione e l'ordine visivo dei contenuti:
La dichiarazione flex-flow: row-reverse; ha invertito l'ordine visivo. Inoltre, la proprietà CSS order è stata applicata alla sesta parola, "This", che è stata spostata visivamente. La sequenza di tabulazione è l'ordine del codice, che non corrisponde più all'ordine visivo.
Questo crea una disconnessione per gli utenti della tastiera.
Alcune funzionalità CSS, tra cui flexbox, grid, positioning, transforms e multi-column, possono alterare l'ordine visivo dei contenuti. Testa i tuoi contenuti scorrendoli con il tasto Tab di una tastiera: con Maiusc + Tab per spostarti indietro tra i contenuti. Utilizza i CSS per indicare l'elemento attivo. Non riordinare gli elementi attivabili con CSS.
È importante mantenere un ordine di tabulazione logico su tutte le dimensioni dell'area visibile.
Rendi interattivi gli elementi inerti
Gli attributi contenteditable e tabindex, essendo attributi globali, possono essere aggiunti a qualsiasi elemento, rendendolo attivabile durante la procedura. Gli elementi attivabili
possono essere attivati anche con un mouse o un puntatore, impostando l'attributo
autofocus
o tramite script, ad esempio con
element.focus().
L'attributo tabindex
L'attributo globale tabindex, introdotto in Attributi, consente agli elementi che altrimenti non sarebbero in grado di ricevere lo stato attivo di ottenerlo, di solito con Tab, da cui il nome.
L'attributo tabindex accetta come valore un numero intero. Un valore negativo rende un elemento attivabile, ma non selezionabile tramite tabulazione. Un valore tabindex di 0 rende l'elemento attivabile e selezionabile con il tasto Tab, aggiungendo l'elemento su cui viene applicato all'ordine di navigazione sequenziale dello stato attivo nell'ordine del codice sorgente. Un valore pari o superiore a 1 rende l'elemento attivabile e selezionabile tramite tabulazione, ma lo aggiunge a una sequenza di tabulazione con priorità e deve essere evitato.
In questa pagina, il pulsante di condivisione <share-action> è un elemento personalizzato. tabindex="0" aggiunge questo elemento all'ordine di tabulazione predefinito della tastiera:
<share-action authors="@front-end.social/@estellevw" data-action="click"
data-category="web.dev" data-icon="share" data-label="share, mastodon"
role="button" tabindex="0">
<svg aria-label="share" role="img" xmlns="http://www.w3.org/2000/svg">
<use href="#shareIcon" />
</svg>
<span>Share</span>
</share-action>
Inoltre, la navigazione locale
ha un elemento personalizzato con un valore tabindex negativo:
<web-navigation-drawer type="standard" tabindex="-1">
Un attributo tabindex con un valore negativo rende l'elemento attivabile, ma non selezionabile con il tasto Tab. L'elemento può ricevere lo stato attivo, ad esempio utilizzando HTMLElement.focus(), ma non fa parte dell'ordine di navigazione sequenziale dello stato attivo. La convenzione per gli elementi attivabili non tabulabili è utilizzare tabindex="-1". Se aggiungi tabindex="-1" a un elemento interattivo, non sarà più possibile spostarsi con il tasto Tab.
Il metodo element.focus() può essere utilizzato per impostare lo stato attivo sugli elementi attivabili. I browser scorrono gli elementi attivi per renderli visibili. Per questo motivo, evita l'uso di element.focus({preventScroll:true}), poiché lo stato attivo su un elemento non visibile è un'esperienza utente negativa.
Se vuoi eseguire una query sul documento per scoprire quale elemento ha lo stato attivo, utilizza la proprietà di sola lettura Document.activeElement.
Gli elementi con un tabindex pari o superiore a 1 sono inclusi in una sequenza di schede separata. Come nel seguente Codepen, la navigazione con il tasto Tab inizia in una sequenza separata, in ordine dal valore più basso a quello più alto, prima di passare a quelli nella sequenza normale (nessun tabindex impostato o tabindex="0") nell'ordine di origine:
tabindex con un valore positivo inserisce l'elemento in una sequenza di attivazione con priorità, il che può causare confusione nell'ordine di attivazione. Evita di
modificare l'ordine del DOM con tabindex. Un ordine di tabulazione alterato può creare esperienze utente negative ed è difficile da gestire.
L'attributo contenteditable
contenteditable è un attributo globale. L'impostazione di contenteditable="true" su qualsiasi elemento lo rende modificabile, attivabile e parte dell'ordine di tabulazione. Il comportamento di messa a fuoco è simile
all'impostazione tabindex="0", ma non è lo stesso.
Gli elementi contenteditable nidificati sono attivabili, ma non tabulabili. Per rendere un elemento contenteditable nidificato selezionabile con il tasto Tab, aggiungi tabindex="0", che aggiunge l'elemento all'ordine di navigazione sequenziale dello stato attivo.
Assegna autofocus agli elementi interattivi
Sebbene il valore booleano autofocus
sia un attributo globale che può essere impostato su qualsiasi elemento, non rende interattivo un elemento
inerte. Quando la pagina viene caricata, il primo elemento attivabile con gli attributi autofocus riceve lo stato attivo, a condizione che l'elemento venga visualizzato e non sia nidificato in un <dialog>.
L'impostazione automatica dello stato attivo sui contenuti potrebbe confondere gli utenti. Quando imposti autofocus su un controllo del modulo, questo controllo scorre nella visualizzazione al caricamento pagina.
I tuoi utenti, inclusi quelli che utilizzano screen reader e quelli con viewport di piccole dimensioni, potrebbero non visualizzare le istruzioni del modulo o persino l'etichetta del controllo del modulo. Inoltre, l'attributo autofocus non altera l'ordine di navigazione sequenziale dello stato attivo del documento. Gli elementi della sequenza che precedono l'elemento con messa a fuoco automatica vengono ignorati. Per questi motivi, ti consigliamo di evitare di utilizzare l'attributo autofocus.
L'eccezione al consiglio "non utilizzare autofocus" è l'inclusione dell'attributo autofocus all'interno degli elementi <dialog>. Quando viene aperta una finestra di dialogo, il browser si concentra automaticamente sul primo elemento interattivo attivabile all'interno di <dialog>, il che significa che non è necessario aggiungere autofocus a un elemento. Se vuoi assicurarti che un elemento interattivo specifico all'interno della finestra di dialogo riceva lo stato attivo quando si apre la finestra di dialogo, aggiungi l'attributo autofocus a quell'elemento.
<dialog open>
<form method="dialog">
<button type="submit" autofocus>close</button>
</form>
</dialog>
L'attributo autofocus impostato sul pulsante di chiusura <button> consente di attivare lo stato attivo quando viene aperta la finestra di dialogo. Essendo il primo elemento della finestra di dialogo, avrebbe ricevuto lo stato attivo in ogni caso. Per impostazione predefinita, quando viene aperta una finestra di dialogo, il primo elemento attivabile al suo interno riceve lo stato attivo, a meno che un altro elemento al suo interno non abbia l'attributo autofocus impostato.
Rendi inerti gli elementi interattivi
Esistono anche attributi HTML che possono rimuovere elementi interattivi dalla sequenza di tabulazione. L'inclusione di un tabindex negativo agli elementi attivabili, l'aggiunta dell'attributo disabled ai controlli dei moduli di supporto e l'aggiunta dell'attributo inert globale a un contenitore rendono tutti gli elementi non selezionabili con il tasto Tab. Questi tre attributi sono completamente separati e non sono intercambiabili.
Valore tabindex negativo
Un attributo tabindex con un valore negativo rende un elemento attivabile, ma non
tabulabile. Sebbene l'aggiunta di tabindex="0" a un elemento attivabile per impostazione predefinita,
inclusi link, pulsanti, controlli dei moduli ed elementi contenteditable,
non sia necessaria, l'inclusione di un tabindex con un valore negativo rimuove gli elementi normalmente
tabulabili dall'ordine di navigazione sequenziale dello stato attivo.
Un valore tabindex negativo impedisce agli utenti che utilizzano la tastiera di attivare gli elementi interattivi, ma non li disattiva. Gli utenti che utilizzano il puntatore possono comunque impostare lo stato attivo sull'elemento. Per disattivare un elemento, utilizza l'attributo disabled.
Disabilitato
L'attributo booleano disabled rende non attivabili i controlli del modulo su cui viene applicato e i relativi discendenti, se presenti. I controlli dei moduli disattivati non possono essere selezionati, non ricevono eventi di clic e non vengono inviati al momento dell'invio del modulo.
disabled non è un attributo globale. Si applica a <button>, <input>,
<optgroup>, <option>, <select>, <textarea>, elementi personalizzati associati ai moduli
e <fieldset>.
Se impostato su <optgroup> o <fieldset>, tutti i controlli dei moduli secondari vengono disattivati, ad eccezione dei contenuti del primo <legend> di <fieldset>.
Gli stessi elementi che supportano disabled possono essere scelti come target anche con le pseudo-classi :disabled e :enabled. Gli elementi disattivati con l'attributo disabled sono
generalmente formattati in grigio chiaro con il foglio di stile dello user agent, anche se è impostato un
accent-color.
Essendo un attributo booleano, la presenza dell'attributo disattiva l'elemento altrimenti attivo; non puoi impostarlo su false. Per riattivare un elemento disattivato,
l'attributo deve essere rimosso, in genere con
Element.removeAttribute('disabled').
La proprietà HTMLInputElement.disabled consente di verificare se un input è disattivato. Poiché disabled non è un attributo globale, non viene ereditato da HTMLElement, ma ogni interfaccia degli elementi di supporto, come HTMLSelectElement, HTMLTextareaElement, ha la stessa proprietà di sola lettura.
L'attributo disabled non si applica agli elementi normalmente inert che vengono resi attivabili con tabindex o contenteditable, né all'elemento <form>. Per disattivare questi elementi, è possibile utilizzare l'attributo globale inert.
L'attributo inert
Quando l'attributo booleano globale inert viene aggiunto a un elemento, quest'ultimo e tutti i contenuti nidificati vengono disattivati, il che significa che non è possibile fare clic su di essi o spostarsi con il tasto Tab. Vengono inoltre rimossi dall'albero di accessibilità. Sebbene inert possa essere applicato a qualsiasi elemento, in genere viene utilizzato per sezioni di contenuti, ad esempio contenuti fuori schermo o altrimenti nascosti.
Quando applichi disabled ai controlli dei moduli, il browser fornisce uno stile predefinito e può essere personalizzato utilizzando la pseudoclasse :disabled. L'attributo inert non fornisce indicatori visivi e non ha una pseudo-classe corrispondente (anche se il selettore di attributi [inert] corrisponde).
L'utilizzo di inert su contenuti visibili senza stili che indicano l'inerzia può
comportare un'esperienza utente scadente. Poiché i contenuti inerti non sono disponibili per gli utenti di screen reader, possono generare confusione quando gli utenti di screen reader vedono sullo schermo contenuti non disponibili per gli strumenti di accessibilità. Rendi l'inerzia molto evidente con CSS.
Assicurati che lo stato attivo non si sposti mai su contenuti non visibili. Tutto ciò che viene visualizzato fuori schermo e non viene visualizzato automaticamente quando viene attivato lo stato attivo deve essere reso inerte. Se i contenuti sono nascosti, ma diventano visibili quando sono attivi, come un link per passare ai contenuti, non è necessario renderli inerti.
Mettiti alla prova
Metti alla prova le tue conoscenze sulla messa a fuoco.
Se un elemento non può essere impostato come attivo, come viene descritto?
Cosa è vero se l'elemento ha un attributo disabled?