@media

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

/* コードの最上位 */
@media screen and (min-width: 900px) {
  article {
    padding: 1rem 3rem;
  }
}

/* 他の条件付きアットルールの中にネスト */
@supports (display: flex) {
  @media screen and (min-width: 900px) {
    article {
      display: flex;
    }
  }
}

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

メディアクエリーの <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 の接頭辞の付いた CSS animation に対応しているかどうか。代わりに @supports (animation) 機能クエリーを使用してください。

-webkit-device-pixel-ratio

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

-webkit-transform-2d 非推奨; 非標準

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

-webkit-transform-3d

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

-webkit-transition 非推奨; 非標準

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

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

and

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

not

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

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

only

クエリー全体が一致する場合にのみスタイルを適用します。 これは、古いブラウザーが選択したスタイルを適用できないようにするのに便利です。 only を使用しない場合、古いブラウザーは screen and (max-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 で「フィンガープリントの採取」をブロックしている場合、多くのメディアクエリーは実際の端末の状態を表す値ではなく既定値を報告します。

@media print {
  body {
    font-size: 10pt;
  }
}

@media screen {
  body {
    font-size: 13px;
  }
}

@media screen, print {
  body {
    line-height: 1.2;
  }
}

@media only screen and (min-width: 320px) and (max-width: 480px) and (resolution: 150dpi) {
  body {
    line-height: 1.4;
  }
}

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

@media (height > 600px) {
  body {
    line-height: 1.4;
  }
}

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

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

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