Style filterプロパティ
例
画像の色を白黒に変更 (100% グレースケール):
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 プロパティと非常に似ています。違いは、フィルターを通すことで、一部のブラウザーではパフォーマンス向上のためにハードウェアアクセラレーションが提供されることです。
|
| 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 オブジェクト