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

CKTIS / CSS

brightness() — multiplicateur de luminosité du filtre

`brightness()` est une fonction de filtre qui multiplie les composantes colorées de l’image d’entrée, l’assombrissant ou l’éclaircissant sans modifier la taille de sa boîte de mise en page.

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

Syntaxe

brightness( [ <number> | <percentage> ]? )

brightness() est une fonction de filtre qui multiplie les composantes colorées de l’image d’entrée, l’assombrissant ou l’éclaircissant sans modifier la taille de sa boîte de mise en page.

L’exemple définit filter: brightness(150%). La valeur calculée est brightness(1.5) et le pixel rgb(40 80 120) devient 60,120,180. Un passage distinct avec brightness(0) donne le noir 0,0,0, ce qui prouve l’effet sur les pixels plutôt qu’une simple acceptation syntaxique.

Grammaire: brightness( [ <number> | <percentage> ]? ).

L’argument peut être <number> ou <percentage> : 1 et 100% laissent l’image intacte, 0 produit du noir et les valeurs supérieures à 1 éclaircissent sans limite haute. Les valeurs négatives sont interdites. Un argument omis vaut 1 ; lors de l’interpolation des listes de filtres, une fonction correspondante absente reçoit aussi la valeur initiale 1.

Exemples

const swatch=document.createElement('div');document.body.append(swatch);swatch.style.filter='brightness(150%)';const computed=getComputedStyle(swatch).filter;const source=document.createElement('canvas'),lit=document.createElement('canvas'),dark=document.createElement('canvas');for(const canvas of [source,lit,dark]){canvas.width=canvas.height=1}const sourceContext=source.getContext('2d');sourceContext.fillStyle='rgb(40 80 120)';sourceContext.fillRect(0,0,1,1);const litContext=lit.getContext('2d');litContext.filter=computed;litContext.drawImage(source,0,0);const darkContext=dark.getContext('2d');darkContext.filter='brightness(0)';darkContext.drawImage(source,0,0);const pixel=[...litContext.getImageData(0,0,1,1).data].slice(0,3),zero=[...darkContext.getImageData(0,0,1,1).data].slice(0,3);if(computed!=='brightness(1.5)'||pixel.join(',')!=='60,120,180'||zero.join(',')!=='0,0,0')throw new Error('brightness evidence mismatch: '+[computed,pixel,zero]);console.log('computed='+computed+'; pixel='+pixel.join(',')+'; zero='+zero.join(','));

Résultat

computed=brightness(1.5); pixel=60,120,180; zero=0,0,0

`brightness()` est une fonction de filtre qui multiplie les composantes colorées de l’image d’entrée, l’assombrissant ou l’éclaircissant sans modifier la taille de sa boîte de mise en page.

Sources