Perché usiamo un motore aperto e lo nominiamo
I motori di regole sono infrastruttura di base. Scriverne uno proprietario significherebbe riderivare centinaia di controlli, e un cliente dovrebbe comunque fidarsi della nostra parola su cosa significhi un riscontro. Un motore aperto può essere verificato dallo sviluppatore che deve correggere il codice.
In cambio, il motore non è un fossato, e non fingiamo che lo sia. Il nostro lavoro sta negli strati che un revisore degli appalti legge davvero: la mappatura delle clausole, la cronologia delle regressioni, la firma manuale e il pacchetto sigillato che li lega insieme.
Cosa rilevano le regole e cosa no
Le prime otto righe sono verificabili a macchina. Le ultime tre sono in ogni audit serio e nessun motore può deciderle.
| Regola | Cosa rileva | Impatto tipico | Deciso da |
|---|---|---|---|
| image-alt | Immagini senza alternativa testuale | critico | automatico |
| color-contrast | Testo sotto il rapporto di contrasto | grave | automatico |
| label | Campi di modulo senza etichetta programmatica | critico | automatico |
| link-name | Link senza nome distinguibile | grave | automatico |
| target-size | Bersagli sotto 24 × 24 pixel CSS | grave | automatico |
| html-has-lang | Attributo di lingua mancante o errato | grave | automatico |
| heading-order | Livelli di intestazione saltati | moderato | automatico |
| aria-* | Ruoli, stati e proprietà non validi | critico | automatico |
| ordine di focus | Se l’ordine ha senso | — | manuale |
| trappole da tastiera | Se un utente può uscire da un widget | — | manuale |
| flusso dello screen reader | Se la pagina si legge in modo coerente | — | manuale |
Cosa aggiunge Conforma sopra il motore
L’output grezzo delle regole è un elenco. Ciò di cui un cliente ha bisogno è una catena di custodia, con una cronologia e un nome accanto alle valutazioni.
I test automatizzati coprono solo una parte delle barriere all’accessibilità. Per una valutazione completa è necessaria una verifica manuale.
Come gira nella pipeline
- Playwright apre ogni pagina in chromium, aspetta che la rete si stabilizzi, inietta il motore ed esegue il set di regole configurato, al livello e alla versione rispetto a cui il sito è monitorato.
- L’output non modificato del motore è archiviato per pagina, così qualsiasi affermazione può essere ricondotta alla misurazione esatta che l’ha prodotta.
- Ogni violazione diventa un riscontro con un’impronta di regola, selettore e percorso; è così che una correzione che ritorna dopo un deploy viene segnalata come regressione.
- La nostra breve descrizione e il nostro suggerimento di correzione sono allegati per regola, al posto del testo della norma copiato, così uno sviluppatore ottiene un passo successivo invece di una citazione.
Licenza, attribuzione e marchio
axe-core è pubblicato da Deque Systems sotto la Mozilla Public License 2.0. Lo utilizziamo come una dipendenza non modificata: la libreria è installata dal suo pacchetto pubblicato, iniettata nella pagina in fase di esecuzione da Playwright, e mai modificata. Poiché nessun file coperto dalla MPL viene cambiato, sul nostro codice sorgente non scatta alcun obbligo di copyleft a livello di file; il testo della licenza e l’avviso di copyright viaggiano con la dipendenza e sono riprodotti sulla nostra pagina delle attribuzioni.
Non usiamo il marchio « axe » nel nome del nostro prodotto, nel nostro dominio, nel nostro logo o nelle nostre affermazioni di marketing. Conforma non è affiliata a Deque Systems né avallata da essa. Nominare il motore è una dichiarazione di provenienza, così che uno sviluppatore possa verificare un riscontro rispetto alla regola a monte, non un avallo preso in prestito.
Se il motore viene aggiornato, la versione usata per una scansione è registrata nei metadati dell’esecuzione e viaggia all’interno del pacchetto di prove, così un riscontro di marzo resta tracciabile fino all’esatto insieme di regole che l’ha prodotto.
- Libreria
- axe-core, di Deque Systems
- Licenza
- Mozilla Public License 2.0
- Uso
- Dipendenza non modificata, avvolta
- Marchio
- Non usato nel nostro nome o marketing
Le domande che ci vengono poste
Modificate axe-core?
No. È una dipendenza sotto MPL-2.0, iniettata in fase di esecuzione, avvolta anziché modificata. L’attribuzione è pubblicata, e il marchio axe non è usato nel nome del nostro prodotto o nel marketing.
Quindi Conforma è solo un involucro?
Il motore è una sola fase. Il crawling, la mappatura delle clausole, il confronto delle regressioni, il flusso di lavoro manuale, la generazione della dichiarazione e il pacchetto di prove sigillato sono nostri, ed è ciò che viene letto in una gara d’appalto.
Quali livelli di impatto vengono segnalati?
Critico, grave, moderato e minore. Manteniamo queste etichette, le pesiamo in un punteggio e mostriamo sempre accanto i conteggi grezzi, così la ponderazione resta visibile.