Propiedad CSS3 filter (filtros)

Ejemplo

Modifica el color de todas las imágenes a blanco y negro (escala de grises al 100%):

img {
    -webkit-filter: grayscale(100%); /* Chrome, Safari, Opera */
    filter: grayscale(100%);
}

Pruébalo »

Definición y uso

La propiedad filter define el efecto visual de un elemento (normalmente <img>) (por ejemplo: desenfoque y saturación).

Valor por defecto: none
Herencia: no
Soporte de animación: Sí. Consulta más detalles enAnimaciones CSS
Versión: CSS3
Sintaxis de JavaScript: object.style.WebkitFilter="grayscale(100%)" Pruébalo »

Compatibilidad del navegador

Los números de la tabla indican la primera versión del navegador que admite este método.

El prefijo -webkit- que sigue al número indica el prefijo del navegador especificado.

Propiedad
filter 18.0 -webkit- 13.0 35.0 6.0 -webkit- 15.0 -webkit-

Nota:El antiguo navegador Internet Explorer (4.0 a 8.0) admitía una propiedad "filter" no estándar que ya está obsoleta. Los navegadores IE8 y versiones anteriores suelen usar laopacitypropiedad.

Sintaxis CSS

filter: none | blur() | brightness() | contrast() | drop-shadow() | grayscale() | hue-rotate() | invert() | opacity() | saturate() | sepia() | url();

Consejo:Usa espacios para separar varios filtros.


Funciones de filter

Nota:Los filtros suelen usar porcentajes (por ejemplo: 75%), aunque también se pueden usar decimales (por ejemplo: 0.75).

Filter Descripción
none Valor por defecto, sin efecto.
blur(px) Aplica un desenfoque gaussiano a la imagen. El valor "radius" define la desviación estándar de la función gaussiana, o cuántos píxeles se mezclan en la pantalla, por lo que cuanto mayor sea el valor, más borroso será.

Si no se establece un valor, el valor por defecto es 0; este parámetro puede aceptar valores de longitud CSS, pero no acepta valores porcentuales.
brightness(%) Aplica una multiplicación lineal a la imagen para que parezca más brillante u oscura. Si el valor es 0%, la imagen se verá completamente negra. Si el valor es 100%, la imagen no cambia. Otros valores corresponden al efecto de multiplicador lineal. También se permiten valores superiores al 100%, y la imagen será más brillante que la original. Si no se establece valor, el valor por defecto es 1.
contrast(%) Ajusta el contraste de la imagen. Si el valor es 0%, la imagen se verá completamente negra. Si el valor es 100%, la imagen no cambia. El valor puede superar el 100%, lo que significa que se aplicará un contraste más bajo. Si no se establece valor, el valor por defecto es 1.
drop-shadow(h-shadow v-shadow blur spread color)

Aplica un efecto de sombra a la imagen. La sombra se compone debajo de la imagen y puede tener desenfoque; es una versión desplazada de una máscara dibujada con un color específico. La función acepta valores de tipo <shadow> (definido en CSS3 background), excepto que la palabra clave "inset" no está permitida. Esta función es muy similar a la propiedad existente box-shadow; la diferencia es que, a través de filter, algunos navegadores ofrecen aceleración por hardware para un mejor rendimiento.<shadow>参数如下:

<offset-x> <offset-y> (obligatorio)
Son dos valores <length> que establecen el desplazamiento de la sombra.<offset-x>Establece la distancia horizontal. Un valor negativo hará que la sombra aparezca a la izquierda del elemento.<offset-y>Establece la distancia vertical. Un valor negativo hará que la sombra aparezca sobre el elemento. Consulta<length>las unidades posibles.
Si ambos valores son0, la sombra aparece directamente detrás del elemento (si se establece <blur-radius> and/or <spread-radius>,tendrá un efecto de desenfoque).
<blur-radius> (opcional)
Este es el tercer valor <length>. Cuanto mayor sea el valor, más borroso será, y la sombra se volverá más grande y más clara. No se permiten valores negativos. Si no se establece, el valor por defecto es 0 (entonces el borde de la sombra es muy nítido).
<spread-radius> (opcional)
Este es el cuarto valor <length>. Un valor positivo hará que la sombra se expanda y se haga más grande; un valor negativo hará que la sombra se encoja. Si no se establece, el valor por defecto es 0 (la sombra tendrá el mismo tamaño que el elemento).
Nota: WebKit y algunos otros navegadores no admiten el cuarto valor de longitud; si se añade, no se renderizará.
 
<color> (opcional)
Consulta <color> para ver las posibles palabras clave y marcas de este valor. Si no se establece, el valor del color depende del navegador. En Gecko (Firefox), Presto (Opera) y Trident (Internet Explorer), se aplicará el valor de la propiedad colorcolor. Además, si se omite el valor de color, en WebKit la sombra es transparente.
grayscale(%)

Convierte la imagen a escala de grises. El valor define la proporción de conversión. Un valor del 100% convierte completamente la imagen a escala de grises; un valor del 0% no cambia la imagen. Los valores entre 0% y 100% son multiplicadores lineales del efecto. Si no se establece, el valor por defecto es 0.

hue-rotate(deg)

Aplica rotación de tono a la imagen. El valor "angle" establece el ángulo del círculo cromático que se ajustará en la imagen. Un valor de 0deg significa que la imagen no cambia. Si el valor no se establece, el valor por defecto es 0deg. Este valor no tiene máximo; los valores superiores a 360deg equivalen a dar una vuelta más.

invert(%)

Invierte la imagen de entrada. El valor define la proporción de conversión. Un valor del 100% es una inversión completa. Un valor del 0% no cambia la imagen. Los valores entre 0% y 100% son multiplicadores lineales del efecto. Si el valor no se establece, el valor por defecto es 0.

opacity(%)

Transforma el nivel de transparencia de la imagen. El valor define la proporción de conversión. Un valor del 0% es completamente transparente; un valor del 100% no cambia la imagen. Los valores entre 0% y 100% son multiplicadores lineales del efecto, lo que también equivale a multiplicar la muestra de la imagen por esa cantidad. Si el valor no se establece, el valor por defecto es 1. Esta función es muy similar a la propiedad existente opacity; la diferencia es que, a través de filter, algunos navegadores ofrecen aceleración por hardware para mejorar el rendimiento.

saturate(%)

Convierte la saturación de la imagen. El valor define la proporción de conversión. Un valor del 0% es completamente insaturado; un valor del 100% no cambia la imagen. Otros valores son multiplicadores lineales del efecto. Se permiten valores superiores al 100%, lo que dará una mayor saturación. Si el valor no se establece, el valor por defecto es 1.

sepia(%)

Convierte la imagen a sepia. El valor define la proporción de conversión. Un valor del 100% hace que la imagen sea completamente sepia; un valor del 0% no cambia la imagen. Los valores entre 0% y 100% son multiplicadores lineales del efecto. Si no se establece, el valor por defecto es 0.

url()

La función URL acepta un archivo XML que contiene un filtro SVG, y puede incluir un ancla para especificar un elemento de filtro concreto.

Por ejemplo:

filter: url(svg-url#element-id)
initial

Para establecer la propiedad a su valor predeterminado, consulta:Palabra clave CSS initial

inherit Para heredar esta propiedad del elemento padre, consulta:Palabra clave CSS inherit

Examples

Más ejemplos

Ejemplo de desenfoque (blur)

Imagen con efecto de desenfoque gaussiano:

img {
    -webkit-filter: blur(5px); /* Chrome, Safari, Opera */
    filter: blur(5px);
}

Pruébalo »

Ejemplo de la función brightness

Hacer la imagen más brillante:

img {
    -webkit-filter: brightness(200%); /* Chrome, Safari, Opera */
    filter: brightness(200%);
}

Pruébalo »

Ejemplo de la función contrast

Ajustar el contraste de la imagen:

img {
    -webkit-filter: contrast(200%); /* Chrome, Safari, Opera */
    filter: contrast(200%);
}

Pruébalo »

Ejemplo de la función drop-shadow

Aplicar un efecto de sombra a la imagen:

img {
    -webkit-filter: drop-shadow(8px 8px 10px red); /* Chrome, Safari, Opera */
    filter: drop-shadow(8px 8px 10px red);
}

Pruébalo »

Ejemplo de la función grayscale

Convertir la imagen a escala de grises:

img {
    -webkit-filter: grayscale(50%); /* Chrome, Safari, Opera */
    filter: grayscale(50%);
}

Pruébalo »

Ejemplo de la función hue-rotate()

Aplicar rotación de tono a la imagen:

img {
    -webkit-filter: hue-rotate(90deg); /* Chrome, Safari, Opera */
    filter: hue-rotate(90deg);
}

Pruébalo »

Ejemplo de la función invert

Invertir la imagen de entrada:

img {
    -webkit-filter: invert(100%); /* Chrome, Safari, Opera */
    filter: invert(100%);
}

Pruébalo »

Ejemplo de la función opacity

Transformar el nivel de transparencia de la imagen:

img {
    -webkit-filter: opacity(30%); /* Chrome, Safari, Opera */
    filter: opacity(30%);
}

Pruébalo »

Ejemplo de la función saturate

Convertir la saturación de la imagen:

img {
    -webkit-filter: saturate(800%); /* Chrome, Safari, Opera */
    filter: saturate(800%);
}

Pruébalo »

Ejemplo de la función sepia

Convertir la imagen a sepia:

img {
    -webkit-filter: sepia(100%); /* Chrome, Safari, Opera */
    filter: sepia(100%);
}

Pruébalo »

Funciones combinadas

Usa varios filtros, cada filtro separado por un espacio.

Nota:El orden es muy importante (por ejemplo, usar grayscale() y luego sepia() producirá una imagen completamente en escala de grises).

img {
    -webkit-filter: contrast(200%) brightness(150%);  /* Chrome, Safari, Opera */
    filter: contrast(200%) brightness(150%);
}

Pruébalo »

Ejemplo de todos los filtros

El siguiente ejemplo demuestra el uso de todos los filtros:

.blur {
    -webkit-filter: blur(4px);
    filter: blur(4px);
}

.brightness {
    -webkit-filter: brightness(0.30);
    filter: brightness(0.30);
}

.contrast {
    -webkit-filter: contrast(180%);
    filter: contrast(180%);
}

.grayscale {
    -webkit-filter: grayscale(100%);
    filter: grayscale(100%);
}

.huerotate {
    -webkit-filter: hue-rotate(180deg);
    filter: hue-rotate(180deg);
}

.invert {
    -webkit-filter: invert(100%);
    filter: invert(100%);
}

.opacity {
    -webkit-filter: opacity(50%);
    filter: opacity(50%);
}

.saturate {
    -webkit-filter: saturate(7);
    filter: saturate(7);
}

.sepia {
    -webkit-filter: sepia(100%);
    filter: sepia(100%);
}

.shadow {
    -webkit-filter: drop-shadow(8px 8px 10px green);
    filter: drop-shadow(8px 8px 10px green);
}

Pruébalo »

Artículos relacionados

Referencia del DOM de HTML:Propiedad Style filter


Otras extensiones