Стиль filterСвойство

Style 对象参考手册Объект Style

Примеры

Измените цвет изображения на чёрно-белый (100% оттенков серого):

// Браузеры Chrome, Safari и Opera
document.getElementById("myImg").style.WebkitFilter = "grayscale(100%)";

// Стандартный синтаксис (не поддерживается другими основными браузерами)
document.getElementById("myImg").style.filter = "grayscale(100%)";

Попробуйте »

Определение и использование

Свойство filter используется для определения визуальных эффектов элемента (обычно <img>).

Примечание:Если элемент не является гибким элементом, свойство flexGrow не оказывает эффекта.


Поддержка браузеров

Числа в таблице показывают первую версию браузера, которая полностью поддерживает это свойство.

Свойство
filter 18.0 Webkit Не поддерживается Не поддерживается 6.0 Webkit 15.0 Webkit

Примечание:Chrome, Safari и Opera вместо этого используют свойство WebkitFilter.


Синтаксис

Возвращает свойство filter:

object.style.filter

Устанавливает свойство filter:

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

Функции фильтра

Примечание:Фильтры обычно используют проценты (например, 75%), но также можно использовать десятичные числа (например, 0.75).

Filter Описание
none Значение по умолчанию; без эффекта.
blur(px) Применяет размытие по Гауссу к изображению. Значение "radius" задаёт стандартное отклонение функции Гаусса или то, сколько пикселей на экране смешиваются вместе, поэтому чем больше значение, тем сильнее размыто изображение;

Если значение не задано, по умолчанию используется 0; этот параметр может принимать значения длины CSS, но не процентные значения.
brightness(%) Применяет линейный множитель к изображению, делая его ярче или темнее. Если значение равно 0%, изображение станет полностью чёрным. Значение 100% оставляет изображение без изменений. Другие значения соответствуют эффектам линейного множителя. Также допускаются значения больше 100%, что делает изображение ярче, чем раньше. Если значение не задано, по умолчанию используется 1.
contrast(%) Настраивает контрастность изображения. Значение 0% делает изображение полностью чёрным. Значение 100% оставляет изображение без изменений. Допускаются значения больше 100%, что означает применение более низкой контрастности. Если значение не задано, по умолчанию используется 1.
drop-shadow(h-shadow v-shadow blur spread color)

Применяет к изображению эффект тени. Тень накладывается под изображением и может быть размытой смещённой версией маски, нарисованной определённым цветом. Функция принимает значение типа <shadow> (определённого в CSS3 backgrounds), за исключением того, что ключевое слово "inset" не допускается. Эта функция очень похожа на существующее свойство box-shadow; разница в том, что благодаря фильтрам некоторые браузеры обеспечивают аппаратное ускорение для лучшей производительности.<shadow>参数如下:

<offset-x> <offset-y> (обязательно)
Это два значения <length>, которые задают смещение тени.<offset-x>Задаёт горизонтальное расстояние. Отрицательное значение размещает тень слева от элемента.<offset-y>Задаёт вертикальное расстояние. Отрицательное значение размещает тень над элементом. См.<length>возможные единицы.
Если оба значения равны0, тень появляется непосредственно за элементом (если задано <blur-radius> and/or <spread-radius>,there will be a blur effect.).
<blur-radius> (необязательно)
Это третье значение <length>. Чем больше значение, тем более размытой будет тень, и тень станет больше и светлее. Отрицательные значения не допускаются. Если не задано, по умолчанию используется 0 (край тени очень резкий).
<spread-radius> (необязательно)
Это четвёртое значение <length>. Положительные значения расширяют и увеличивают тень, отрицательные — уменьшают тень. Если не задано, по умолчанию используется 0 (тень будет того же размера, что и элемент).
Примечание: WebKit и некоторые другие браузеры не поддерживают четвёртое значение длины; если его добавить, оно не будет отображаться.
 
<color> (необязательно)
См. <color> для возможных ключевых слов и обозначений для этого значения. Если не задано, значение цвета зависит от браузера. В Gecko (Firefox), Presto (Opera) и Trident (Internet Explorer) используется значение свойства colorcolor. Кроме того, если значение цвета опущено, в WebKit тень прозрачна.
grayscale(%)

Преобразует изображение в оттенки серого. Значение определяет долю преобразования. Значение 100% полностью преобразует изображение в оттенки серого, а значение 0% оставляет изображение без изменений. Значения от 0% до 100% являются линейными множителями эффекта. Если не задано, значение по умолчанию равно 0.

hue-rotate(deg)

Применяет к изображению поворот оттенка. Значение "angle" задаёт угол оттенка, на который будет скорректировано изображение. Значение 0deg оставляет изображение без изменений. Если значение не задано, по умолчанию используется 0deg. Хотя максимального значения нет, значения больше 360deg эквивалентны повторному проходу по кругу.

invert(%)

Инвертирует входное изображение. Значение определяет долю преобразования. Значение 100% полностью инвертировано. Значение 0% оставляет изображение без изменений. Значения от 0% до 100% являются линейными множителями эффекта. Если значение не задано, по умолчанию используется 0.

opacity(%)

Преобразует прозрачность изображения. Значение определяет долю преобразования. Значение 0% полностью прозрачно, а значение 100% оставляет изображение без изменений. Значения от 0% до 100% являются линейными множителями эффекта, что эквивалентно умножению образцов изображения на величину. Если значение не задано, по умолчанию используется 1. Эта функция очень похожа на существующее свойство opacity; разница в том, что через filter некоторые браузеры обеспечивают аппаратное ускорение для повышения производительности.

saturate(%)

Преобразует насыщенность изображения. Значение определяет долю преобразования. Значение 0% полностью ненасыщенно, а значение 100% оставляет изображение без изменений. Другие значения являются линейными множителями эффекта. Значения выше 100% допускаются, обеспечивая более высокую насыщенность. Если значение не задано, по умолчанию используется 1.

sepia(%)

Преобразует изображение в сепию. Значение определяет долю преобразования. Значение 100% полностью сепия, а значение 0% оставляет изображение без изменений. Значения от 0% до 100% являются линейными множителями эффекта. Если не задано, значение по умолчанию равно 0.

url()

Функция URL принимает XML-файл, который задаёт SVG-фильтр, и может включать якорь для указания конкретного элемента фильтра.

Например:

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

Чтобы установить свойство в значение по умолчанию, см.:CSS-ключевое слово initial

inherit Чтобы наследовать свойство от родительского элемента, см.:CSS-ключевое слово inherit

Технические детали

Версия CSS CSS3


Связанные статьи

Справочник по CSS:свойство filter


Style 对象参考手册Объект Style

Другие расширения