CSS filter 属性

实例

把所有图像都改为黑白（100% 灰色）：

img {
  filter: grayscale(100%);
}

亲自试一试

提示：可以在页面下方找到更多 TIY 实例。

定义和用法

filter 属性定义元素（通常是 <img>）的视觉效果（如模糊和饱和度）。

默认值： none
继承： 否
动画制作： 支持。请参阅：动画相关属性。
版本： CSS3
JavaScript 语法： object.style.filter="grayscale(100%)"

浏览器支持

表格中的数字注明了完全支持该属性的首个浏览器版本。

带 -webkit- 的数字表示使用前缀的首个版本。

属性 Chrome IE Firefox Safari Opera
filter 53.0
18.0 -webkit-		 13.0 35.0 9.1
6.0 -webkit-		 40.0
15.0 -webkit-

注释：较旧版本的 Internet Explorer（4. 0到 8.0）支持已弃用的非标准 "filter" 属性。当需要 IE8 及更低版本的支持时，主要用于不透明度。

CSS 语法

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

提示：如需使用多个滤镜，请用空格分隔每个滤镜（参见页面下方的更多实例）。

滤镜函数

注释：使用百分比值（例如 75％）的滤镜，也接受该值是十进制（例如 0.75）。

滤镜 描述
none 默认值。规定无效果。
blur(px)

对图像应用模糊效果。较大的值将产生更多的模糊。

如果为指定值，则使用 0。
brightness(%)

调整图像的亮度。

  • 0％ 将使图像完全变黑。
  • 默认值是 100％，代表原始图像。
  • 值超过 100％ 将提供更明亮的结果。
contrast(%)

调整图像的对比度。

  • 0％ 将使图像完全变黑。
  • 默认值是 100％，代表原始图像。
  • 超过 100％ 的值将提供更具对比度的结果。
drop-shadow(h-shadow v-shadow blur spread color)

对图像应用阴影效果。

可能的值：

  • h-shadow - 必需。指定水平阴影的像素值。负值会将阴影放置在图像的左侧。
  • v-shadow - 必需。指定垂直阴影的像素值。负值会将阴影放置在图像上方。

blur -可选。这是第三个值，单位必须用像素。为阴影添加模糊效果。值越大创建的模糊就越多（阴影会变得更大更亮）。不允许负值。如果未规定值，会使用 0（阴影的边缘很锐利）。

spread - 可选。这是第四个值，单位必须用像素。正值将导致阴影扩展并增大，负值将导致阴影缩小。如果未规定值，会使用 0（阴影与元素的大小相同）。

注释：Chrome、Safari 和 Opera，也许还有其他浏览器，不支持第 4 个长度；如果添加，则不会呈现。

color - 可选。为阴影添加颜色。如果未规定，则颜色取决于浏览器（通常为黑色）。

这个例子创建了红色的阴影，水平和垂直方向均为 8px，带有 10px 的模糊效果：

filter: drop-shadow(8px 8px 10px red);

提示：这个滤镜类似 box-shadow 属性。
grayscale(%)

将图像转换为灰阶。

  • 0% (0) 是默认值，代表原始图像。
  • 100％ 将使图像完全变灰（用于黑白图像）。

注释：不允许负值。
hue-rotate(deg)

在图像上应用色相旋转。该值定义色环的度数。默认值为 0deg，代表原始图像。

注释：最大值是 360deg。
invert(%)

反转图像中的样本。

  • 0% (0) 是默认值，代表原始图像。
  • 100％将使图像完全反转。

注释：不允许负值。
opacity(%)

设置图像的不透明度级别。opacity-level 描述了透明度级别，其中：

  • 0% 为完全透明。
  • 100% (1) 是默认值，代表原始图像（不透明）。

注释：不允许负值。

提示：这个滤镜类似 opacity 属性。
saturate(%)

设置图像的饱和度。

  • 0% (0) will make the image completely un-saturated.
  • 100% is default and represents the original image.
  • Values over 100% provides super-saturated results.

注释：不允许负值。
sepia(%)

将图像转换为棕褐色。

  • 0% (0) 是默认值，代表原始图像。
  • 100％ 将使图像完全变为棕褐色。

注释：不允许负值。
url()

url() 函数接受规定 SVG 滤镜的 XML 文件的位置，并且可以包含指向特定滤镜元素的锚点。实例：

filter: url(svg-url#element-id)
initial 将此属性设置为其默认值。参阅 initial。
inherit 从其父元素继承此属性。参阅 inherit。

更多实例

模糊实例

为图像添加模糊效果：

img {
  filter: blur(5px);
}

亲自试一试

模糊实例 2

应用模糊的背景图片：

img.background {
  filter: blur(35px);
}

亲自试一试

亮度实例

调整图像的亮度：

img {
  filter: brightness(200%);
}

亲自试一试

对比度实例

调整图像的对比度：

img {
  filter: contrast(200%);
}

亲自试一试

阴影实例

为图像应用阴影效果：

img {
  filter: drop-shadow(8px 8px 10px gray);
}

亲自试一试

灰阶实例

将图像转换为灰阶：

img {
  filter: grayscale(50%);
}

亲自试一试

色相旋转实例

在图像上应用色相旋转：

img {
  filter: hue-rotate(90deg);
}

亲自试一试

反转实例

反转图像中的样本：

img {
  filter: invert(100%);
}

亲自试一试

不透明度实例

设置图像的不透明度级别：

img {
  filter: opacity(30%);
}

亲自试一试

饱和度实例

调整图像的饱和度：

img {
  filter: saturate(800%);
}

亲自试一试

棕褐色实例

将图像转换为棕褐色：

img {
  filter: sepia(100%);
}

亲自试一试

使用多重滤镜

要使用多个滤镜，请用空格分隔每个滤镜。请注意，顺序很重要（例如在 sepia() 之后使用 grayscale() 将产生完全灰色的图像）：

img {
  filter: contrast(200%) brightness(150%);
}

亲自试一试

所有滤镜

演示所有滤镜函数：

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

.brightness {
  filter: brightness(0.30);
}

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

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

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

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

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

.saturate {
  filter: saturate(7);
}

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

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

亲自试一试

相关页面

CSS 教程：CSS 图像

HTML DOM 参考手册：filter 属性

CSS 参考手册

CSS 属性

目录