Skip to content

A PostCSS plugin to inline or nest media queries within CSS rules & properties.

License

Notifications You must be signed in to change notification settings

arccoza/postcss-if-media

Repository files navigation

PostCSS ?If Media Travis Build Status

A PostCSS plugin for adding ?if media queries inside rules and inline with property values. A great way to keep style values for different media queries neatly organized and grouped together under their natural rules. Use with PostCSS Media Minmax and PostCSS Custom Media for best effect (be sure to place postcss-if-media before postcss-media-minmax, and postcss-custom-media, or any other media query plugins).

Explanation

The plugin provides ?if media QUERY as an inline declaration and a nested block, where QUERY is any valid media query.

Any properties with the ?if media QUERY declaration following their value, or any properties inside an ?if media QUERY { } block will be extracted from their rule and placed in their own rule under an @media QUERY query.

The generated @media queries are placed directly after the original rule to maintain specificity.

Install

npm install postcss-if-media --save

Example 1

An inline declaration example.

/* Input. */
.test {
  position: relative;
  margin: 0 1em ?if media (min-width: 1025px);
  margin: 0 0.5em ?if media (min-width: 641px) and (max-width: 1024px);
  margin: 0 0.3em ?if media (max-width: 640px);
}

/* Output. */
.test {
  position: relative;
}

@media (min-width: 1025px) {
  .test {
     margin: 0 1em;
  }
}
@media (min-width: 641px) and (max-width: 1024px) {
  .test {
     margin: 0 0.5em;
  }
}
@media (max-width: 640px) {
  .test {
     margin: 0 0.3em;
  }
}

Example 2

A nested block example.

/* Input. */
.test {
  position: relative;
  ?if media (min-width: 1025px) {
    color: red;
    margin: 0 1em;
  }
  ?if media (min-width: 641px) and (max-width: 1024px) {
    color: green;
    margin: 0 0.5em;
  }
  ?if media (max-width: 640px) {
    color: blue;
    margin: 0 0.3em;
  }
}

/* Output. */
.test {
  position: relative;
}

@media (min-width: 1025px) {
  .test {
    color: red;
    margin: 0 1em;
  }
}
@media (min-width: 641px) and (max-width: 1024px) {
  .test {
    color: green;
    margin: 0 0.5em;
  }
}
@media (max-width: 640px) {
  .test {
    color: blue;
    margin: 0 0.3em;
  }
}

About

A PostCSS plugin to inline or nest media queries within CSS rules & properties.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published