Skip to content

CSS @media Rule

The @media at-rule specifies a set of styles that are applied only to certain media types.

Media queries are a popular technique for delivering a responsive web design to desktops, laptops, tablets, and mobile phones.

Besides media types, there are media features which have names and accept certain values like properties. However, they are used to test conditions within media queries rather than directly styling elements.

Media queries are used to check the following:

  • width and height of the viewport
  • orientation
  • resolution

In JavaScript, the CSSMediaRule interface represents a single @media rule and can be used to access rules created with @media.

Syntax

CSS @media

css
@media <media-query> {
  /* styles */
}

Media queries can combine multiple conditions using logical operators: and, not, only, and a comma (,).

Example of the @media rule:

CSS @media code example

html
<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      body {
        background-color: #1c87c9;
      }
      @media screen and (max-width: 411px) {
        body {
          background-color: #cce5ff;
        }
      }
      @media screen and (min-width: 768px) {
        body {
          background-color: #eee;
        }
      }
      @media screen and (max-width: 962px) and (min-width: 450px),
      (min-width: 1366px) {
        body {
          background-color: #333;
        }
      }
    </style>
  </head>
  <body>
    <h2>@media rule example</h2>
    <p>Resize the browser to see the effect.</p>
    <p>The background color changes based on the viewport width: light blue for screens up to 411px, light gray for 768px and wider, and dark gray for screens between 450px and 962px, or 1366px and wider.</p>
  </body>
</html>

Result

CSS @media multiple queries

In the following example, when the browser's width is between 500 and 800px or above 1000px, the appearance of <div> changes. Resize the browser window to see the effect.

Example of the @media rule with a changed appearance of <div>:

CSS @media multiple queries example

html
<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      body {
        background-color: #1c87c9;
      }
      @media screen and (min-width: 200px) {
        body {
          background-color: #8ebf42;
        }
      }
      @media screen and (min-width: 600px) {
        body {
          background-color: #ccc;
        }
      }
      @media screen and (max-width: 800px) and (min-width: 500px),
      (min-width: 1000px) {
        div.box {
          font-size: 50px;
          padding: 50px;
          border: 8px solid #000;
          background: #eee;
        }
      }
    </style>
  </head>
  <body>
    <h2>@media rule example</h2>
    <p>Media queries set the background-color to grey if the viewport is 600 pixels wide or wider, to green if the viewport is between 200 and 599 pixels wide. If the viewport is smaller than 200 pixels, the background-color is blue.</p>
    <h3>Change the appearance of DIV on different screen sizes</h3>
    <div class="box">DIV</div>
  </body>
</html>

Media Types

ValueDescription
allThis value is used for all devices. This is the default value of this property.
printIs used for printers.
screenIs used for color computer screens.
speechIs used for speakers.

Example of using media for hiding an element on extra small devices:

CSS @media Rule

html
<!DOCTYPE html>
<html>
  <head>
    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no" />
    <style>
      @media (max-width: 767px) {
        .hide-mobile {
          display: none;
        }
      }
    </style>
  </head>
  <body>
    <h1>Hi</h1>
    <p>There is some text for example.</p>
    <p class="hide-mobile">This text will be hidden on large devices.</p>
    <p>There is some text for example.</p>
  </body>
</html>

Example of using media for changing the content background color on different devices.

CSS @media Rule

html
<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      @media screen and (max-width: 767px) {
        .content {
          background-color: lightblue;
          padding: 30px;
        }
      }
      @media screen and (min-width: 768px) {
        .content {
          background-color: pink;
          padding: 10px;
        }
      }
      @media screen and (min-width: 800px) {
        .content {
          background-color: lightgreen;
          color: white;
          padding: 50px;
        }
      }
    </style>
  </head>
  <body>
    <div class="content">
      <h2>Resize the browser to see the effect.</h2>
      <p>
        CSS is a rule-based language, which means that you define
        rules specifying groups of styles applying to particular
        elements or groups of elements on the web page.
      </p>
    </div>
  </body>
</html>

Media Features

ValueDescription
widthThe width of the viewport.
heightThe height of the viewport.
orientationThe orientation of the viewport.
aspect-ratioThe ratio of the value of the "width" media feature to the value of the "height" media feature.
gridQueries whether the output device is grid or bitmap.
colorThe number of bits per color component of the output device. If device is not a color one, the value is 0.
color-gamutThe approximate range of colors that are supported by the user agent and output device.
inverted-colorsQueries whether the browser or underlying OS invert colors or not.
hoverQueries whether the primary input mechanism allows the user to hover over elements or not.
any-hoverQueries whether the available input mechanism allows the user to hover over elements or not.
any-pointerQueries whether the available input mechanism is a pointing device or not.
light-levelThe light level of surroundings.
max-aspect-ratioThe maximum ratio between the width and the height of the display area.
max-colorThe maximum number of bits per color component for the output device.
max-heightThe maximum height of the display area.
max-monochromeThe maximum number of bits per color on a monochrome device.
max-resolutionThe maximum resolution of the device.
max-widthThe maximum width of the display area.
min-aspect-ratioThe minimum ratio between the width and the height of the display area.
min-colorThe minimum number of bits per color component for the output device.
min-heightThe minimum height of the display area.
min-monochromeThe minimum number of bits per color on a monochrome device.
min-resolutionThe minimum resolution of the device.
min-widthThe minimum width of the display area.
overflow-blockQueries how the output device handles content that overflows the viewport along the block axis.
overflow-inlineQueries whether the content that overflows the viewport along the inline axis can be scrolled or not.
pointerQueries whether the primary input mechanism is a pointing device or not.
resolutionDescribes the resolution of the output device.
scriptingQueries whether scripting is available or not.
updateQueries how quickly the output device can modify the appearance of the content.

Practice

What are the functions of media queries in CSS?

Dual-run preview — compare with live Symfony routes.