Using media queries
A media query consists of an optional media type and zero or more expressions that limit the style sheets' scope by using media features, such as width, height, and color. Media queries, added in CSS3, let the presentation of content be tailored to a specific range of output devices without having to change the content itself.
Syntax
Media queries consist of an optional media type and can, as of the CSS3 specification, contain zero or more expressions, expressed as media features, which resolve to either true or false. The result of the query is true if the media type specified in the media query matches the type of device the document is being displayed on and all expressions in the media query are true.
<!-- CSS media query on a link element --> <link rel="stylesheet" media="(max-width: 800px)" href="example.css" /> <!-- CSS media query within a stylesheet --> <style> @media (max-width: 600px) { .facet_sidebar { display: none; } } </style>
When a media query is true, the corresponding style sheet or style rules are applied, following the normal cascading rules. Style sheets with media queries attached to their
tags will still download even if their media queries would return false (they will not apply, however).<link>
Unless you use the not
or only
operators, the media type is optional and the all
type will be implied.
Logical operators
You can compose complex media queries using logical operators, including not
, and
, and only
. The and
operator is used for combining multiple media features together into a single media query, requiring each chained feature to return true in order for the query to be true. The not
operator is used to negate an entire media query. The only
operator is used to apply a style only if the entire query matches, useful for preventing older browsers from applying selected styles. If you use the not
or only
operators, you must specify an explicit media type.
You can also combine multiple media queries in a comma-separated list; if any of the media queries in the list is true, the entire media statement returns true. This is equivalent to an or
operator.
and
The and
keyword is used for combining multiple media features together, as well as combining media features with media types. A basic media query, a single media feature with the implied all
media type, could look like this:
@media (min-width: 700px) { ... }
If, however, you wanted this to apply only if the display is in landscape, you could use an and
operator to chain the media features together.
@media (min-width: 700px) and (orientation: landscape) { ... }
Now the above media query will only return true if the viewport is 700px wide or wider and the display is in landscape. If, however, you only wanted this to apply if the display in question was of the media type TV, you could chain these features with a media type using an and
operator.
@media tv and (min-width: 700px) and (orientation: landscape) { ... }
Now, the above media query will only apply if the media type is TV, the viewport is 700px wide or wider, and the display is in landscape.
comma-separated lists
Comma-separated lists behave like the logical operator or
when used in media queries. When using a comma-separated list of media queries, if any of the media queries returns true, the styles or style sheets get applied. Each media query in a comma-separated list is treated as an individual query, and any operator applied to one media query does not affect the others. This means the comma-separated media queries can target different media features, types, and states.
For instance, if you wanted to apply a set of styles if the viewing device either had a minimum width of 700px or was a handheld in landscape, you could write the following:
@media (min-width: 700px), handheld and (orientation: landscape) { ... }
Above, if I were on a screen
device with a viewport width of 800px, the media statement would return true because the first part, interpreted as @media all and (min-width: 700px)
would apply to my device and therefore return true, despite the fact that my screen
device would fail the handheld
media type check in the second media query. Likewise, if I were on a handheld
device held in landscape with a viewport width of 500px, while the first media query would fail due to the viewport width, the second media query would succeed and thus the media statement would return true.
not
The not
keyword applies to the whole media query and returns true if the media query would otherwise return false (such as monochrome
on a color display or a screen width of 600px with a min-width: 700px
feature query). A not
will only negate the media query it is applied to and not to every media query if present in a comma-separated list of media queries. The not
keyword cannot be used to negate an individual feature query, only an entire media query. For example, the not
is evaluated last in the following query:
@media not all and (monochrome) { ... }
This means that the query is evaluated like this:
@media not (all and (monochrome)) { ... }
... rather than like this:
@media (not all) and (monochrome) { ... }
As another example, look at the following media query:
@media not screen and (color), print and (color) { ... }
It is evaluated like this:
@media (not (screen and (color))), print and (color) { ... }
only
The only
keyword prevents older browsers that do not support media queries with media features from applying the given styles:
<link rel="stylesheet" media="only screen and (color)" href="example.css" />
Pseudo-BNF
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 | aspect-ratio | min-aspect-ratio | max-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 queries are case insensitive. Media queries involving unknown media types are always false.
Media features
Most media features can be prefixed with "min-" or "max-" to express "greater or equal to" or "less than or equal to" constraints. This avoids using the "<" and ">" symbols, which would conflict with HTML and XML. If you use a media feature without specifying a value, the expression resolves to true if the feature's value is non-zero.
color
Value: <color>
Media: visual
Accepts min/max prefixes: yes
Indicates the number of bits per color component of the output device. If the device is not a color device, this value is zero.
Examples
To apply a style sheet to all color devices:
@media all and (color) { ... }
To apply a style sheet to devices with at least 4 bits per color component:
@media all and (min-color: 4) { ... }
color-index
Value: <integer>
Media: visual
Accepts min/max prefixes: yes
Indicates the number of entries in the color look-up table for the output device.
Examples
To indicate that a style sheet should apply to all devices using indexed color, you can do:
@media all and (color-index) { ... }
To apply a style sheet to indexed color devices with at least 256 colors:
<link rel="stylesheet" media="all and (min-color-index: 256)" href="http://foo.bar.com/stylesheet.css" />
aspect-ratio
Value: <ratio>
Media: visual
, tactile
Accepts min/max prefixes: yes
Describes the aspect ratio of the targeted display area of the output device. This value consists of two positive integers separated by a slash ("/") character. This represents the ratio of horizontal pixels (first term) to vertical pixels (second term).
Example
The following selects a special style sheet to use for when the display area is at least as wide as it is high.
@media screen and (min-aspect-ratio: 1/1) { ... }
This selects the style when the aspect ratio is either 1:1 or greater. In other words, these styles will only be applied when the viewing area is square or landscape.
device-aspect-ratio
Deprecated
This feature has been removed from the Web standards. Though some browsers may still support it, it is in the process of being dropped. Do not use it in old or new projects. Pages or Web apps using it may break at any time.
Value: <ratio>
Media: visual
, tactile
Accepts min/max prefixes: yes
Describes the aspect ratio of the output device. This value consists of two positive integers separated by a slash ("/") character. This represents the ratio of horizontal pixels (first term) to vertical pixels (second term).
Example
The following selects a special style sheet to use for widescreen displays.
@media screen and (device-aspect-ratio: 16/9), screen and (device-aspect-ratio: 16/10) { ... }
This selects the style when the aspect ratio is either 16:9 or 16:10.
device-height
Deprecated
This feature has been removed from the Web standards. Though some browsers may still support it, it is in the process of being dropped. Do not use it in old or new projects. Pages or Web apps using it may break at any time.
Value: <length>
Media: visual
, tactile
Accepts min/max prefixes: yes
Describes the height of the output device (meaning the entire screen or page, rather than just the rendering area, such as the document window).
Example
To apply a style sheet to a document when displayed on a screen that is less than 800 pixels long, you can use this:
<link rel="stylesheet" media="screen and (max-device-height: 799px)" />
device-width
Deprecated
This feature has been removed from the Web standards. Though some browsers may still support it, it is in the process of being dropped. Do not use it in old or new projects. Pages or Web apps using it may break at any time.
Value: <length>
Media: visual
, tactile
Accepts min/max prefixes: yes
Describes the width of the output device (meaning the entire screen or page, rather than just the rendering area, such as the document window).
Example
To apply a style sheet to a document when displayed on a screen that is less than 800 pixels wide, you can use this:
Media:> <link rel="stylesheet" media="screen and (max-device-width: 799px)" />
grid
Value: <mq-boolean>
which is an <integer>
that can only have the 0
and 1
value.
Media: all
Accepts min/max prefixes: no
Determines whether the output device is a grid device or a bitmap device. If the device is grid-based (such as a TTY terminal or a phone display with only one font), the value is 1. Otherwise it is zero.
Example
To apply a style to handheld devices with a 15-character or narrower display:
@media handheld and (grid) and (max-width: 15em) { ... }
height
Value: <length>
Media: visual
, tactile
Accepts min/max prefixes: yes
The height
media feature describes the height of the output device's rendering surface (such as the height of the viewport or of the page box on a printer).
width
and height
media features.monochrome
Value: <integer>
Media: visual
Accepts min/max prefixes: yes
Indicates the number of bits per pixel on a monochrome (greyscale) device. If the device isn't monochrome, the device's value is 0.
Examples
To apply a style sheet to all monochrome devices:
@media all and (monochrome) { ... }
To apply a style sheet to monochrome devices with at least 8 bits per pixel:
@media all and (min-monochrome: 8) { ... }
orientation
Value: landscape
| portrait
Media: visual
Accepts min/max prefixes: no
Indicates whether the viewport is in landscape (the display is wider than it is tall) or portrait (the display is taller than it is wide) mode.
Example
To apply a style sheet only in portrait orientation:
@media all and (orientation: portrait) { ... }
resolution
Value: <resolution>
Media: bitmap
Accepts min/max prefixes: yes
Indicates the resolution (pixel density) of the output device. The resolution may be specified in either dots per inch (dpi) or dots per centimeter (dpcm).
Example
To apply a style sheet to devices with at least 300 dots per inch of resolution:
@media print and (min-resolution: 300dpi) { ... }
To replace the old (min-device-pixel-ratio: 2)
syntax:
@media screen and (min-resolution: 2dppx) { ... }
scan
Value: progressive
| interlace
Media: tv
Accepts min/max prefixes: no
Describes the scanning process of television output devices.
Example
To apply a style sheet only to progressive scanning televisions:
@media tv and (scan: progressive) { ... }
width
Value: <length>
Media: visual
, tactile
Accepts min/max prefixes: yes
The width
media feature describes the width of the rendering surface of the output device (such as the width of the document window, or the width of the page box on a printer).
width
and height
media features.Examples
If you want to specify a style sheet for handheld devices, or screen devices with a width greater than 20em, you can use this query:
@media handheld and (min-width: 20em), screen and (min-width: 20em) { ... }
This media query specifies a style sheet that applies to printed media wider than 8.5 inches:
<link rel="stylesheet" media="print and (min-width: 8.5in)" href="http://foo.com/mystyle.css" />
This query specifies a style sheet that is usable when the viewport is between 500 and 800 pixels wide:
@media screen and (min-width: 500px) and (max-width: 800px) { ... }
Mozilla-specific media features
Mozilla offers several Gecko-specific media features. Some of these may be proposed as official media features.
-moz-images-in-menus
Requires Gecko 1.9.2(Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Value: <integer>
Media: visual
Accepts min/max prefixes: no
If the device allows images to appear in menus, this is 1; otherwise, the value is 0. This corresponds to the :-moz-system-metric(images-in-menus)
CSS pseudo-class.
-moz-mac-graphite-theme
Requires Gecko 1.9.2(Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Value: <integer>
Media: visual
Accepts min/max prefixes: no
If the user has configured their device to use the "Graphite" appearance on Mac OS X, this is 1. If the user is using the standard blue appearance, or is not on Mac OS X, this is 0.
This corresponds to the :-moz-system-metric(mac-graphite-theme)
CSS pseudo-class.
-moz-maemo-classic
Requires Gecko 1.9.2(Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Value: <integer>
Media: visual
Accepts min/max prefixes: no
If the user is using Maemo with the original theme, this is 1; if it's using the newer Fremantle theme, this is 0.
This corresponds to the :-moz-system-metric(maemo-classic)
CSS pseudo-class.
-moz-device-pixel-ratio
Requires Gecko 2.0(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)Value: <number>
Media: visual
Accepts min/max prefixes: yes
Gives the number of device pixels per CSS pixel.
Do not use this feature.
Use the resolution
feature with the dppx
unit instead.
-moz-device-pixel-ratio
may be used for compatibility with Firefox older than 16 and -webkit-device-pixel-ratio
with WebKit-based browsers that do not support dppx
.
Example:
@media (-webkit-min-device-pixel-ratio: 2), /* Webkit-based browsers */ (min--moz-device-pixel-ratio: 2), /* Older Firefox browsers (prior to Firefox 16) */ (min-resolution: 2dppx), /* The standard way */ (min-resolution: 192dpi) /* dppx fallback */
See this CSSWG article for compatibility good practices regarding resolution
and dppx
.
-webkit-device-pixel-ratio
. The min and max prefixes as implemented by Gecko are named min--moz-device-pixel-ratio
and max--moz-device-pixel-ratio
; but the same prefixes as implemented by Webkit are named -webkit-min-device-pixel-ratio
and -webkit-max-device-pixel-ratio
.-moz-os-version
Requires Gecko 25.0(Firefox 25.0 / Thunderbird 25.0 / SeaMonkey 2.22)Value: windows-xp
| windows-vista
| windows-win7
| windows-win8 | windows-win10
Media: visual
Accepts min/max prefixes: no
Indicates which operating system version is currently being used. Currently only implemented on Windows. Possible values are:
windows-xp
windows-vista
windows-win7
windows-win8
windows-win10
This is provided for application skins and other chrome code to be able to adapt to work well with the current operating system version.
-moz-scrollbar-end-backward
Requires Gecko 1.9.2(Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Value: <integer>
Media: visual
Accepts min/max prefixes: no
If the device's user interface displays a backward arrow button at the end of scrollbars, this is 1. Otherwise it's 0.
This corresponds to the :-moz-system-metric(scrollbar-end-backward)
CSS pseudo-class.
-moz-scrollbar-end-forward
Requires Gecko 1.9.2(Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Value: <integer>
Media: visual
Accepts min/max prefixes: no
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.
-moz-scrollbar-start-backward
Requires Gecko 1.9.2(Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Value: <integer>
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.
-moz-scrollbar-start-forward
Requires Gecko 1.9.2(Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Value: <integer>
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.
-moz-scrollbar-thumb-proportional
Requires Gecko 1.9.2(Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Value: <integer>
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.
-moz-touch-enabled
Requires Gecko 1.9.2(Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Value: <integer>
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.
-moz-windows-classic
Requires Gecko 1.9.2(Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Value: <integer>
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.
-moz-windows-compositor
Requires Gecko 1.9.2(Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Value: <integer>
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.
-moz-windows-default-theme
Requires Gecko 1.9.2(Firefox 3.6 / Thunderbird 3.1 / Fennec 1.0)Value: <integer>
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.
-moz-windows-glass
Requires Gecko 21.0(Firefox 21.0 / Thunderbird 21.0 / SeaMonkey 2.18)Value: <integer>
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.
-moz-windows-theme
Requires Gecko 2.0(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)Value: aero
| luna-blue
| luna-olive
| luna-silver
| royale
| generic
| zune
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.
WebKit media features
-webkit-transform-3d
Value: <integer>
Media: visual
Accepts min/max prefixes: no
Spec
Docs
If supported, the value is 1
, otherwise, the value is 0.
Example
@media (-webkit-transform-3d) { .foo { transform-style: preserve-3d; } } @media (-webkit-transform-3d: 1) { .foo { transform-style: preserve-3d; } }
-webkit-transform-2d
Value: <integer>
Media: visual
Accepts min/max prefixes: no
Docs
If supported, the value is 1
, otherwise, the value is 0.
-webkit-transition
Value: <integer>
Media: visual
Accepts min/max prefixes: no
Docs
If supported, the value is 1
, otherwise, the value is 0.
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 21 | 3.5 (1.9.1) | 9.0 | 9 | 4 |
grid |
? | No support [1] | ? | ? | ? |
resolution |
29 | 3.5 (1.9.1) [2] 8.0 (8.0) [3] |
? | ? | ? |
scan |
? | No support[4] | ? | ? | ? |
-webkit-min-device-pixel-ratio , -webkit-max-device-pixel-ratio |
(Yes) | No support[7] | No support | (Yes) | ? |
-webkit-transform-3d |
(Yes)[5] | 49 (49)[6] | ? | (Yes)[5] | 1.0[5] |
-webkit-transform-2d |
No support | No support | ? | (Yes)[5] | 1.0[5] |
-webkit-transition |
No support | No support | ? | (Yes)[5] | 1.0[5] |
display-mode |
? | 47 (47) | ? | ? | ? |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|
Basic support | (Yes) | (Yes) | ? | (Yes) | (Yes) |
grid |
? | ? | ? | ? | ? |
resolution |
? | ? | ? | ? | ? |
scan |
? | ? | ? | ? | ? |
-webkit-min-device-pixel-ratio , -webkit-max-device-pixel-ratio |
? | ? | ? | ? | ? |
-webkit-transform-3d |
? | ? | ? | ? | ? |
-webkit-transform-2d |
? | ? | ? | ? | ? |
-webkit-transition |
? | ? | ? | ? | ? |
display-mode |
? | ? | ? | ? | ? |
[1] grid
media type is not supported.
[2] Supports <integer>
values.
[3] Supports <number>
values, as per the spec.
[4] tv
media type is not supported.
[5] See WebKit bug 22494.
[6] Implemented for Web compatibility reasons in Gecko 46.0 (Firefox 46.0 / Thunderbird 46.0 / SeaMonkey 2.43) behind the preference layout.css.prefixes.webkit
defaulting to false
. See bug 1239799. Since Gecko 49.0 (Firefox 49 / Thunderbird 49 / SeaMonkey 2.46) layout.css.prefixes.webkit
defaults to true
.
[7] Implemented as aliases for min--moz-device-pixel-ratio
and max--moz-device-pixel-ratio
for Web compatibility reasons in Gecko 45.0 (Firefox 45.0 / Thunderbird 45.0 / SeaMonkey 2.42) (see bug 1176968) behind the preferences layout.css.prefixes.webkit
and layout.css.prefixes.device-pixel-ratio-webkit
, defaulting to false
. Since Gecko 49.0 (Firefox 49 / Thunderbird 49 / SeaMonkey 2.46) layout.css.prefixes.webkit
defaults to true
.
See also
- CSS 3 media query specification
- Media types
- Using media queries from code
- List of mobile and tablet viewport sizes with pixel ratios
- CSS Animations Between Media Queries by David Walsh
- @media (-webkit-transform-3d)
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/css/media_queries/using_media_queries