Utilizzo dei Risultati di Accessibilità con Java

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Informazioni sul formato dei risultati di accessibilità

Not for use with personal data

Esistono praticamente infiniti modi per sfruttare i risultati di una scansione di Axe DevTools

Tutte le scansioni di accessibilità guidate da axe-core possono essere configurate per restituire i risultati come un oggetto JSON. Questo formato è facile da utilizzare per i nuovi arrivati all'accessibilità web, contiene la profondità di informazioni di cui hanno bisogno gli esperti del settore e consente la generazione automatica di report e test personalizzati anche al di fuori di un formato di test basato su asserzioni standard.

Generazione dell'oggetto dei risultati

Per generare l'oggetto dei risultati, vedere Generare report con Java

Panoramica dei Risultati

Risultati

L'inizio dei risultati è segnato dall'intestazione "risultati". Ci sono quattro tipi di risultati, ognuno con il proprio array. Questi tipi di risultati sono non applicabile, incompleto, superato, e violazione. Inoltre, ci sono alcuni dati specifici del test immediatamente prima dell'array delle violazioni.

Non applicabile

Non applicabile significa che non c'era contenuto di pagina rilevante per quel particolare test, come i test relativi ai form su una pagina senza moduli.

Incompleto

Incompleti sono test che sono stati eseguiti, ma i risultati richiedono ulteriore revisione per determinare a quale categoria appartengano i risultati. Un caso comune di incompleto si verifica con i controlli di contrasto del colore su elementi con sfondi di colore variabile dove non è sempre chiaro se sia soddisfatto un contrasto sufficiente. I problemi in questa categoria non dovrebbero essere automaticamente trattati come violazioni, poiché potrebbero esserlo o meno. Per gli utenti con più conoscenze sull'accessibilità, un esame più approfondito di questi risultati può aiutare a trovare violazioni aggiuntive che non possono essere testate automaticamente.

Superati

Questo gruppo di risultati enumera le regole che sono state controllate e non ha trovato nessuna violazione di accessibilità correlata. Associato a ciascuna regola superata ci sarà un array di elementi della pagina che sono stati controllati rispetto alla regola e superati.

Violazioni

L'array delle violazioni contiene tutte le violazioni dell'accessibilità trovate nella scansione. Grazie alla politica di zero falsi positivi di Deque, qualsiasi risultato trovato qui è garantito essere genuino. Ogni violazione contiene ulteriori informazioni su quale sia la violazione, dove si trovi nella pagina, suggerimenti su come risolverla e altro. Consultare la seguente riferimento di campo per ulteriori informazioni.

Riferimento di Campo - Superati e Violazioni

description — Stringa di testo che descrive cosa fa la regola
help — Testo di aiuto che descrive il test eseguito
helpUrl — URL che fornisce maggiori informazioni sui dettagli della violazione. Collega a una pagina del sito Deque University.
id — Identificatore univoco per la regola; vedi l'elenco delle regole.
impact — Quanto è grave la violazione. Può essere minore, moderata, seria o critica se il test è fallito, oppure nullo se il controllo è superato
tags — Array di tag assegnati a questa regola. Questi tag possono essere utilizzati nella struttura delle opzioni per selezionare quali regole vengono eseguite.
nodes — Array di tutti gli elementi testati dalla Regola
- html — Frammento di HTML dell'elemento
- impact — Quanto è grave la violazione. Può essere minore, moderata, seria o critica se il test è fallito, oppure nullo se il controllo è superato
- target — Array di selettori che ha ciascun elemento corrispondente a un livello di iframe o frame. Se c'è un iframe o frame, dovrebbero esserci due voci in target. Se ci sono tre livelli di iframe, dovrebbero esserci quattro voci in target.
- any — Array di controlli effettuati in cui almeno uno deve essere superato. Ogni voce dell'array contiene:
- id — Identificatore univoco per questo controllo. Gli id di controllo possono essere gli stessi degli id di Regola
- impact — Quanto è grave questo particolare controllo. Può essere minore, moderata, seria o critica. Ogni controllo che fa parte di una regola può avere impatti diversi. L'impatto più alto di tutti i controlli che falliscono è riportato per la regola
- message — Descrizione del perché questo controllo è superato o fallito
- data — Ulteriori informazioni che sono specifiche per il tipo di Controllo, che è facoltativo. Ad esempio, un controllo di contrasto del colore includerebbe il colore del primo piano, il colore di sfondo, il rapporto di contrasto, ecc.
- relatedNodes — Array opzionale di informazioni su altri nodi correlati a questo controllo. Ad esempio, una violazione del controllo di id duplicato elencherebbe gli altri selettori che avevano lo stesso id duplicato. Ogni voce dell'array contiene le seguenti informazioni:
  - target — Array di selettori per il nodo correlato
  - html — Sorgente HTML del nodo correlato
- all — Array di controlli effettuati in cui tutti devono essere superati. Ogni voce dell'array contiene le stesse informazioni dell'array any
- none — Array di controlli effettuati in cui tutti devono non essere superati. Ogni voce dell'array contiene le stesse informazioni dell'array any

Utilizzo dei Risultati

Deque rende semplice condividere e comprendere i risultati delle tue scansioni con il nostro reporter. È configurabile per produrre report in formato HTML, XML JUnit o CSV e, una volta configurato, restituisce report automaticamente. Vedere la guida sui report per imparare come configurare e utilizzare il reporter.

Inoltre, l'oggetto dei risultati JSON facilita la scrittura dei tuoi test personalizzati. Oltre alle asserzioni standard sulle violazioni dell'accessibilità, puoi suddividere l'oggetto dei risultati per violazioni, la loro gravità, il loro impatto, il set di regole associato o qualsiasi altro parametro presente nell'oggetto dei risultati. Qualsiasi dato riportato nell'oggetto dei risultati può quindi essere testato.