Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

hwb() — matiz misturada com branco e preto

`hwb()` descreve uma cor `sRGB` pelo ângulo de matiz e proporções de branco e preto, com alfa opcional.

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

Sintaxe

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

hwb() descreve uma cor sRGB pelo ângulo de matiz e proporções de branco e preto, com alfa opcional.

O exemplo representa hwb(120 20% 30%) como 51,179,51,255. Em hwb(40 80% 50%), as componentes excedem o intervalo e normalizam-se para o cinzento 157,157,157,255; o relativo hwb(from rgb(100 150 200 / 50%) h 10% 20% / alpha) produz 26,114,203,128. A forma com vírgulas hwb(120, 20%, 30%) devolve false.

Gramática: hwb( [ from <color> ]? [ <hue> | none ] [ <percentage> | <number> | none ]{2} [ / [ <alpha-value> | none ] ]? ).

Quando W + B atinge ou excede 100%, a contribuição da matiz pura desaparece e branco e preto são normalizados proporcionalmente, pelo que a matiz deixa de influir. A sintaxe relativa começa por from, converte a cor de origem para sRGB e expõe h, w, b e alpha; none representa uma componente em falta. A sintaxe moderna usa espaços e uma barra antes do alfa, não vírgulas.

Exemplos

const sample=async color=>{const svg='<svg xmlns="http://www.w3.org/2000/svg" width="4" height="4"><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].join(',')};
const absolute=await sample('hwb(120 20% 30%)');
const normalized=await sample('hwb(40 80% 50%)');
const relative=await sample('hwb(from rgb(100 150 200 / 50%) h 10% 20% / alpha)');
const commaSyntax=CSS.supports('color','hwb(120, 20%, 30%)');
console.log('absolute='+absolute+'; normalized='+normalized+'; relative='+relative+'; comma-syntax='+commaSyntax);

Resultado

absolute=51,179,51,255; normalized=157,157,157,255; relative=26,114,203,128; comma-syntax=false

`hwb()` descreve uma cor `sRGB` pelo ângulo de matiz e proporções de branco e preto, com alfa opcional.

Fontes