Glossario

a11y

Un'abbreviazione per accessibilità: interpretata come la lettera a seguita da 11 caratteri e poi la lettera y.

Agora

Agora è il repository interno di Deque per gli artefatti. Si basa su un'istanza Artifactory. Attraverso Agora, gli utenti possono scaricare componenti di Axe DevTools, gestire e distribuire set di regole personalizzati e altro.

Chiave API

Una chiave API autorizza la CLI, Axe Watcher, o le API web a inviare i risultati di accessibilità ad Axe Developer Hub o Axe Reports. Tratta la tua chiave API come una credenziale segreta: non commetterla nel controllo di versione o condividerla, e conservala in una variabile di ambiente o nel gestore di segreti della tua piattaforma CI/CD.

ARIA

Accessible Rich Internet Applications (ARIA) è una specifica tecnica pubblicata dal World Wide Web Consortium, o W3C, che definisce modi per aumentare l'accessibilità delle pagine web, in particolare, i contenuti dinamici e i componenti dell'interfaccia utente sviluppati con Ajax, HTML, JavaScript e tecnologie correlate.

Tecnologia Assistiva

Alcuni individui con disabilità potrebbero non essere in grado di interagire autonomamente con il software e i siti web. Queste persone necessitano di tecnologie assistive per utilizzare Internet in modo equo. Una forma molto comune di tecnologia assistiva è uno screen reader. Questi dispositivi leggono il testo sullo schermo ad alta voce per persone con bassa visione o cieche. Esistono molti screen reader diversi a seconda della piattaforma. Alcuni esempi sono NVDA o JAWS su PC, VoiceOver su Mac o TalkBack su Android.

Migliori Pratiche

Le migliori pratiche di Deque sono tecniche collaudate che offrono risultati di accessibilità desiderati quando mancano o sono insufficienti metodi formali specifici. Sebbene non siano ufficialmente incluse in nessun set di regole di accessibilità stabilito, seguire le migliori pratiche di Deque può migliorare l'accessibilità e la qualità complessiva della pagina web testata. È importante notare che la non conformità alle linee guida sulle migliori pratiche di Deque non indica automaticamente un fallimento. Inoltre, è necessario un giudizio esperto per valutare l'idoneità nel contesto degli obiettivi dell'applicazione, del sito o della pagina. A volte la tecnica di accessibilità delle migliori pratiche non è applicabile o pratica per risolvere un problema specifico. Vedere Migliori Pratiche per le regole che costituiscono il set di regole delle migliori pratiche.

Piattaforma di Automazione del Browser

Per Axe Watcher, un piattaforma di automazione del browser è un framework che usi per automatizzare i test del tuo sito web. Le piattaforme includono Cypress, Playwright, Puppeteer, WebdriverIO e WebDriverJS. Per maggiori informazioni, vedere

• Cypress
• Playwright o Playwright Test
• Puppeteer
• WebdriverIO o WebdriverIO Testrunner
• WebDriverJS

Checkpoint

Un metodo comprovato per il test dei requisiti di accessibilità creato dal team di esperti a11y di Deque che aumenta la coerenza e l'accuratezza dei risultati dei test. Basati sui Criteri di Successo WCAG, forniscono una categorizzazione e un'interpretazione più esplicita di quelle linee guida, in cui le violazioni sono tipicamente separate per tipo di contenuto. I Checkpoint di Deque aiutano i revisori a produrre risultati di test coerenti e accurati durante le valutazioni di accessibilità. Un checkpoint si riferisce alla sezione più rilevante e applicabile dell'elenco principale dei Checkpoint di Deque (e dei loro requisiti) che sono una parte importante del metodo Deque per l'uguaglianza digitale.

Test dei Componenti

Con Cypress o Playwright e Axe Watcher, puoi testare singoli componenti (come componenti React) isolatamente. Contrasta questo con Test e2e, che testa l'intera applicazione web nella sua implementazione reale. Axe Developer Hub può rilevare problemi di accessibilità in scenari end-to-end e può testare componenti isolatamente con Cypress. Vedi Test e2e.

Override di Configurazione

Un override di configurazione ti consente di personalizzare le impostazioni per specifici test utilizzando la proprietà configurationOverrides (JavaScript/TypeScript) o Classe ConfigurationOverrides (Java) nella configurazione del test. Queste modifiche devono rispettare le impostazioni di configurazione globale della tua organizzazione e possono includere modifiche agli standard di accessibilità, migliori pratiche, regole sperimentali e versioni axe-core.

Set di Regole Personalizzate

Un set di regole personalizzato è costruito da un file JSON contenente dati di regole (regole e controlli) passati ai componenti di Axe DevTools per aggiungere nuove regole, cambiare la gravità/l'impatto di una regola o rimuovere una regola dal test.

Duplicato

Un duplicato è lo stesso problema di accessibilità visto sullo stesso nodo del document object model (DOM) in più stati della pagina. Se risolvi un problema con duplicati, tutti i suoi duplicati scompariranno perché sono tutti lo stesso problema.

Due risultati sono considerati lo stesso problema quando tutte e tre le seguenti condizioni coincidono:

• La regola che è stata violata.
• L'elemento. Axe Developer Hub identifica l'elemento tramite il suo selettore CSS e il suo XPath, oltre che tramite il suo selettore di ascendenza quando ancestry è abilitato. Una corrispondenza con uno qualsiasi di questi è sufficiente.
• L'URL della pagina, confrontato integralmente, inclusa qualsiasi stringa di query.

Nient'altro viene confrontato. In particolare, il titolo della pagina e l'HTML dell'elemento non hanno alcun effetto sul fatto che un risultato sia trattato come duplicato.

Lo stesso confronto determina se un problema è nuovo: un risultato che non corrisponde a nulla nel baseline applicabile è conteggiato come nuovo. Questo significa che, se l'URL di una pagina o i suoi selettori di elementi cambiano tra le scansioni, lo stesso problema sottostante viene riportato come nuovo ogni volta. Vedi Uso di Selettori Dinamici per come correggere questo.

Test e2e

Il testing end-to-end, o e2e, si riferisce al test della funzionalità dell'intera applicazione web testando la sua implementazione reale. Con Axe Developer Hub, puoi testare scenari e2e per problemi di accessibilità e testare singoli componenti isolatamente con Cypress. Vedi anche Test dei Componenti.

Evento

Per tracciare l'uso dell'API o della CLI, la libreria di metriche crea eventi e li invia al servizio di utilizzo. Gli eventi contengono informazioni sull'uso come il numero di regole di accessibilità violate durante una scansione della pagina web e la data e l'ora in cui è stata completata una scansione di accessibilità.

Regole sperimentali

Regole sperimentali sono ancora in fase di sviluppo e test per affrontare nuove tecnologie o una maggiore comprensione e consapevolezza delle problematiche di accessibilità. Queste regole non dovrebbero essere utilizzate in ambienti di produzione poiché sono ancora in sviluppo e soggette a falsi positivi. Infine, le regole in questo insieme di regole potrebbero diventare parte degli standard di accessibilità. Le regole sperimentali sono disabilitate per impostazione predefinita. Vedi Regole sperimentali per le regole che compongono questo insieme nella versione più recente di axe-core.

Flush

La funzione flush scrive i risultati dei tuoi test Axe Watcher al server Deque ed è necessaria per assicurarsi che i risultati siano registrati da Axe Developer Hub. Devi chiamare la funzione flush nel tuo suite di test.

Gitless

Gitless è una delle due forme di dati a cui un progetto Developer Hub può bloccarsi: la suite di test del progetto non utilizza un repository Git. Un progetto si blocca su Gitless o su Git, in base alla sua prima sessione di successo; un'esecuzione successiva con l'altra forma di dati viene rifiutata piuttosto che accettata. Non è necessario utilizzare un repository Git, ma un repository Git permette di associare i difetti di accessibilità a modifiche specifiche del codice, facilitandone la risoluzione. Vedi Blocco del Progetto.

Configurazione globale

Configurazione globale fa parte di Configurazione di Axe che ti consente di impostare varie opzioni in un unico posto da condividere tra i diversi prodotti Deque. Il tuo amministratore può permettere che determinate impostazioni vengano modificate dagli utenti.

Token di Identità

Un Token di Identità è un token di sicurezza emesso da JFrog che ti consente di accedere al repository di artefatti Agora di Deque. I Token di Identità devono essere copiati al momento della creazione poiché questa è l'unica opportunità per accedervi. Scadono dopo un intervallo di tempo designato, tipicamente un anno.

Impatto

A ogni violazione dell'accessibilità viene assegnato un livello di impatto. L'impatto è una metrica utile quando si devono stabilire le priorità degli sforzi di rimedio. Per impostazione predefinita, a ogni tipo di violazione viene assegnato un livello di impatto dagli esperti di accessibilità Deque. Questi valori sono generalizzati per la maggior parte delle situazioni, quindi gli utenti possono usare il loro giudizio per modificarli come parte della personalizzazione del set di regole. I livelli di impatto serio o critico sono correlati con utenti disabili che incontrano barriere d'uso significative o insormontabili. Questi comportano il più alto grado di responsabilità legale. I problemi minori e moderati non sono così gravi, ma rappresentano comunque questioni importanti per gli utenti disabili e richiedono attenzione affinché la pagina sia completamente conforme. I seguenti quattro livelli sono usati per categorizzare l'impatto dei problemi di accessibilità rilevati:

• Critico: Questo livello di impatto significa che gli utenti con disabilità saranno completamente bloccati dall'accedere o interagire con una funzionalità sulla pagina web. Fino a quando non verrà implementata una soluzione, il contenuto sarà totalmente inaccessibile. Questo rende la tua organizzazione altamente vulnerabile a cause legali. La risoluzione dei problemi critici dovrebbe essere una priorità assoluta.

• Grave: Questo livello di impatto significa che gli utenti con disabilità affronteranno barriere gravi durante l'interazione con il sito. Questi utenti sperimenteranno una significativa frustrazione nel tentativo di accedere al contenuto correlato. Fino a quando non verrà implementata una soluzione, alcuni contenuti saranno difficili o impossibili da accedere, rendendo la tua organizzazione vulnerabile a azioni legali. La risoluzione dovrebbe essere una priorità elevata.

• Moderato: Questo livello di impatto significa che esistono alcune barriere per gli utenti con disabilità, ma non impedirebbero loro di accedere ai flussi o contenuti di base. I problemi con impatto a questo livello potrebbero rendere la tua organizzazione vulnerabile a azioni legali. Richiedono una risoluzione prima che una pagina sia completamente conforme e dovrebbero essere risolti.

• Minore: Un problema che comporta meno impatto per gli utenti disabili rispetto a un problema moderato. Il problema può avere una priorità inferiore rispetto ai problemi moderati, gravi e critici, ma richiede comunque una risoluzione affinché una pagina sia completamente conforme.

Incompleto

Un risultato incompleto significa che axe-core non ha potuto determinare con certezza assoluta se qualcosa sia una violazione, quindi è necessario un controllo umano. Poiché axe-core mira a zero falsi positivi, segnala solo le questioni di cui è sicuro come violazioni e registra separatamente tutto ciò che è incerto. Incompleto e ha bisogno di revisione sono due nomi per lo stesso tipo di risultato; quale vedrai dipende dal componente di Axe DevTools che stai utilizzando. Un risultato incompleto può o non può rivelarsi un problema di accessibilità.

Test guidato intelligente (IGT)

Intelligent Guided Testing (IGT) è un componente di test dell'accessibilità interattivo delle estensioni del browser web Axe DevTools progettato per trovare errori di accessibilità che non possono essere rilevati nei test automatizzati. IGT pone domande semplici all'utente sulla pagina web in esame e utilizza questo feedback per individuare più errori di accessibilità di quanto sarebbe possibile con il solo test automatizzato. Per saperne di più sui Test Guidati Intelligenti, visita il Documentazione dei Test guidati intelligenti.

Problema

Una violazione delle linee guida sull'accessibilità (come definito da standard come WCAG 1.0, WCAG 2.0, Sezione 508 e WAI-ARIA) identificata nel codice di una pagina web o applicazione web.

Risultati di accessibilità JSON

Quando testi un sito web per problemi di accessibilità utilizzando le API di Axe DevTools o il CLI, i tuoi risultati vengono salvati come file JSON che vengono indicati nella documentazione come file risultati di accessibilità in formato JSON. Puoi caricare questo file in Axe Reports (che ti consente di monitorare l'accessibilità del tuo sito web nel tempo attraverso il sito web Axe Reports). Puoi anche filtrare e convertire localmente i risultati di accessibilità JSON in .csv, .xml o .html usando il CLI. Vedi Reporting con la CLI per ulteriori informazioni. In alternativa, le API ti consentono anche di convertire i file dei risultati di accessibilità JSON in rapporti durante un esecuzione di test (vedi Reportistica sotto per ulteriori informazioni).

Modalità manuale

Per impostazione predefinita, Axe Developer Hub analizza automaticamente ciascuna delle tue pagine web e le rianalizza ogni volta che rileva un nuovo stato della pagina. Puoi disabilitare questo comportamento automatico

• (JavaScript/TypeScript) Impostando la proprietà autoAnalyze sull'oggetto di configurazione axe a false.
• (Java) Chiamando il metodo setAutoAnalyze() con false.

Puoi anche sovrascrivere il comportamento di analisi automatica

• (JavaScript/TypeScript) Chiamando il metodo stop().
• (Java) Chiamando il metodo AxeWatcherController.stop().

In entrambi i casi, ciò mette il Watcher in modalità manuale. In modalità manuale, le pagine vengono analizzate solo quando si chiama il metodo analyze().

Libreria di Metriche

Una libreria interna utilizzata dalle API e dalla CLI di Deque per riportare le informazioni di utilizzo al servizio di utilizzo.

Suite di Test Modificata

Un suite di test modificata è una suite di test che hai modificato secondo le istruzioni fornite da Axe Developer Hub quando hai creato un nuovo progetto. Modificare la tua suite di test ti consente di aggiungere test di accessibilità alla tua suite di test esistente con modifiche minime alla suite stessa.

Richiede Revisione

Un problema richiede l'ispezione da parte di un essere umano per determinare se sia effettivamente una violazione degli standard di accessibilità. Ha bisogno di revisione significa la stessa cosa di incompleto: axe-core non è stato in grado di stabilire con certezza assoluta se il problema fosse una violazione. Se sei nuovo nei test di accessibilità o stai lavorando su un sito con molti problemi noti, affronta prima le violazioni. Quando arrivi ai risultati che richiedono revisione, consulta un esperto di accessibilità digitale prima di decidere se correggerli o ignorarli.

Stato della Pagina

Il stato della pagina di una pagina web si riferisce allo stato del suo modello a oggetti del documento (DOM) in un momento specifico. Gli stati della pagina sono utili per siti complessi con schermate di accesso o interfacce dinamiche come le applicazioni a pagina singola (SPA). Esempi di stato del DOM includono:

• La visibilità degli elementi
• Il contenuto degli elementi
• Lo stato selezionato dei pulsanti radio e delle caselle di controllo

Il pacchetto Watcher riscansiona le pagine web quando rileva cambiamenti nel DOM e salva un nuovo stato della pagina ogni volta.

Progetto

Un progetto in Axe Developer Hub contiene risultati di accessibilità, informazioni sull'esecuzione del test e dati Git (rami e commit). L'associazione tra queste informazioni e il progetto avviene tramite l'ID del progetto del progetto. Quando crei e nomini un nuovo progetto in Axe Developer Hub, viene generato un ID progetto che utilizzi con i tuoi test per identificare il progetto.

Reportistica

Il reporting si riferisce al caricamento di un file risultati di accessibilità in formato JSON su Axe Reports o alla sua conversione locale in un report (un file .csv, .xml o .html) per l'uso in un'altra applicazione.

RGAA

RGAA, o Référentiel Général d'Amélioration de l'Accessibilité, è lo standard francese per l'accessibilità web. È in gran parte basato su WCAG 2.1 e fornisce criteri tecnici specifici per valutare l'accessibilità dei contenuti web. La versione attualmente supportata è RGAA 4, identificata dall'ID del set di regole rgaav4.

Regola

Una regola corrisponde ai criteri di successo di una linea guida per l'accessibilità. Sono definite da file JSON che contengono un ID, una descrizione e metadati di aiuto, così come uno o più controlli e parametri opzionali.

Sezione 508

Un emendamento alla Legge di Riabilitazione degli Stati Uniti del 1973 che richiede alle agenzie federali di rendere accessibili le loro tecnologie elettroniche e informative alle persone con disabilità. Comprende sedici disposizioni basate su linee guida di accesso sviluppate dalle Web Content Accessibility Guidelines (WCAG) sviluppate dal World Wide Web Consortium (W3C), ma non sono identiche né agli standard WCAG 1.0 né 2.0.

SHA

Quando crei un commit Git, viene generato un ID che identifica univocamente il commit. L'ID unico è chiamato SHA (un acronimo per Secure Hash Algorithms, un gruppo di funzioni di hash crittografiche).

Servizio di Utilizzo

Un servizio web REST che registra le metriche di utilizzo per Axe DevTools per Web (API e CLI). È il servizio disponibile pubblicamente fornito da Deque o il tuo servizio. Per maggiori informazioni, vedere Servizio di Utilizzo di Axe DevTools per Web.

Violazione

Un problema identificato da Axe DevTools che viola uno o più standard di accessibilità.

Watcher

Il componente di codice che integri nella tua suite di test è chiamato Watcher. Deque fornisce diverse edizioni del pacchetto per i linguaggi supportati e i framework di test. Integra il pacchetto Watcher nella suite di test del tuo sito web per analizzare le pagine web e riportare i risultati ad Axe Developer Hub, dove puoi visualizzare i risultati. Il pacchetto Watcher esegue anche l'analisi del commit e del ramo Git corrente e associa a esso le esecuzioni dei test.

WCAG

WCAG, o Web Content Accessibility Guidelines, sono state sviluppate dal World Wide Web Consortium (W3C) e spiegano come rendere i contenuti Web più accessibili alle persone con disabilità. WCAG 1.0 è stata pubblicata a maggio 1999. WCAG 2.0 è stata pubblicata a dicembre 2008. WCAG 2.0 si applica ampiamente a tecnologie più avanzate ed è più precisamente testabile con test automatizzati e valutazioni umane. WCAG 2.1 è stata pubblicata a giugno 2018. Queste linee guida contengono criteri di successo che definiscono criteri testabili per elementi specifici. WCAG 2.2, l'iterazione più recente delle linee guida, è stata pubblicata nel 2023 e offre nove nuovi criteri di successo rispetto a WCAG 2.1.

Wrapping

Wrapping si riferisce alla modifica di una piattaforma di automazione del browser (come Cypress) per richiamare il codice di test di accessibilità (nel pacchetto Watcher) ogni volta che viene chiamata una funzione della piattaforma di automazione del browser. Il wrapping ti permette di integrare i test di accessibilità nelle tue suite di test esistenti con modifiche minime al tuo codice.