Glossario

a11y

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

Agora

Agora è il repository interno di artefatti di Deque. È basato su un'istanza di Artifactory. Attraverso Agora, gli utenti possono scaricare i componenti di Axe DevTools Linter e il binario del Connector.

Chiave API

Una chiave API autorizza l'uso del servizio di linting SaaS ospitato da Deque o del linting locale. Gestisci le tue chiavi API tramite Impostazioni account Axe. Vedi Ottenere una chiave API per Axe DevTools Linter SaaS per maggiori informazioni.

ARIA

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

Best Practices

Le best practices di Deque sono tecniche collaudate che offrono risultati di accessibilità desiderati quando specifici metodi formali mancano o sono insufficienti. Sebbene non siano ufficialmente incluse in alcun insieme di regole di accessibilità stabilite, seguire le best practices di Deque può migliorare l'accessibilità e la qualità complessiva del codice che scrivi. Va notato che la non conformità con le linee guida sulle best practice di Deque non indica automaticamente un fallimento. Inoltre, è necessario un giudizio esperto per considerare l'adeguatezza nel contesto degli obiettivi dell'applicazione, sito o pagina. Talvolta la tecnica di accessibilità delle best practice non è applicabile o pratica per risolvere un problema specifico.

CI/CD

CI/CD sta per integrazione continua e consegna continua (o distribuzione continua). Si riferisce a pipeline automatizzate che costruiscono, testano e rilasciano software. Connector di Axe DevTools Linter e GitHub Action si integrano nelle pipeline CI/CD per individuare problemi di accessibilità prima che il codice venga unito o distribuito.

Libreria di Componenti

Una libreria di componenti è una raccolta di componenti UI riutilizzabili. Axe DevTools Linter ha un supporto integrato per diverse librerie di componenti popolari, tra cui @mui/material, @deque/cauldron-react e react-native, e può analizzare i loro componenti come se fossero elementi HTML nativi. Vedi Librerie di Componenti Preconfigurate per maggiori informazioni.

Connettore

Il connettore (formalmente il Connector di Axe DevTools Linter) è uno strumento da riga di comando per Linux, macOS e Windows che fornisce un'interfaccia a riga di comando per analizzare i tuoi file. Puoi utilizzarlo per scripting e pipeline CI/CD. Vedi Utilizzo del Connector di Axe DevTools Linter per maggiori informazioni.

Componente Personalizzato

Un componente personalizzato è un componente UI che definisci o importi da una libreria di terze parti che non corrisponde direttamente a un elemento HTML nativo. Axe DevTools Linter può analizzare i componenti personalizzati mappandoli a elementi HTML nativi nella tua configurazione, permettendogli di applicare regole di accessibilità standard ai tuoi componenti. Vedi Analisi dei Componenti Personalizzati per maggiori informazioni.

Direttiva Inline

Una direttiva inline è un commento appositamente formattato aggiunto direttamente al codice sorgente per sopprimere una o più regole di Axe DevTools Linter per una linea specifica, un intervallo di linee o il resto di un file. Le direttive inline ti consentono di riconoscere violazioni note senza modificare la tua configurazione globale. Vedi Soppressione delle Regole di Analisi con Direttive Inline per maggiori informazioni.

Chiave di Licenza

Una chiave di licenza è un'alternativa a una chiave API per autenticare analisi locale con il Connector. A differenza di una chiave API, una chiave di licenza non richiede autenticazione remota e non segnala informazioni sull'uso. Devi richiedere una chiave di licenza da Help Desk di Deque. L'uso di una chiave di licenza richiede l'opzione --local del Connector.

Linter

Un linter è uno strumento che analizza automaticamente il codice sorgente per trovare problemi, inclusi errori di sintassi, incoerenze stilistiche e potenziali bug, senza eseguire il codice. Axe DevTools Linter è un linter di accessibilità: trova schemi nel codice sorgente che probabilmente causano problemi di accessibilità. Vedi Informazioni su Axe DevTools Linter.

Linting

Linting è il processo automatizzato di utilizzo di un linter per analizzare il codice sorgente alla ricerca di problemi. Axe DevTools Linter esegue un linting di accessibilità: controlla i tuoi file sorgenti rispetto alle regole di accessibilità di Deque e segnala eventuali pattern che potrebbero causare barriere di accessibilità. Vedi Informazioni su Axe DevTools Linter.

Linting locale

Linting locale è un'opzione per il Connettore che esegue un'analisi di accessibilità sulla macchina che esegue il Connettore, anziché inviare i tuoi file a un server. Il linting locale è più veloce ed evita dipendenze di rete. Richiede una chiave API o una chiave di licenza. Vedi Linting locale per maggiori informazioni.

In sede

In sede (anche in sede) si riferisce all'esecuzione del server Axe DevTools Linter all'interno della tua infrastruttura, anziché utilizzare il server SaaS ospitato nel cloud di Deque. Un'installazione in sede offre il pieno controllo sul server e mantiene il contenuto dei file all'interno della tua rete. Vedi Installazione e Sicurezza per maggiori informazioni.

Regola

Una regola è un controllo di accessibilità individuale che Axe DevTools Linter applica ai tuoi file sorgente. Ogni regola corrisponde a uno o più criteri delle linee guida di accessibilità ed è identificata da un ID di regola unico (ad esempio, image-alt o label). Le regole possono essere attivate, disattivate o impostate per segnalare avvisi tramite la tua configurazione. Vedi Regole di Accessibilità per l'elenco completo delle regole.

SaaS

SaaS (Software as a Service) si riferisce al server di Axe DevTools Linter ospitato nel cloud di Deque. Quando utilizzi il server SaaS, i tuoi file vengono inviati al server di Deque per l'analisi. L'uso di SaaS richiede una chiave API. Vedi Ottenere una chiave API SaaS per Axe DevTools Linter per maggiori informazioni.

Sezione 508

Un emendamento al Rehabilitation Act degli Stati Uniti del 1973 che richiede alle agenzie federali di rendere accessibile la loro tecnologia elettronica e informatica alle persone con disabilità. Comprende sedici disposizioni basate su linee guida sull'accesso sviluppate dalle Web Content Accessibility Guidelines (WCAG) sviluppate dal World Wide Web Consortium (W3C), ma non sono identiche agli standard WCAG 1.0 o 2.0.

Analisi statica

Analisi statica è l'esame del codice sorgente senza eseguirlo. Axe DevTools Linter utilizza l'analisi statica per rilevare problemi di accessibilità nelle prime fasi dello sviluppo, prima che il codice venga compilato, unito o distribuito. Poiché l'analisi statica non esegue la tua applicazione, non può rilevare ogni problema di accessibilità; alcuni problemi richiedono test basati su browser o manuali.

Tag

Un tag è un'etichetta che raggruppa le regole in base allo standard di accessibilità a cui corrispondono (ad esempio, wcag2a o best-practice). Puoi utilizzare i tag nella tua configurazione per attivare o disattivare un intero gruppo di regole in una sola volta. Vedi Tag per l'elenco completo dei tag supportati.

Violazione

Una violazione è un problema di accessibilità che Axe DevTools Linter ha rilevato nel tuo codice sorgente — specificamente, un pattern che non rispetta una o più delle regole controllate da Axe DevTools Linter. Le violazioni sono riportate con l'ID della regola, una descrizione e la posizione nel file.

WCAG

WCAG, ossia le Web Content Accessibility Guidelines, sono state sviluppate dal World Wide Web Consortium (W3C) e spiegano come rendere il contenuto Web più accessibile alle persone con disabilità. WCAG 1.0 è stato pubblicato a maggio 1999. WCAG 2.0 è stato pubblicato a dicembre 2008. WCAG 2.1 è stato pubblicato a giugno 2018. 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.