Style 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()"

Filter 関数

注意:フィルターは通常、パーセンテージ(例: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 の背景で定義) 型の値を受け入れますが、'inset' キーワードは許可されません。この関数は既存の box-shadow プロパティと非常に似ています。違いは、フィルターを通すことで、一部のブラウザーではパフォーマンス向上のためにハードウェアアクセラレーションが提供されることです。<shadow>参数如下:

<offset-x> <offset-y> (必須)
これは影のオフセットを設定する 2 つの <length> 値です。<offset-x>水平方向の距離を設定します。負の値にすると、影は要素の左側に表示されます。<offset-y>垂直方向の距離を設定します。負の値にすると、影は要素の上に表示されます。参照<length>可能な単位。
2 つの値が両方とも0の場合、影は要素の真後ろに表示されます (ぼかしを設定すると <blur-radius> and/or <spread-radius>,ぼかし効果があります)。).
<blur-radius> (オプション)
これは 3 番目の <length> 値です。値が大きいほどぼやけ、影はより大きく、より淡くなります。負の値は許可されません。設定されていない場合、デフォルトは 0 です (影の境界は非常にシャープになります)。
<spread-radius> (オプション)
これは 4 番目の <length> 値です。正の値は影を拡大・大きくし、負の値は影を縮小します。設定されていない場合、デフォルトは 0 です (影は要素と同じサイズになります)。
注意: Webkit および一部の他のブラウザは 4 番目の長さをサポートしておらず、追加してもレンダリングされません。
 
<color> (オプション)
<color> の値に指定できるキーワードと記号を参照してください。設定されていない場合、色の値はブラウザに基づきます。Gecko (Firefox)、Presto (Opera)、Trident (Internet Explorer) では、color プロパティcolorの値が適用されます。また、色の値が省略された場合、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 関数は、SVG フィルターを設定した XML ファイルを受け入れ、特定のフィルター要素を指定するためのアンカーを含めることができます。

例:

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

プロパティをデフォルト値に設定するには、次を参照してください:CSS initial キーワード

inherit 親要素からプロパティを継承するには、次を参照してください:CSS inherit キーワード

技術詳細

CSS バージョン CSS3


関連記事

CSS リファレンス:filter プロパティ


Style 对象参考手册Style オブジェクト

その他の拡張