Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

contrast-color() — couleur contrastante automatique

`contrast-color()` choisit une couleur de texte contrastant avec une couleur de fond unie donnée ; cette surface expérimentale de la spécification risque encore de changer.

Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntaxe

contrast-color( <color> )

contrast-color() choisit une couleur de texte contrastant avec une couleur de fond unie donnée ; cette surface expérimentale de la spécification risque encore de changer.

L’exemple confirme la forme prise en charge contrast-color(<color>) : contrast-color(rgb(20 20 20)) donne white, tandis que contrast-color(rgb(240 240 240)) donne black. La forme étendue contrast-color(<color>, white, black) est rejetée ; un balayage de gris situe la limite actuelle de Chromium entre 117 et 118.

Grammaire: contrast-color( <color> ).

La forme simple contrast-color(<color>) est définie dans CSS Color 5 et ne figure pas dans la liste formelle at-risk de ce module. Elle ne renvoie que white ou black ; l’algorithme et le seuil exacts sont définis par l’UA, et le résultat devrait atteindre au moins WCAG 2.1 AA Large. Séparément, le brouillon actuel de CSS Color 6 porte la mention Not Ready For Implementation et étudie une grammaire inachevée de rôles de premier plan/arrière-plan, de cibles et de candidats. Ce statut n’est pas un at-risk formel ; le rejet de contrast-color(<color>, white, black) montre que la forme étendue n’est pas encore fiable.

Exemples

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);

Résultat

simple=true; candidates=false; dark=rgb(255, 255, 255); light=rgb(0, 0, 0); boundary=117/118

`contrast-color()` choisit une couleur de texte contrastant avec une couleur de fond unie donnée ; cette surface expérimentale de la spécification risque encore de changer.

Sources