CKTIS / CSS
contrast-color() — automatische Kontrastfarbe
`contrast-color()` wählt eine Textfarbe mit Kontrast zu einer angegebenen einfarbigen Hintergrundfarbe; diese experimentelle Spezifikationsfläche kann sich noch ändern.
Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntax
contrast-color( <color> )contrast-color() wählt eine Textfarbe mit Kontrast zu einer angegebenen einfarbigen Hintergrundfarbe; diese experimentelle Spezifikationsfläche kann sich noch ändern.
Das Beispiel bestätigt die unterstützte Form contrast-color(<color>): contrast-color(rgb(20 20 20)) ergibt white, contrast-color(rgb(240 240 240)) ergibt black. Das erweiterte contrast-color(<color>, white, black) wird verworfen; ein Graustufenscan findet Chromiums aktuelle Grenze zwischen 117 und 118.
Grammatik: contrast-color( <color> ).
Die einfache Form contrast-color(<color>) ist in CSS Color 5 definiert und steht nicht auf der formalen at-risk-Liste dieses Moduls. Sie gibt nur white oder black zurück; den genauen Kontrastalgorithmus und die Schwelle definiert der UA, und das Ergebnis soll mindestens WCAG 2.1 AA Large erreichen. Unabhängig davon ist der aktuelle Editorentwurf CSS Color 6 als Not Ready For Implementation gekennzeichnet und untersucht eine unfertige Grammatik für Vorder-/Hintergrundrollen, Zielwerte und Kandidaten. Dieser Status ist kein formales at-risk; die Ablehnung von contrast-color(<color>, white, black) zeigt, dass die erweiterte Form noch nicht verlässlich ist.
Beispiele
const supportsSimple=CSS.supports('color','contrast-color(rgb(0 0 0))'),supportsCandidates=CSS.supports('color','contrast-color(rgb(0 0 0), white, black)');const resolve=gray=>{const node=document.createElement('div');document.body.append(node);node.style.color='contrast-color(rgb('+gray+' '+gray+' '+gray+'))';return getComputedStyle(node).color};let firstBlack=-1,lastWhite=-1;for(let gray=0;gray<=255;gray++){const value=resolve(gray);if(value==='rgb(255, 255, 255)')lastWhite=gray;else if(value==='rgb(0, 0, 0)'&&firstBlack<0)firstBlack=gray;else if(value!=='rgb(0, 0, 0)')throw new Error('unexpected contrast color: '+value)}const dark=resolve(20),light=resolve(240);if(!supportsSimple||supportsCandidates||dark!=='rgb(255, 255, 255)'||light!=='rgb(0, 0, 0)'||firstBlack!==118||lastWhite!==117)throw new Error('contrast-color syntax/boundary mismatch: '+[supportsSimple,supportsCandidates,dark,light,lastWhite,firstBlack]);console.log('simple='+supportsSimple+'; candidates='+supportsCandidates+'; dark='+dark+'; light='+light+'; boundary='+lastWhite+'/'+firstBlack);Ergebnis
simple=true; candidates=false; dark=rgb(255, 255, 255); light=rgb(0, 0, 0); boundary=117/118
`contrast-color()` wählt eine Textfarbe mit Kontrast zu einer angegebenen einfarbigen Hintergrundfarbe; diese experimentelle Spezifikationsfläche kann sich noch ändern.