Modificare la Soglia di Accessibilità (A11y)
Personalizza e prioritizza come la tua organizzazione affronta i problemi di accessibilità
A11y è un'abbreviazione basata su numeri (o numeronimo) per la parola „accessibilità“, con „11“ (undici) che rappresenta il numero di caratteri tra l'inizio „a“ e la fine „y“ in accessibilità. Continua a leggere per saperne di più sulla soglia a11y e sui criteri che Axe Developer Hub utilizza per il suo calcolo.
Cos'è la Soglia A11y?
La soglia a11y riflette la tolleranza della tua organizzazione verso gli errori di accessibilità, ed è un numero calcolato sulla base di due criteri:
- Se il calcolo utilizza tutti problemi di accessibilità trovati da Axe Developer Hub durante le esecuzioni del test o solo nuovi problemi scoperti nell'ultima esecuzione del test. (Il rilevamento di nuovi problemi è disponibile solo per i progetti web. Mobile in arrivo!)
- Quali livelli di impatto (Critico, Grave, Moderato e Minore) saranno inclusi nel calcolo della soglia.
Se modifichi uno qualsiasi dei criteri per la soglia a11y, la modifica solo influisce sui calcoli futuri. I vecchi valori della soglia a11y non sono ricalcolati. Apparirà un'icona accanto al calcolo per indicare che la configurazione è cambiata, e se passi il cursore sopra di essa, vedrai un promemoria che la soglia è cambiata:
La soglia a11y ti consente di personalizzare Axe Developer Hub in base a ciò che conta per la tua organizzazione. Sono i nuovi problemi la principale preoccupazione della tua organizzazione, o vuoi monitorare tutti i problemi? Quali livelli di impatto dovrebbero essere prioritizzati?
Ad esempio, il focus attuale della tua organizzazione può essere solo sulla mitigazione dei problemi critici, oppure il tuo obiettivo può essere di risolvere entrambi problemi critici e gravi. Se la tua organizzazione sta appena iniziando ad affrontare i problemi di accessibilità, potresti aver bisogno di limitare i livelli di impatto prioritizzati per non essere sopraffatto. In seguito, man mano che aumenta la conoscenza della tua organizzazione sulla mitigazione dei problemi di accessibilità, puoi modificare la soglia a11y per includere problemi di accessibilità con impatto minore.
Come Viene Utilizzata la Soglia A11y?
La soglia a11y fornisce un rapido indicatore della qualità dell'accessibilità del tuo progetto e appare in modo prominente mentre ti addentri per identificare i problemi in Axe Developer Hub. Qualsiasi valore sopra zero supera la soglia di accessibilità consentita e indica problemi che devono essere affrontati. Nel tempo, puoi tracciare la soglia di accessibilità da commit a commit, e da rilascio a rilascio, per sviluppare un quadro della salute dell'accessibilità del tuo progetto.
Nell'esempio sotto, puoi vedere la soglia a11y calcolata nella sezione sinistra di ogni pannello. Qui, il valore di 2 indica due problemi che superano la soglia corrente:
Cliccando sul valore della soglia a11y - qui, 2 - si aggiungono al filtro i problemi con i corrispondenti livelli di impatto, così puoi concentrarti solo sui problemi che hanno superato la soglia a11y. (In questo caso, cliccando su 2 si aggiungono tutti i problemi al filtro, perché tutti erano impostati nella configurazione a11y.)
Configura la Soglia A11y
Solo gli amministratori possono modificare i criteri della soglia a11y. Farlo comporterà un cambiamento per tutti gli utenti dell'impresa.
Sulla tua pagina Account Axe clicca sulla scheda CONFIGURATION in cima alla pagina. Nella pagina di configurazione, seleziona Axe Developer Hub dall'elenco a sinistra per visualizzare e modificare la configurazione della soglia a11y.
Dopo aver modificato le impostazioni della soglia a11y, clicca su SALVA.
Problemi Inclusi
Il valore Problemi Inclusi indica se includere nel calcolo della soglia tutti i problemi di accessibilità che soddisfano gli impatti selezionati, oppure solo i nuovi problemi di accessibilità. Nuovi problemi di accessibilità sono quelli rilevati nella tua scansione attuale che non sono stati trovati nella scansione a cui è confrontata - se si tratta dell'esecuzione del test precedente, il commit precedente o l'ultima scansione sul ramo predefinito. Il valore mostrato per la soglia a11y sarà coerente su tutte le pagine quando impostato per includere tutti i problemi. Quando impostato per guardare solo ai nuovi problemi, il valore può variare per pagina, poiché ogni pagina confronta la sua scansione con un diverso punto di riferimento.
Nota: Il rilevamento di nuovi problemi è disponibile solo per i progetti web. Mobile in arrivo.
Impatto Incluso
Il valore Impatto Incluso indica quale livello di impatto o livelli includere nel calcolo. I problemi con Critico impatto non possono essere deselezionati, poiché questi problemi bloccano completamente gli utenti con disabilità dall'accesso o dall'interazione con una funzione su una pagina web o un'app mobile. Scopri di più su tutti i livelli di impatto.
Utilizzare la Soglia A11y con la GitHub Action
Quando si utilizza il Axe Developer Hub GitHub Action per i progetti web, la soglia a11y funziona come un guardiano per bloccare le pull request che contengono problemi di accessibilità. L'azione aggiungerà un commento alla pull request indicando il problema:
Nell'esempio sopra, il commento della pull request collega a una pagina sul sito Axe Developer Hub dove puoi visualizzare un elenco dei problemi non superati. Puoi modificare il comportamento predefinito dell'Action di GitHub per avvisare solo gli utenti di problemi di accessibilità invece di bloccare la fusione della pull request.
Come Funziona
L'Action di GitHub interroga il server Axe Developer Hub (tramite il suo endpoint REST) per l'ultimo commit associato alla pull request. Il servizio web restituisce il numero di problemi di accessibilità determinato dalle impostazioni della soglia a11y. Qualsiasi numero di errori di accessibilità superiore a zero è considerato un fallimento, il che aggiunge un commento alla pull request e può bloccarne la fusione.
Consulta Utilizzare l'Action di GitHub per ulteriori informazioni.