WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

hsl() — Farbton, Sättigung und Helligkeit

`hsl()` und der Alias `hsla()` beschreiben eine sRGB-Farbe durch Farbtonwinkel, Sättigung, Helligkeit und optionales Alpha.

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

Syntax

hsl( [ <hue> | none ] [ <percentage> | <number> | none ]{2} [ / [ <alpha-value> | none ] ]? )

hsl() und der Alias hsla() beschreiben eine sRGB-Farbe durch Farbtonwinkel, Sättigung, Helligkeit und optionales Alpha.

Das Beispiel malt hsl(120deg 100% 50% / 50%) über Weiß und erhält 127,255,127; hsl(480deg 100% 50%) wickelt den Winkel zu Grün 0,255,0. hsl(0deg 0% 50%) und hsla(240deg 0% 50% / 100%) ergeben beide 128,128,128, weil der Farbton bei Nullsättigung wirkungslos ist. Gemischtes hsl(120deg 100%, 50%) ergibt false.

Grammatik: hsl( [ <hue> | none ] [ <percentage> | <number> | none ]{2} [ / [ <alpha-value> | none ] ]? ).

Moderne Syntax verwendet Leerzeichen und einen Schrägstrich vor Alpha, ältere Syntax Kommas; beides darf nicht gemischt werden. Farbtonwinkel laufen nach einer Umdrehung weiter, fehlendes Alpha ist 100%, und negative Sättigung wird historisch auf null begrenzt. Das Ergebnis wird zu sRGB; HSL-Helligkeit ist nicht wahrnehmungsgleich, daher garantieren gleiche Zahlen verschiedener Farbtöne nicht gleiche visuelle Helligkeit.

Beispiele

const sample=async color=>{const svg='<svg xmlns="http://www.w3.org/2000/svg" width="4" height="4"><rect width="4" height="4" fill="white"/><rect width="4" height="4" fill="'+color+'"/></svg>';const image=new Image();image.src='data:image/svg+xml;charset=utf-8,'+encodeURIComponent(svg);await image.decode();const canvas=document.createElement('canvas');canvas.width=canvas.height=4;const context=canvas.getContext('2d');context.drawImage(image,0,0);return [...context.getImageData(2,2,1,1).data].slice(0,3).join(',')};
const alpha=await sample('hsl(120deg 100% 50% / 50%)');
const wrapped=await sample('hsl(480deg 100% 50%)');
const grayA=await sample('hsl(0deg 0% 50%)');
const grayB=await sample('hsla(240deg 0% 50% / 100%)');
const mixedSyntax=CSS.supports('color','hsl(120deg 100%, 50%)');
console.log('alpha-over-white='+alpha+'; wrapped='+wrapped+'; powerless-hues='+grayA+'/'+grayB+'; mixed-syntax='+mixedSyntax);

Ergebnis

alpha-over-white=127,255,127; wrapped=0,255,0; powerless-hues=128,128,128/128,128,128; mixed-syntax=false

`hsl()` und der Alias `hsla()` beschreiben eine sRGB-Farbe durch Farbtonwinkel, Sättigung, Helligkeit und optionales Alpha.

Quellen