Modifica la soglia di accessibilità (A11y)
Come modificare la soglia a11y per personalizzare il modo in cui la tua organizzazione gestisce i problemi di accessibilità
In questo articolo viene illustrata la soglia di accessibilità (a11y) e come modificare i criteri utilizzati da axe Developer Hub per calcolare la soglia a11y.
Cos'è la soglia A11y?
La soglia a11y riflette la tolleranza della tua organizzazione per gli errori di accessibilità ed è un numero calcolato in base a due criteri:
- Se il calcolo utilizza tutti i problemi di accessibilità rilevati da axe Developer Hub durante le esecuzioni di test o solo i nuovi problemi scoperti nell'ultima esecuzione di test.
- Quali impatti (critici, gravi, moderati e minori) saranno inclusi nel calcolo della soglia.
Se modifichi uno qualsiasi dei criteri per la soglia a11y, la modifica riguarda solo i calcoli futuri e non quelli passati; i valori della soglia a11y più vecchi non vengono ricalcolati. Accanto al calcolo apparirà un'icona per indicare che la configurazione è cambiata e, se passi il cursore sopra, ti verrà ricordato che la soglia è cambiata:
La soglia di accessibilità ti consente di personalizzare axe Developer Hub in base a ciò che conta per la tua organizzazione:
- I nuovi problemi sono la preoccupazione principale della tua organizzazione o vuoi monitorare tutti i problemi?
- Quali impatti sono importanti per la tua organizzazione?
Ad esempio, potresti essere interessato solo ad attenuare i problemi critici, oppure potresti essere interessato solo ad affrontare sia i problemi critici che quelli gravi. Forse la tua organizzazione ha appena iniziato ad affrontare i problemi di accessibilità e quindi devi limitarne l'impatto per evitare di rimanerne sopraffatto. In seguito, man mano che la tua organizzazione acquisirà maggiori conoscenze su come mitigare i problemi di accessibilità, potrai aggiungere impatti gravi (oppure moderati o minori).
Come viene utilizzata la soglia A11y?
La soglia a11y fornisce una rapida valutazione della qualità dell'accessibilità del tuo progetto e appare in modo evidente in tutto il sito axe Developer Hub. Qualsiasi valore superiore a zero supera la soglia di accessibilità consentita e indica problemi che devono essere risolti. Nel tempo puoi monitorare la soglia di accessibilità da un commit all'altro e da una versione all'altra per avere un quadro dello stato di accessibilità del tuo progetto.
Le pagine seguenti mostrano la soglia di accessibilità:
- Rami pagina
- Commit pagina
- Esecuzioni di test pagina
- Problemi pagina
L'esempio seguente mostra come la soglia a11y calcolata viene visualizzata nella sezione sinistra di ciascun pannello (qui, ci sono due problemi oltre la soglia):
Facendo clic sul valore soglia a11y (in questo caso, 2) gli impatti vengono aggiunti al filtro, in modo da poter analizzare solo i problemi che hanno causato il superamento della soglia a11y. (In questo caso, cliccando su 2 tutti gli effetti sono stati aggiunti al filtro perché erano tutti impostati nella configurazione dell'accessibilità.)
Come cambiare
Nella pagina del tuo account axe Account page fare clic sulla scheda CONFIGURAZIONE in cima alla pagina:
Verrà visualizzata la pagina Configurazione. Seleziona axe Developer Hub dall'elenco sul lato sinistro della pagina per visualizzare la configurazione della soglia di accessibilità:
I titolari di conti individuali possono modificare i criteri di soglia a11y, ma se fai parte di un'azienda, devi essere un amministratore aziendale per poterli modificare.
Il cambio della soglia a11y come amministratore dell'azienda comporterà la modifica per tutti gli utenti dell'azienda.
Dopo aver modificato le impostazioni della soglia a11y, fare clic su SALVA.
Non è possibile rimuovere critico dalla lista di impatti perché i problemi critici comportano il blocco dei contenuti per le persone con disabilità e impediranno loro di accedere a funzionalità o contenuti fondamentali.
Problemi inclusi
Il valore Problemi inclusi indica se includerli nel calcolo della soglia
- tutti i problemi di accessibilità che rispondono ai criteri di gravità selezionati o
- solo quelli nuovi .
Gravità incluse
Il valore gravità incluse indica quale livello o livelli di gravità includere nel calcolo.
Nell'implementazione attuale, le impostazioni della soglia a11y sono completamente indipendenti dalle impostazioni di accessibilità globali (nella scheda Globale nella pagina Configurazione ) (ma ciò potrebbe cambiare in futuro). La modifica delle impostazioni nella scheda Globale non modificherà la soglia di accessibilità (o viceversa).
Utilizzo della soglia di accessibilità con l'azione GitHub
È possibile utilizzare la soglia a11y con l'azione GitHub axe Developer Hub per fungere da gatekeeper e bloccare, per impostazione predefinita, le richieste pull che contengono problemi di accessibilità che superano la soglia a11y. L'azione aggiungerà un commento alla richiesta pull indicando il problema:
Nell'esempio di commento richiesta pull riportato sopra, il collegamento indirizza alla pagina Problemi sul sito Web di axe Developer Hub per visualizzare i problemi che hanno causato il fallimento di questa richiesta pull. È anche possibile modificare il comportamento predefinito in modo che gli utenti vengano solo avvisati dei problemi di accessibilità, anziché impedire l'unione delle richieste pull.
Come funziona
L'azione GitHub interroga il server axe Developer Hub (tramite il suo endpoint REST) per l'ultimo commit associato a questa richiesta pull. Il servizio Web restituisce il numero di problemi di accessibilità determinato dalle impostazioni della soglia a11y. Per impostazione predefinita, qualsiasi numero di errori di accessibilità superiore a zero viene considerato un errore, che determina l'aggiunta di un commento come quello sopra riportato alla pull request e impedisce l'unione della pull request.
Per ulteriori informazioni, vedere Utilizzo dell'azione GitHub .