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

CKTIS / CSS

opacity(): um filtro de transparência renderizada

Ajuste o alfa da imagem renderizada sem retirar o elemento da disposição ou das interações.

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

Sintaxe

filter: opacity(50%);

opacity() é uma função de filtro aplicada através de filter. Com 0 ou 0%, a imagem renderizada torna-se transparente; com 1 ou 100%, permanece inalterada. Omitir o argumento significa 100%; os valores superiores são limitados e os negativos são inválidos. A função é distinta da propriedade opacity, embora ambas influenciem o alfa final e possam acumular efeitos quando utilizadas em conjunto.

Transparência não significa remoção. Um elemento transparente pode continuar a ocupar espaço, receber interações do ponteiro e participar na navegação por teclado. Se um controlo deve ficar indisponível, trate explicitamente os estados de interação e acessibilidade em vez de depender de filter: opacity(0). Numa cadeia de filtros, a posição de opacity() pode importar com efeitos que criam ou combinam píxeis.

O exemplo desenha vermelho sobre um fundo explicitamente branco. Metade da opacidade produz RGB 255,128,128, zero produz branco e um valor acima de 100% deixa o vermelho inalterado. Também cria um botão transparente: a deteção de pontos continua a encontrá-lo e a largura medida permanece em 40 píxeis. O teste distingue alfa visual, disposição e interação.

Exemplos

const sample=async style=>{const svg='<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8"><rect width="8" height="8" fill="white"/><foreignObject width="8" height="8"><div xmlns="http://www.w3.org/1999/xhtml" style="width:8px;height:8px;'+style.replaceAll('&','&amp;').replaceAll('"','&quot;')+'"></div></foreignObject></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=8;const context=canvas.getContext('2d');context.drawImage(image,0,0);return [...context.getImageData(4,4,1,1).data].slice(0,3).join(',')};
const half=await sample('background:red;filter:opacity(50%)');const zero=await sample('background:red;filter:opacity(0)');const over=await sample('background:red;filter:opacity(200%)');
const element=document.createElement('button');element.style.cssText='position:fixed;left:0;top:0;width:40px;height:30px;filter:opacity(0)';document.body.append(element);
console.log('half-over-white='+half+'; zero-over-white='+zero+'; over='+over+'; hit='+String(document.elementFromPoint(20,15)===element)+'; width='+element.offsetWidth+'; negative='+CSS.supports('filter','opacity(-1)'));

Resultado

half-over-white=255,128,128; zero-over-white=255,255,255; over=255,0,0; hit=true; width=40; negative=false

O botão transparente continua a ser um alvo de interação. Um controlo aparentemente oculto não fica automaticamente desativado nem removido da acessibilidade.

Fontes