Calcolatore contrasto APCA

Questo calcolatore di contrasto APCA prende un colore di testo e un colore di sfondo in codici hex e restituisce il Lc con segno (contrasto di luminosità) prodotto dall'Accessible Perceptual Contrast Algorithm, usato nel lavoro di leggibilità della bozza WCAG 3. A differenza del rapporto di contrasto WCAG 2.x più datato, l'APCA è sensibile alla polarità: testo scuro su superficie chiara produce un Lc positivo, mentre testo chiaro su superficie scura produce un Lc negativo di magnitudine simile. Designer, sviluppatori e specialisti di accessibilità usano quel singolo numero—insieme a tabelle di dimensione e peso del carattere—per decidere se il corpo tipografico, le etichette dell'interfaccia e i tratti non testuali restano leggibili su display autoilluminati. Il motore implementa le costanti pubbliche 0.0.98G-4g: linearizzazione con potenza 2.4, coefficienti Y sRGB, soft-clamp del nero e scaling SAPC BoW/WoB. I risultati sono pienamente deterministici, senza chiamate di rete, campionamento o scorciatoie dipendenti dalla data.

Cosa misura il Lc APCA e come differisce dal rapporto WCAG 2

L'APCA predice il contrasto percettivo di testo e contenuti non testuali su schermi autoilluminati modellando il gamma del monitor, i neri morbidi e il modo asimmetrico in cui la visione umana tratta le coppie scuro-su-chiaro rispetto a chiaro-su-scuro. L'output è un Lc con segno che copre circa più o meno centodieci: ad esempio, un corpo di testo quasi nero su bianco puro si colloca tipicamente vicino a Lc novanta o superiore, mentre gli stessi colori invertiti producono un grande Lc negativo.

WCAG 2.x invece riporta un unico rapporto di contrasto positivo dalla luminanza relativa con soglie fisse AA e AAA come 4.5 a 1 e 7 a 1; quel rapporto ignora la polarità e tende a sovra- o sottovalutare certe coppie di toni medi che le persone faticano davvero a leggere.

Questo calcolatore restituisce sempre il Lc con segno, la magnitudine assoluta, l'etichetta di polarità BoW (black on white / testo scuro su chiaro) o WoB (white on black / testo chiaro su scuro), la Y linearizzata di ciascun colore e una banda grossolana di leggibilità derivata dal Lc assoluto per un triage rapido.

Non c'è crawl di pagina, parsing CSS, fusione di opacità né campionamento di gradienti: Lei fornisce due colori hex espliciti e riceve un oggetto riproducibile adatto a gate sui token di design, ticket di accessibilità e revisioni automatiche di palette che devono citare un Lc numerico piuttosto che un'opinione soggettiva su uno screenshot.

Come vengono letti gli input hex e perché il percorso 0.0.98G-4g resta deterministico

Entrambi i valori devono essere hex: cancelletto iniziale opzionale, tre cifre che si espandono a sei oppure sei cifre complete, senza distinzione di maiuscole. Suffissi alpha, funzioni rgb(), funzioni hsl(), colori CSS con nome e interi nudi sono rifiutati con un messaggio che nomina il campo e mostra ciò che è stato ricevuto, così un token errato non diventa mai un fail-open silenzioso. Ogni colore è limitato a trentadue caratteri per tenere la validazione economica e bloccare incolla accidentali.

Dopo il parsing, ogni canale è elevato alla potenza 2.4 dopo la divisione per duecentocinquantacinque, poi combinato con i coefficienti sRGB APCA 0.2126729, 0.7151522 e 0.0721750 per formare Y. I valori Y quasi neri a o sotto 0.022 ricevono il soft-clamp per non penalizzare eccessivamente il nero puro. Quando la Y dello sfondo è maggiore di quella del testo, il ramo BoW applica gli esponenti 0.56 e 0.57 con scala 1.14 e offset 0.027; altrimenti il ramo WoB usa 0.65 e 0.62 e restituisce un Lc negativo.

I delta di luminanza estremamente piccoli vengono portati a zero.

Dove i controlli APCA si inseriscono in design system, dark mode e WCAG 3

I team di prodotto ricorrono all'APCA quando una palette di brand che ha superato WCAG 2 AA resta fangosa in dark mode, quando un testo grigio medio su superfici morbide fallisce i test umani di leggibilità, o quando gli stakeholder chiedono numeri Lc allineati alle discussioni della bozza WCAG 3 piuttosto che al solo rapporto antico.

Gli ingegneri collegano lo stesso contratto a controlli di pull request che bloccano un cambio di token se il Lc assoluto dei colori di corpo primari scende sotto una soglia di team come sessanta, oppure registrano valori WoB per titoli hero del tema scuro che restano volutamente più vicini alla superficie. QA e specialisti di accessibilità allegano Lc con segno e polarità ai report di bug così gli sviluppatori correggono la coppia esatta invece di indovinare da uno screenshot.

I team di contenuto e marketing verificano che i codici hex di campagna superino ancora le bande minime di corpo quando posti su sfondi chiari o scuri del sito. La abbini al verificatore di rapporto WCAG 2 quando le serve ancora documentazione AA/AAA, e agli strumenti di conversione colore quando le servono intermedi RGB o HSL prima di calcolare il Lc.