@media はCSS のアットルールで、1 つまたは複数のメディアクエリーの結果に基づいて、スタイルシートの一部を適用するために使用することができます。これによってメディアクエリーを指定し、そのメディアクエリーがコンテンツの使用される端末に一致する場合にのみ、文書に CSS のブロックを適用することができます。

試してみましょう

abbr {  color: #860304;  font-weight: bold;  transition: color 0.5s ease;}@media (hover: hover) {  abbr:hover {    color: #001ca8;    transition-duration: 0.5s;  }}@media not all and (hover: hover) {  abbr::after {    content: " (" attr(title) ")";  }}

<p>  <abbr title="National Aeronautics and Space Administration">NASA</abbr> is a  U.S. government agency that is responsible for science and technology related  to air and space.</p>

構文

/* コードの最上位 */@media screen and (width >= 900px) {  article {    padding: 1rem 3rem;  }}/* 他の条件付きアットルールの中にネスト */@supports (display: flex) {  @media screen and (width >= 900px) {    article {      display: flex;    }  }}

@media アットルールは、コードの最上位に配置したり、他の条件付きグループアットルールの中に入れ子にして配置したりすることができます。

メディアクエリーの構文について詳しくは、メディアクエリーの使用を参照してください。

解説

メディアクエリーの<media-query-list> には、<media-type>、<media-feature>、論理演算子があります。

メディア種別

<media-type> は機器の全般的な分類を記述します。not またはonly 論理演算子を使用する場合を除き、メディア種別は省略可能であり、暗黙でall と見なされます。

all

すべての機器に適合します。

print

ページのある資料や、画面に印刷プレビューモードで表示されている文書向けのものです。（これらの形式に特有の整形上の問題については、ページメディアを参照してください。）

screen

主に画面向けのものです。

メディア特性

<media feature> は、ユーザーエージェント、出力装置、環境の特定の特徴を記述します。メディア特性式は、その存在や、値、値の範囲を調べるもので、完全に任意です。それぞれのメディア特性式は、括弧で囲む必要があります。

any-hover

入力メカニズムで、ユーザーが要素上でのホバーを使用することができるものがあるか。

any-pointer

入力メカニズムにポインティングデバイスがあるか、もしそうであればどれだけ正確なものであるか。

aspect-ratio

ビューポートの幅対高さのアスペクト比。

color

出力機器の色成分あたりの色のビット数、または端末がカラーでなければゼロ。

color-gamut

ユーザーエージェントおよび出力機器が対応しているおよその色の範囲。

color-index

出力機器の色参照表の項目数、または端末がそのような表を使用していないのであればゼロ。

device-aspect-ratio

出力機器の幅対高さのアスペクト比。メディアクエリーレベル 4 で非推奨。

device-height

出力機器のレンダリング面の高さ。メディアクエリーレベル 4 で非推奨。

device-posture

端末の現在の姿勢、つまり、ビューポートが平らな状態か折りたたまれた状態かを検出します。Device Posture API で定義されています。

device-width

出力機器のレンダリング面の幅。メディアクエリーレベル 4 で非推奨。

display-mode

アプリケーションが表示されているモード。例えば、全画面モードやピクチャインピクチャモードなどです。メディアクエリーレベル 5 で追加。

dynamic-range

ユーザーエージェントおよび出力端末が対応している輝度、コントラスト比、および色深度の組み合わせ。メディアクエリーレベル 5 で追加されました。

forced-colors

ユーザーエージェントがカラーパレットを制限しているかどうかを検出。メディアクエリーレベル 5 で追加。

grid

出力機器はグリッドとビットマップ画面のどちらを使用するか。

height

ビューポートの高さ。

hover

主要な入力メカニズムで、ユーザーが要素上でのホバーを使用することができるか。

inverted-colors

ユーザーエージェントまたはその下の OS が色を反転しているか。メディアクエリーレベル 5 で追加。

monochrome

出力機器のモノクロフレームバッファーにおけるピクセルあたりのビット数、または端末がモノクロでなければゼロ。

orientation

ビューポートの向き。

overflow-block

ビューポートをブロック軸方向にあふれたコンテンツを出力機器がどのように扱うか。メディアクエリーレベル 4 で追加。

overflow-inline

ビューポートをインライン軸方向にあふれたコンテンツがスクロールできるか。メディアクエリーレベル 4 で追加。

pointer

主要な入力メカニズムがポインティングデバイスであるか、もしそうであればどれだけ正確なものであるか。メディアクエリーレベル 4 で追加。

prefers-color-scheme

ユーザーが明るいまたは暗い色遣いを望んでいるかどうかを検出。メディアクエリーレベル 5 で追加。

prefers-contrast

ユーザーがシステムに隣り合う色のコントラスト量を増加または減少させるよう要求したかどうかを検出。メディアクエリーレベル 5 で追加。

prefers-reduced-data

ユーザーが、インターネットのトラフィックの消費を抑えたウェブコンテンツをリクエストしたかどうかを検知します。

prefers-reduced-motion

ユーザーがページであまり動きを望まないかどうか。メディアクエリーレベル 5 で追加。

prefers-reduced-transparency

ユーザーが、端末で使用されている透明または半透明のレイヤー効果を抑制する設定を端末で有効にしているかどうかを検出します。

resolution

出力機器のピクセル密度。

scan

ディスプレイの表示出力がプログレッシブかインターレスか。

scripting

スクリプト（すなわち、 JavaScript）が有効かどうかを検出します。メディアクエリーレベル 5 で追加。

shape

端末の形状を検出して、長方形と丸いディスプレイを判別します。

update

どれだけの頻度で出力機器がコンテンツの表示を変更できるか。

video-dynamic-range

ユーザーエージェントの動画プレーンおよび出力端末が対応している、輝度、コントラスト比、および色深度の組み合わせ。メディアクエリーレベル 5 で追加されました。

width

スクロールバーの幅を含むビューポートの幅。

-moz-device-pixel-ratio

CSS ピクセル当たりのデバイスピクセル数。代わりにresolution 特性をdppx 単位で使用してください。

-webkit-animation

ブラウザーが-webkit の接頭辞の付いた CSSanimation に対応しているかどうか。代わりに@supports (animation) 機能クエリーを使用してください。

-webkit-device-pixel-ratio

CSS ピクセル当たりのデバイスピクセル数。代わりにresolution 特性をdppx 単位で使用してください。

-webkit-transform-2d

ブラウザーが-webkit の接頭辞の付いた 2D の CSStransform に対応しているかどうか。代わりに@supports (transform) 機能クエリーを使用してください。

-webkit-transform-3d

ブラウザーが-webkit の接頭辞の付いた 3D の CSStransform に対応しているかどうか。代わりに@supports (transform) 機能クエリーを使用してください。

-webkit-transition

ブラウザーが-webkit の接頭辞の付いた CSStransition に対応しているかどうか。代わりに@supports (transition) 機能クエリーを使用してください。

論理演算子

論理演算子not,and,only,or を使うと、複雑なメディアクエリーを構成することができます。また、複数のメディアクエリーをカンマで区切って 1 つのルールにまとめることもできます。

and

複数のメディア特性を 1 つのメディアクエリーに結合する際に使用されます。クエリーがtrue になるためには、結合させた各機能がtrue を返すことが必要です。また、メディア特性とメディア種別を結合する際にも使用されます。

not

メディアクエリーを反転するために使用され、クエリーがfalse を返す場合にtrue を返します。カンマで区切られたクエリーのリストの中にある場合は、適用された特定のクエリーのみを反転します。

メモ:レベル 3 では、個々のメディア特性式を否定するためにnot キーワードを使用することはできず、メディアクエリー全体のみを否定することしかできません。

only

クエリー全体が一致する場合にのみスタイルを適用します。これは、古いブラウザーが選択したスタイルを適用できないようにするのに便利です。only を使用しない場合、古いブラウザーはscreen and (width <= 500px) というクエリーをscreen と解釈し、クエリーの残りの部分を無視して、すべての画面にそのスタイルを適用してしまいます。only 演算子を使用する場合は、メディア種別も指定しなければなりません。

, (カンマ)

カンマは、複数のメディアクエリーを 1 つのルールにまとめるために使用されます。カンマで区切られたリストの各クエリーは、他のクエリーとは別に扱われます。したがって、リスト内のクエリーのいずれかがtrue であれば、メディア文全体がtrue を返すことになります。言い換えれば、リストは論理的なor 演算子のように動作します。

or

, 演算子と同等です。メディアクエリーレベル 4 で追加されました。

ユーザーエージェントクライアントヒント

一部のメディアクエリーには、対応するユーザーエージェントクライアントヒントがあります。これらは、特定のメディア要件に合わせて事前に最適化されたコンテンツをリクエストする HTTP ヘッダーです。Sec-CH-Prefers-Color-Scheme およびSec-CH-Prefers-Reduced-Motion が記載されています。

形式文法

@media =
  @media<media-query-list> {<rule-list> }

アクセシビリティ

サイトのテキストサイズを調整するユーザーに最適に対応するには、メディアクエリーに<length> が必要な場合はem を使用してください。

em およびpx はどちらも有効な単位ですが、em はユーザーがブラウザーのテキストの大きさを変更した場合に、よりうまく動作します。

また、ユーザーの使い勝手を向上させるために、メディアクエリーまたはHTTP ユーザーエージェントクライアントヒントを使用することを検討してください。例えば、prefers-reduced-motion または同等の HTTP ヘッダーであるSec-CH-Prefers-Reduced-Motion は、ユーザー設定に基づいて、アニメーションや動きの量を最小化するために使用することができます。

セキュリティ

メディアクエリーはユーザーが作業する端末の能力—およびその先にある、特性および設計—を調べる関係上、端末を識別する「フィンガープリント」を構築するために不正利用されたり、ユーザーにとって望ましくない観点のものに分類されるものに利用されたりする可能性があります。

この可能性のため、ブラウザーは返値がコンピューターを正確に識別するために使用することを防ぐために、何らかの方法で返値を偽造することがあります。ブラウザーは、この分野で他の手段を提供する場合もあります。例えば、 Firefox で「フィンガープリントの採取」をブロックしている場合、多くのメディアクエリーは実際の端末の状態を表す値ではなく既定値を報告します。

例

print および screen メディア種別の検査

@media print {  body {    font-size: 10pt;  }}@media screen {  body {    font-size: 13px;  }}@media screen, print {  body {    line-height: 1.2;  }}

範囲構文を使用すると、範囲を受け入れる機能を検査する際に、メディアクエリーを簡潔に記述することができます。その例を下記に示します。

@media (height > 600px) {  body {    line-height: 1.4;  }}@media (400px <= width <= 700px) {  body {    line-height: 1.4;  }}

他の例については、メディアクエリーの使用をご覧ください。

仕様書

ブラウザーの互換性

関連情報

• CSS メディアクエリーモジュール
• メディアクエリーの使用
• CSSMediaRule インターフェイス
• Mozilla 拡張メディア特性
• WebKit 拡張メディア特性