Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

sepia(): un filtro de color gradual en tonos marrones

Aplica una conversión sepia a la imagen renderizada y distingue la omisión, el cero y los valores superiores al 100%.

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

Sintaxis

filter: sepia(50%);

sepia(amount) convierte los colores renderizados hacia una paleta sepia. Cero deja los colores de entrada intactos, 100% o 1 aplica la conversión completa y los valores intermedios gradúan el efecto. El argumento omitido en sepia() significa 1. Se aceptan valores superiores al 100%, pero se limitan al efecto completo; los valores negativos no son válidos.

Es un filtro sobre el elemento renderizado, por lo que puede afectar a la vez a su texto, fondo y descendientes. No modifica un archivo de imagen ni cambia las dimensiones del elemento en la disposición. Combinar sepia con otros filtros aplica la lista en orden y puede cambiar el resultado. A diferencia de saturate(), los valores aceptados más altos no aumentan este efecto por encima de su máximo.

El ejemplo dibuja una zona opaca RGB(80,120,160) y toma muestras mediante la ruta de renderizado SVG/canvas del navegador. En Chromium 157, los valores RGBA medidos son 80,120,160,255 con cero, 117,129,133,255 a media intensidad y 154,137,107,255 a intensidad completa. Los paréntesis vacíos y 200% coinciden con el resultado completo; la forma negativa no supera CSS.supports().

Ejemplos

async function sample(filter) {
  const svg='<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8"><foreignObject width="8" height="8"><div xmlns="http://www.w3.org/1999/xhtml" style="width:8px;height:8px;background:rgb(80 120 160);filter:'+filter+'"></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].join(',');
}
const normal=await sample('sepia(0)');
const half=await sample('sepia(50%)');
const full=await sample('sepia(1)');
const omitted=await sample('sepia()');
const over=await sample('sepia(200%)');
console.log('normal='+normal+'; half='+half+'; full='+full+'; omitted='+omitted+'; over='+over+'; negative='+CSS.supports('filter','sepia(-0.1)'));

Resultado

normal=80,120,160,255; half=117,129,133,255; full=154,137,107,255; omitted=154,137,107,255; over=154,137,107,255; negative=false

Son píxeles medidos mediante la ruta de renderizado indicada, no valores de bytes universales garantizados para cualquier canalización gráfica. El alfa sin cambios y la coincidencia entre las muestras del efecto completo, del argumento omitido y del valor excesivo muestran las diferencias previstas.

Fuentes