postcss-if-media

PostCSS ?If Media

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;
  }
}

Changelog

[1.0.3] - 2017-06-09

Fixed

• Issue #5, empty rules in webpack under PostCSS 6.

Changed

• Replaced PostCSS 6 deprecated methods for v5 & v6 compatible alternatives.
• Switched to Yarn from NPM.
• Updated PostCSS dependency to include wide range of supported versions.