このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

CSS blur() 関数

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2016年9月以降、すべてのブラウザーで利用可能です。

blur()CSS関数で、入力画像にガウスぼかしを適用します。返値は <filter-function> です。

試してみましょう

filter: blur(0);
filter: blur(4px);
filter: blur(1.5rem);
<section id="default-example">
  <img
    class="transition-all"
    id="example-element"
    src="/shared-assets/images/examples/firefox-logo.svg"
    width="200" />
</section>

構文

css
blur()         /* 効果なし */
blur(0)        /* 効果なし */

blur(8px)      /* 半径 8px のぼかし */
blur(1.17rem)  /* 半径 1.17rem のぼかし */

引数

<length> 省略可

ぼかしの半径を指定します。ガウス関数の標準偏差の値を定義します。つまり、画面上のピクセルをいくつ互いに混合するかということです。すなわち、大きい値になるほどよりぼけます。0 の値は入力を変更しません。補間時の欠損値は 0 です。パーセント値は無効です。デフォルト値は 0 です。

SVG フィルター

SVG の <feGaussianBlur> フィルター要素もコンテンツをぼかすために使用することができます。このフィルターの stdDeviation 属性は最大 2 つの値を受け入れ、より複雑なぼかし値を作成することができます。同等のぼかしを作成するには、 stdDeviation に 1 つの値を記載します。この SVG 効果は ID で参照することができます。

html
<svg role="none">
  <filter id="blur11">
    <feGaussianBlur stdDeviation="1.1" edgeMode="duplicate" />
  </filter>
</svg>

次の宣言は同じ効果をもたらします。

css
filter: blur(1.1px);
filter: url("#blur11"); /* 埋め込み SVG による */
filter: url("folder/fileName.svg#blur11"); /* 外部の SVG フィルター定義 */

形式文法

<blur()> = 
blur( <length>? )
この構文は Filter Effects Module Level 1 による最新の標準を反映しています。すべてのブラウザーがすべての部分を実装しているわけではありません。サポート情報についてはブラウザーの互換性を参照してください。

この例では、 3 つの画像を表示させています。 blur() フィルター関数を適用した画像、同等の SVG blur 関数を適用した画像、そして比較用の元画像です。

css
.filter {
  filter: blur(3.5px);
}
html
<svg role="img" aria-label="Flag">
  <filter id="blur">
    <feGaussianBlur stdDeviation="3.5" edgeMode="duplicate" />
  </filter>
  <image
    href="https://mdn.github.io/shared-assets/images/examples/progress-pride-flag.jpg"
    xlink:href="https://mdn.github.io/shared-assets/images/examples/progress-pride-flag.jpg"
    filter="url('#blur')" />
</svg>

仕様書

仕様書
Filter Effects Module Level 1
# funcdef-filter-blur

ブラウザーの互換性

関連情報