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

CKTIS / CSS

blur() — desfocagem gaussiana

`blur()` aplica uma desfocagem gaussiana a uma imagem de entrada, usando o comprimento como desvio padrão e não como raio de sombra.

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

Sintaxe

blur( <length>? )

blur() aplica uma desfocagem gaussiana a uma imagem de entrada, usando o comprimento como desvio padrão e não como raio de sombra.

O exemplo define filter: blur(4px); o navegador calcula blur(4px), Canvas mostra um centro suavizado e um halo não transparente fora da origem, enquanto a geometria da caixa de layout permanece igual.

Gramática: blur( <length>? ).

Um argumento omitido equivale a 0px e não produz efeito. Valores negativos são proibidos, <percentage> não é aceite e este comprimento não é o raio de desfocagem de box-shadow. O efeito pode ampliar o extravasamento de tinta, mas não participa no layout.

Exemplos

const box=document.createElement('div');document.body.append(box);box.style.cssText='width:20px;height:20px;background:black';const before=box.getBoundingClientRect();box.style.filter='blur(4px)';const after=box.getBoundingClientRect(),computed=getComputedStyle(box).filter;const source=document.createElement('canvas'),dest=document.createElement('canvas');source.width=dest.width=41;source.height=dest.height=41;source.getContext('2d').fillRect(16,16,9,9);const ctx=dest.getContext('2d');ctx.filter=computed;ctx.drawImage(source,0,0);const center=ctx.getImageData(20,20,1,1).data[3],halo=ctx.getImageData(12,20,1,1).data[3];const softened=center>0&&center<255,spread=halo>0,layoutStable=before.width===after.width&&before.height===after.height;if(computed!=='blur(4px)'||!softened||!spread||!layoutStable)throw new Error('blur effect evidence mismatch: '+[computed,center,halo,layoutStable]);console.log('computed='+computed+'; softened='+softened+'; halo='+spread+'; layout-box-stable='+layoutStable);

Resultado

computed=blur(4px); softened=true; halo=true; layout-box-stable=true

`blur()` aplica uma desfocagem gaussiana a uma imagem de entrada, usando o comprimento como desvio padrão e não como raio de sombra.

Fontes