Style filterPropiedad
Ejemplo
Cambia el color de la imagen a blanco y negro (escala de grises al 100%):
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.
|
| 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
Otras extensiones
Objeto Style