Style filterPropiedad

Style 对象参考手册Objeto Style

Ejemplo

Cambia el color de la imagen a blanco y negro (escala de grises al 100%):

// Navegadores Chrome, Safari y Opera
document.getElementById("myImg").style.WebkitFilter = "grayscale(100%)";

// Sintaxis estándar (no compatible con otros navegadores principales)
document.getElementById("myImg").style.filter = "grayscale(100%)";

Pruébalo »

Definición y uso

filter se utiliza para definir efectos visuales en elementos (generalmente <img>).

Nota:Si el elemento no es un elemento flexible, la propiedad flexGrow no tiene efecto.


Compatibilidad del navegador

Los números en la tabla indican el número de versión del primer navegador que soporta el método.

Propiedad
filter 18.0 Webkit No compatible No compatible 6.0 Webkit 15.0 Webkit

Nota:Chrome, Safari y Opera utilizan la propiedad WebkitFilter en su lugar.


Sintaxis

Devuelve la propiedad filter:

object.style.filter

Establece la propiedad filter:

object.style.filter="none | blur() | brightness() | contrast() | drop-shadow() | grayscale() | hue-rotate() | invert() | opacity() | saturate() | sepia()"

Función Filter

Nota:Los filtros suelen usar porcentajes (ej: 75%), pero también se pueden expresar con decimales (ej: 0.75).

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

Si no se establece un valor, el valor predeterminado es 0; este parámetro puede establecer un valor de longitud CSS, pero no acepta valores porcentuales.
brightness(%) Aplica una multiplicación lineal a la imagen para hacerla más brillante u oscura. Si el valor es 0%, la imagen se vuelve completamente negra. Si el valor es 100%, la imagen no cambia. Otros valores corresponden al efecto de multiplicador lineal. Se permiten valores superiores al 100%, y la imagen será más brillante que originalmente. Si no se establece un valor, el valor predeterminado es 1.
contrast(%) Ajusta el contraste de la imagen. Si el valor es 0%, la imagen se vuelve 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 un valor, el valor predeterminado 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, puede tener desenfoque y es una versión desplazada de la máscara dibujada en un color específico. La función acepta valores del tipo <shadow> (definido en CSS3 background), excepto que la palabra clave "inset" no está permitida. Esta función es muy similar a la propiedad box-shadow existente; la diferencia es que, a través del filtro, algunos navegadores ofrecen aceleración por hardware para un mejor rendimiento.<shadow>参数如下:

<offset-x> <offset-y> (Obligatorio)
Son los dos valores <length> que establecen el desplazamiento de la sombra.<offset-x>Establece la distancia horizontal. Un valor negativo hace que la sombra aparezca a la izquierda del elemento.<offset-y>Establece la distancia vertical. Un valor negativo hace que la sombra aparezca encima del elemento. Ver<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>,habrá efecto de desenfoque).
<blur-radius> (Opcional)
Este es el tercer valor <length>. Cuanto mayor sea el valor, más borrosa, más grande y más clara será la sombra. No se permiten valores negativos. Si no se establece, el valor predeterminado es 0 (los bordes de la sombra son nítidos).
<spread-radius> (Opcional)
Este es el cuarto valor <length>. Un valor positivo expande y agranda la sombra, un valor negativo la reduce. Si no se establece, el valor predeterminado es 0 (la sombra tendrá el mismo tamaño que el elemento).
Nota: WebKit y algunos otros navegadores no son compatibles con el cuarto valor de longitud; si se añade, no se renderizará.
 
<color> (Opcional)
Consulta las palabras clave y notaciones posibles para <color>. Si no se establece, el valor del color depende del navegador. En Gecko (Firefox), Presto (Opera) y Trident (Internet Explorer), se aplica 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 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 predeterminado 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á a la imagen. Un valor de 0deg hace que la imagen no cambie. Si no se establece, el valor predeterminado es 0deg. Aunque no hay un valor máximo, los valores superiores a 360deg equivalen a dar una vuelta completa adicional.

invert(%)

Invierte la imagen de entrada. El valor define la proporción de conversión. Un valor del 100% es la inversión completa. 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 predeterminado 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, equivalentes a multiplicar las muestras de la imagen por la cantidad. Si no se establece, el valor predeterminado es 1. Esta función es muy similar a la propiedad opacity existente; la diferencia es que, a través de filter, algunos navegadores ofrecen aceleración por hardware para mejorar el rendimiento.

saturate(%)

Transforma 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 da una mayor saturación. Si no se establece, el valor predeterminado es 1.

sepia(%)

Convierte la imagen a sepia. El valor define la proporción de conversión. Un valor del 100% es 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 predeterminado es 0.

url()

La función URL acepta un archivo XML que define 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:la palabra clave CSS initial

inherit Para heredar la propiedad del elemento padre, consulta:la palabra clave CSS inherit

Detalles técnicos

Versión de CSS CSS3


Artículos relacionados

Manual de referencia CSS:la propiedad filter


Style 对象参考手册Objeto Style

Otras extensiones