Media query CSS

Media query terdiri dari jenis media dan paling sedikit satu ekspresi yang membatasi lingkup style sheets dengan menggunakan fitur media, seperti lebar, tinggi, dan warna. Media query, ditambahkan di CSS3, memungkinkan tampilan konten disesuaikan dengan alat penampil tertentu tanpa harus mengubah konten itu sendiri.

Sintaks

Media query terdiri dari jenis media (media type) dan dapat, sesuai dengan spesifikasi CSS3, mengandung satu atau lebih ekspresi, diekspresikan sebagai fitur media, baik benar (true) atau salah (false).  Hasil query adalah benar jika jenis media yang disebutkan dalam media query cocok dengan jenis alat yang digunakan untuk menampilkan dokumen dan semua ekspresi di dalam media query adalah benar.

<!-- Media query CSS pada elemen link -->
<link rel="stylesheet" media="(max-width: 800px)" href="example.css" />

<!-- Media query CSS di dalam style sheet -->
<style>
@media (max-width: 600px) {
  .facet_sidebar {
    display: none;
  }
}
</style>

Ketika sebuah media query adalah benar, style sheet atau aturan style yang bersangkutan diterapkan, sesuai dengan aturan cascading normal. Style sheet dengan media query yang menempel pada tag <link> masih akan diunduh bahkan jika media query tersebut adalah salah (false) (namun tidak akan diterapkan).

Kecuali jika Anda menggunakan operator not atau only, jenis media adalah opsional dan jenis all akan diterapkan.

Operator logika

Anda dapat merancang media query kompleks menggunakan operator logika, termasuk not, and, dan only. Operator and digunakan untuk menggabungkan banyak fitur media (media features) ke dalam satu media query tunggal, setiap fitur terkait harus benar (true) agar query benar (true). Operator not digunakan untuk menegasikan keseluruhan media query. Operator only digunakan untuk menerapkan suatu style hanya jika keseluruhan query cocok, berguna untuk mencegah browser lama menerapkan style-style tertentu. Jika Anda menggunakan operator-operator not atau only, Anda harus menyebutkan jenis media secara eksplisit.

Anda juga dapat menggabungkan banyak media query dalam sebuah daftar terpisah koma; jika ada media query di dalam daftar yang benar (true), keseluruhan pernyataan media adalah benar (true). Hal ini setara dengan operator or.

and

Kata kunci and digunakan untuk menggabungkan banyak fitur media menjadi satu, seperti menggabungkan fitur media dengan jenis media. Media query dasar, sebuah fitur media tunggal dengan jenis media all secara implisit, dapat terlihat seperti ini:

@media (min-width: 700px) { ... }

Namun, jika, Anda menginginkan hal ini diterapkan hanya untuk tampilan lanskap, Anda dapat menggunakan operator and untuk menggabungkan fitur-fitur media tersebut.

@media (min-width: 700px) and (orientation: landscape) { ... }

Sekarang media query di atas hanya akan benar jika lebar viewport adalah 700px atau lebih dan dalam tampilan lanskap. Namun, jika, Anda hanya menginginkan hal ini untuk diterapkan jika jenis media tampilan adalah TV, Anda dapat menggabungkan fitur-fitur ini dengan jenis media menggunakan operator and.

@media tv and (min-width: 700px) and (orientation: landscape) { ... }

Sekarang, media query di atas hanya akan diterapkan jika jenis media adalah TV, lebar viewport adalah 700px atau lebih, dan tampilan adalah lanskap.

daftar terpisah koma

Daftar terpisah koma adalah seperti operator logika or ketika digunakan dalam media query. Ketika menggunakan daftar media query terpisah koma, jika ada media query yang benar (true), style or style sheet akan diterapkan. Setiap media query di dalam daftar terpisah koma diperlakukan sebagai query individual, dan setiap operator yang diterapkan pada satu media query tidak mempengaruhi yang lainnya. Ini berarti daftar media query terpisah koma dapat ditujukan  untuk fitur, jenis, dan kondisi media yang berbeda.

Sebagai contoh, seandainya Anda ingin menerapkan seperangkat style jika alat penampil memiliki lebar minimum 700px atau alat genggam dalam moda lanskap, Anda dapat menulis sebagai berikut:

@media (min-width: 700px), handheld and (orientation: landscape) { ... }

Pada contoh di atas, jika saya menggunakan perangkat screen dengan lebar viewport 800px, pernyataan media akan benar (true) karena bagian pertama, yang diinterpetasikan sebagai @media all and (min-width: 700px) akan berlaku pada perangkat saya dan oleh karena itu benar (true), terlepas dari fakta bahwa perangkat screen saya akan gagal dalam pengecekan jenis media handheld di media query kedua. Demikian pula, jika saya menggunakan perangkat genggam handheld dalam moda lanskap dengan lebar viewport 500px, walaupun media query pertama gagal karena lebar viewport tidak sesuai, media query kedua akan berhasil dan oleh karena itu pernyataan media akan menghasilkan nilai benar (true).

not

Kata kunci not berlaku pada keseluruhan media query dan memberikan nilai benar (true) jika media query akan sebaliknya memberikan nilai salah (false) (seperti fitur query monochrome pada warna tampilan atau lebar layar 600px dengan min-width: 700px). Sebuah not hanya akan menegasikan media query yang ditetapkan dan bukan setiap media query jika ada dalam daftar media query terpisah koma. Kata kunci not tidak dapat digunakan untuk menegasikan sebuah fitur query individual, hanya untuk media query secara keseluruhan. Sebagai contoh, not dievaluasi paling akhir dalam query berikut ini:

@media not all and (monochrome) { ... }

Ini berarti bahwa query tersebut dievaluasi seperti ini:

@media not (all and (monochrome)) { ... }

... bukan seperti ini:

@media (not all) and (monochrome) { ... }

Sebagai contoh lain, lihat media query berikut ini:

@media not screen and (color), print and (color)

Yang dievaluasi seperti ini:

@media (not (screen and (color))), print and (color)

only

Kata kunci only mencegah browser lama yang tidak mendukung media query dengan fitur media menerapkan style yang disediakan:

<link rel="stylesheet" media="only screen and (color)" href="example.css" />

Pseudo-BNF (untuk Anda yang gemar hal seperti ini)

media_query_list: <media_query> [, <media_query> ]*
media_query: [[only | not]? <media_type> [ and <expression> ]*]
  | <expression> [ and <expression> ]*
expression: ( <media_feature> [: <value>]? )
media_type: all | aural | braille | handheld | print |
  projection | screen | tty | tv | embossed
media_feature: width | min-width | max-width
  | height | min-height | max-height
  | device-width | min-device-width | max-device-width
  | device-height | min-device-height | max-device-height
  | aspect-ratio | min-aspect-ratio | max-aspect-ratio
  | device-aspect-ratio | min-device-aspect-ratio | max-device-aspect-ratio
  | color | min-color | max-color
  | color-index | min-color-index | max-color-index
  | monochrome | min-monochrome | max-monochrome
  | resolution | min-resolution | max-resolution
  | scan | grid

Media query adalah case insensitive.  Media query yang melibatkan jenis media yang tidak diketahui selalu salah (false).

Fitur media

Sebagian besar fitur media dapat diawali dengan "min-" atau "max-" untuk mengekspresikan batasan "lebih dari atau sama dengan" atau "kurang dari atau sama dengan".  Hal ini menghindari penggunaan simbol "<" dan ">", yang mungkin akan menyebabkan konflik dengan HTML dan XML.  Jika Anda  menggunakan fitur media tanpa nilai tertentu, ekspresi tersebut akan bernilai benar (true) jika nilai fitur adalah bukan-nol.

color

Nilai: <color>
Media: media/visual
Menerima prefiks min/max prefixes: ya

Menunjukkan jumlah per komponen warna dari alat penampil.  Jika alat tersebut bukan alat yang memiliki warna, nilai ini adalah nol.

Contoh

Untuk menerapkan style sheet pada semua alat berwarna:

@media all and (color) { ... }

Untuk menerapkan style sheet pada alat yang memiliki paling sedikit 4 bit per komponen warna:

@media all and (min-color: 4) { ... }

color-index

Nila: <integer>
Media: media/visual
Menerima prefiks min/max: ya

Menunjukkan jumlah entri dalam tabel pencarian warna untuk alat penampil.

Contoh

Untuk menunjukkan bahwa suatu style sheet harus diterapkan pada semua alat yang menggunakan warna terindeks, Anda dapat melakukan:

@media all and (color-index) { ... }

Untuk menerapkan style sheet pada alat berwarna terindeks dengan paling sedikit 256 warna:

<link rel="stylesheet" media="all and (min-color-index: 256)" href="https://foo.bar.com/stylesheet.css" />

aspect-ratio

Nilai: <ratio>
Media: media/visual, media/tactile
Menerima prefiks min/max: ya

Menggambarkan rasio aspek daerah tampilan dari alat penampil.  Nilai ini terdiri dari dua integer positif dipisahkan oleh karakter garis miring ("/").  Ini menunjukkan rasio piksel horisontal (angka pertama) terhadap piksel vertikal (angka kedua).

Contoh

Berikut ini memilih style sheet khusus untuk digunakan ketika daerah tampilan paling tidak selebar tingginya.

@media screen and (min-aspect-ratio: 1/1) { ... }

Ini memilih style ketika rasio aspek adalah 1:1 atau lebih. Dengan kata lain, style-style ini hanya akan diterapkan ketika area penampil adalah bujursangkar atau lanskap.

device-aspect-ratio

Nilai: <ratio>
Media: media/visual, media/tactile
Menerima prefiks min/max: ya

Menggambarkan rasio aspek dari alat penampil.  Nilai ini terdiri dari dua integer positif dipisahkan oleh karakter garis miring ("/").  Hal ini menunjukkan rasio piksel horisontal (yang pertama) terhadap piksel vertikal (yang kedua).

Contoh

Berikut ini memilih style sheet khusus yang digunakan untuk tampilan layar lebar.

@media screen and (device-aspect-ratio: 16/9), screen and (device-aspect-ratio: 16/10) { ... }

Ini memilih style ketika rasio aspek adalah 16:9 atau 16:10.

device-height

Nilai: <length>
Media: media/visual, media/tactile
Menerima prefiks min/max: ya

Menggambarkan tinggi alat penampil (berarti keseluruhan layar atau halaman, bukan hanya area render, seperti jendela dokumen).

Contoh

Untuk menerapkan style sheet pada sebuah dokument ketika ditampilkan pada layar yang memiliki panjang kurang dari 800 piksel, Anda dapat menggunakan ini:

<link rel="stylesheet" media="screen and (max-device-height: 799px)" />

device-width

Nilai: <length>
Media: media/visual, media/tactile
Menerima prefiks min/max: ya

Menggambarkan lebar alat penampil (berarti keseluruhan layar atau halaman, bukan hanya area render, seperti jendela dokumen).

Contoh

Untuk menerapkan style sheet pada sebuah dokumen ketika ditampilkan pada layar yang memiliki lebar kurang dari 800 piksel wide, Anda dapat menggunakan ini:

<link rel="stylesheet" media="screen and (max-device-width: 799px)" />

grid

Nilai: <integer>
Media: all
Menerima prefiks min/max: tidak

Menentukan apakah alat penampil adalah sebuah alat grid atau bitmap.  Jika alat tersebut berbasis grid (seperti terminal TTY atau layar telepon dengan hanya satu font), nilai adalah 1.  Jika tidak, nilai adalah nol.

Contoh

Untuk menerapkan suatu style pada alat genggam dengan layar selebar 15-karakter atau kurang:

@media handheld and (grid) and (max-width: 15em) { ... }

height

Nilai: <length>
Media: media/visual, media/tactile
Menerima prefiks min/max: ya

Fitur media height (tinggi) menggambarkan tinggi permukaan rendering alat penampil (seperti tinggi viewport atau kotak halaman pada sebuah printer).

monochrome

Nilai: <integer>
Media: media/visual
Menerima prefiks min/max: ya

Menunjukkan jumlah bit per piksel pada alat monokrom (keabuan).  Jika alat tersebut bukan monokrom, nilai alat tersebut adalah 0.

Contoh

Untuk menerapkan style sheet pada semua alat monokrom:

@media all and (monochrome) { ... }

Untuk menerapkan style sheet pada alat monokrom dengan paling sedikit 8 bit per piksel:

@media all and (min-monochrome: 8) { ... }

orientation

Nilai: landscape | portrait
Media: media/visual
Menerima prefiks min/max: tidak

Menunjukkan apakah viewport dalam mode lanskap (tampilan lebih lebar daripada tingginya) atau potret (tampilan lebih tinggi daripada lebarnya).

Contoh

Untuk menerapkan style sheet hanya pada orientasi potret:

@media all and (orientation: portrait) { ... }

resolution

Nilai: <resolution>
Media: bitmap
Menerima prefiks min/max: ya

Menunjukkan resolusi (kepadatan piksel) alat penampil. Resolution mungkin disebutkan dalam dots per inch (dpi - titik per inci) atau dots per centimeter (dpcm - titik per sentimeter).

Contoh

Untuk menerapkan style sheet pada alat dengan resolusi paling sedikit 300 dpi:

@media print and (min-resolution: 300dpi) { ... }

Untuk mengganti sintaks lama (min-device-pixel-ratio: 2):

@media screen and (min-resolution: 2dppx) { ... }

scan

Nilai: progressive | interlace
Media: media/tv
Menerima prefiks min/max: tidak

Menggambarkan proses pemindaian alat penampil televisi.

Contoh

Untuk menerapkan style sheet hanya pada televisi pemindai progresif:

@media tv and (scan: progressive) { ... }

width

Nilai: <length>
Media: media/visual, media/tactile
Menerima prefiks min/max: ya

Fitur media width menggambarkan lebar permukaan rendering alat penampil (seperti lebar jendela dokumen, atau lebar kotak halaman sebuah printer).

Contoh

Jika Anda ingin menentukan sebuah style sheet untuk perangkat genggam, atau perangkat layar dengan lebar lebih besar dari 20em, Anda dapat menggunakan query ini:

@media handheld and (min-width: 20em), screen and (min-width: 20em) { ... }

Query Media ini menentukan style sheet yang berlaku untuk media cetak lebih lebar dari 8,5 inci:

<link rel="stylesheet" media="print and (min-width: 8.5in)"
    href="https://foo.com/mystyle.css" />

Query ini menentukan style sheet yang digunakan saat lebar viewport adalah antara 500 dan 800 pixel:

@media screen and (min-width: 500px) and (max-width: 800px) { ... }

Fitur Media Spesifik Mozilla

Mozilla menawarkan beberapa fitur media spesifik Gecko. Beberapa di antaranya mungkin diusulkan sebagai fitur media resmi.

Nilai: <integer>
Media: media/visual
Meneriman prefiks min/max: tidak

Jika perangkat memungkinkan gambar untuk muncul dalam menu, ini adalah 1; jika tidak, nilainya adalah 0. Ini berhubungan dengan pseudo-class CSS :-moz-system-metric(images-in-menus).

Nilai: <integer>
Media: media/visual
Menerima prefiks min/max: no

Jika user telah mengkonfigurasi perangkat mereka untuk menggunakan tampilan "Graphite" pada Mac OS X, ini adalah 1. Jika pengguna menggunakan tampilan biru standar, atau bukan pada Mac OS X, ini adalah 0.

Ini berkaitan dengan pseudo-class CSS :-moz-system-metric(mac-graphite-theme).

Nilai: <integer>
Media: media/visual
Menerima prefiks min/max: tidak

Jika user menggunakan Maemo dengan tema asli, ini adalah 1; jika menggunakan tema Fremantle yang lebih baru, ini adalah 0.

Ini berkaitan dengan pseudo-class CSS :-moz-system-metric(maemo-classic).

Nilai: <number>
Media: media/visual
Menerima prefiks min/max: ya

Memberikan jumlah piksel perangkat per piksel CSS.

@media (-webkit-min-device-pixel-ratio: 2), /* Browsers berbasis Webkit */
       (min--moz-device-pixel-ratio: 2),    /* Browsers yang lebih tua (sebelum Firefox 16) */
       (min-resolution: 2dppx),             /* Cara standar */
       (min-resolution: 192dpi)             /* fallback dppx */ 

Nilai: windows-xp | windows-vista | windows-win7 | windows-win8
Media: media/visual
Menerima prefiks min/max: tidak

Menunjukkan versi sistem operasi mana yang sedang digunakan saat ini. Saat ini hanya diimplementasikan pada Windows. Nilai-nilai yang mungkin adalah:

• windows-xp
• windows-vista
• windows-win7
• windows-win8

Ini disediakan untuk aplikasi skins dan kode chrome lainnya agar dapat beradaptasi untuk bekerja dengan baik dengan versi sistem operasi saat ini.

Nilai: <integer>
Media: media/visual
Menerima prefiks min/max: no

Jika user interface perangkat menampilkan tombol panah kembali di akhir scrollbar, ini adalah 1. Jika tidak, bernilai 0.

Ini berkaitan dengan pseudo-class CSS :-moz-system-metric(scrollbar-end-backward).

Nilai: <integer>
Media: media/visual
Menerima prefiks min/max: tidak

If the device's user interface displays a forward arrow button at the end of scrollbars, this is 1. Otherwise it's 0.

This corresponds to the :-moz-system-metric(scrollbar-end-forward) CSS pseudo-class.

Value: <integer>
Media: media/visual
Accepts min/max prefixes: no

If the device's user interface displays a backward arrow button at the beginning of scrollbars, this is 1. Otherwise it's 0.

This corresponds to the :-moz-system-metric(scrollbar-start-backward) CSS pseudo-class.

Value: <integer>
Media: media/visual
Accepts min/max prefixes: no

If the device's user interface displays a forward arrow button at the beginning of scrollbars, this is 1. Otherwise it's 0.

This corresponds to the :-moz-system-metric(scrollbar-start-forward) CSS pseudo-class.

Value: <integer>
Media: media/visual
Accepts min/max prefixes: no

If the device's user interface displays the thumb of scrollbars proportionally (that is, sized based on the percentage of the document that is visible), this is 1. Otherwise it's 0.

This corresponds to the :-moz-system-metric(scrollbar-thumb-proportional) CSS pseudo-class.

Value: <integer>
Media: media/visual
Accepts min/max prefixes: no

If the device supports touch events (for a touch screen), this is 1. Otherwise it's 0.

This corresponds to the :-moz-system-metric(touch-enabled) CSS pseudo-class.

Example

You might use this to render your buttons slightly larger, for example, if the user is on a touch-screen device, to make them more finger-friendly.

Value: <integer>
Media: media/visual
Accepts min/max prefixes: no

If the user is using Windows unthemed (in classic mode instead of using uxtheme), this is 1; otherwise it's 0.

This corresponds to the :-moz-system-metric(windows-classic) CSS pseudo-class.

Value: <integer>
Media: media/visual
Accepts min/max prefixes: no

If the user is using Windows with the DWM compositor, this is 1; otherwise it's 0.

This corresponds to the :-moz-system-metric(windows-compositor) CSS pseudo-class.

Value: <integer>
Media: media/visual
Accepts min/max prefixes: no

If the user is currently using one of the default Windows themes (Luna, Royale, Zune, or Aero (including Vista Basic, Vista Advanced, and Aero Glass), this is 1. Otherwise it's 0.

This corresponds to the :-moz-system-metric(windows-default-theme) CSS pseudo-class.

Value: <integer>
Media: media/visual
Accepts min/max prefixes: no

If the user is using Windows Glass theme, this is 1; otherwise it's 0. Note that this only exists for Windows 7 and earlier.

Value: aero | luna-blue | luna-olive | luna-silver | royale | generic | zune
Media: media/visual
Accepts min/max prefixes: no

Indicates which Windows theme is currently being used. Only available on Windows. Possible values are:

• aero
• luna-blue
• luna-olive
• luna-silver
• royale
• generic
• zune

This is provided for application skins and other chrome code to be able to adapt to work well with the current Windows theme.

Browser compatibility

See also

• CSS 3 media query specification
• Media types
• Using media queries from code
• List of mobile and tablet viewport sizes with pixel ratios and physical sizes
• CSS Animations Between Media Queries by David Walsh