Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/csstools/postcss-normalize

Use the parts of normalize.css (or sanitize.css) you need from your browserslist
https://github.com/csstools/postcss-normalize

Last synced: 3 months ago
JSON representation

Use the parts of normalize.css (or sanitize.css) you need from your browserslist

Lists

README 

        
# PostCSS Normalize [PostCSS][postcss]



[npm version][npm-url]

[build status][cli-url]

[support chat][git-url]



[PostCSS Normalize] lets you use the parts of [normalize.css] or [sanitize.css]

that you need from your [browserslist].



```css

@import "normalize.css";

```



```css

@import "sanitize.css";

```



**PostCSS Normalize** uses a non-opinionated version of [normalize.css], but

an opinionated version may also be used.



```css

@import "normalize.css/opinionated.css";

```



### Examples



Here is a sample of what **normalize.css** looks like when the **browserslist**

is `ie >= 9`:



```css

/**

 * Add the correct display in IE 9-.

 */



audio,

video {

  display: inline-block;

}



/**

 * Remove the border on images inside links in IE 10-.

 */



img {

  border-style: none;

}

```



And here is the same sample when the **browserslist** is `ie >= 10`:



```css

/**

 * Remove the border on images inside links in IE 10-.

 */



img {

  border-style: none;

}

```



## Usage



Add [PostCSS Normalize] to your project:



```bash

npm install postcss-normalize --save-dev

```



Add a [browserslist] entry in `package.json`:



```json

{

  "browserslist": "last 2 versions"

}

```



Use **PostCSS Normalize** to process your CSS:



```js

const postcssNormalize = require('postcss-normalize')



postcssNormalize.process(YOUR_CSS /*, processOptions, pluginOptions */)

```



Or use it as a [PostCSS] plugin:



```js

const postcss = require('postcss')

const postcssNormalize = require('postcss-normalize')



postcss([

  postcssNormalize(/* pluginOptions */)

]).process(YOUR_CSS /*, processOptions */)

```



**PostCSS Normalize** runs in all Node environments, with special instructions

for:



| [Node](INSTALL.md#node) | [PostCSS CLI](INSTALL.md#postcss-cli) | [Webpack](INSTALL.md#webpack) | [Create React App](INSTALL.md#create-react-app) | [Gulp](INSTALL.md#gulp) | [Grunt](INSTALL.md#grunt) |

| --- | --- | --- | --- | --- | --- |



## PostCSS Import Usage



**PostCSS Normalize** includes a `postcssImport` function to configure

[PostCSS Import] and allow you to continue using the `@import` syntax.



```js

const postcss = require('postcss')

const postcssImport = require('postcss-import')

const postcssNormalize = require('postcss-normalize')



postcss([

  postcssImport(

    postcssNormalize(

      /* pluginOptions (for PostCSS Normalize) */

    ).postcssImport(

      /* pluginOptions (for PostCSS Import) */

    )

  )

]) // now you can use @import "normalize.css", etc. again

```



Alternatively, use `@import-normalize` or `@import-sanitize` to avoid conflicts

with `@import` transforms.



```pcss

@import-normalize;

```



```pcss

@import-normalize "opinionated.css";

```



```pcss

@import-sanitize;

```



## Options



### allowDuplicates



The `allowDuplicates` option determines whether multiple, duplicate insertions

of CSS libraries are allowed. By default, duplicate libraries are omitted.



```js

postcssNormalize({ allowDuplicates: true })

```



### forceImport



The `forceImport` option defines CSS libraries that will be inserted at the

beginning of the CSS file. Unless overriden by `allowDuplicates`, duplicate

CSS libraries would still be omitted.



```js

postcssNormalize({ forceImport: true })

```



Specific CSS libraries may be defined.



```js

postcssNormalize({

  forceImport: 'sanitize.css'

})

```



### browsers



The `browsers` option defines an override of the project’s **browserslist** for

**PostCSS Normalize**. This option should be avoided in leui of a browserslist

file.



```js

postcssNormalize({ browsers: 'last 2 versions' })

```



## CSS Libraries



**PostCSS Normalize** can include [normalize.css] or [sanitize.css] and

configure either with the following combinations:



```css

@import "normalize"; /* also, @import "normalize.css" */

@import "normalize/opinionated"; /* also, @import "normalize.css/opinionated.css", @import "normalize.css/*" */

@import "sanitize"; /* also, @import "sanitize.css" */

@import "sanitize/assets"; /* also, @import "sanitize.css/assets.css" */

@import "sanitize/forms"; /* also, @import "sanitize.css/forms.css" */

@import "sanitize/reduce-motion"; /* also, @import "sanitize.css/reduce-motion.css" */

@import "sanitize/system-ui"; /* also, @import "sanitize.css/system-ui.css" */

@import "sanitize/typography"; /* also, @import "sanitize.css/typography.css" */

@import "sanitize/ui-monospace"; /* also, @import "sanitize.css/ui-monospace.css" */

@import "sanitize/*"; /* also, @import "sanitize.css/*" (sanitize + all additions) */

```



[cli-img]: https://img.shields.io/travis/csstools/postcss-normalize/main.svg

[cli-url]: https://travis-ci.org/csstools/postcss-normalize

[git-img]: https://img.shields.io/badge/support-chat-blue.svg

[git-url]: https://gitter.im/postcss/postcss

[npm-img]: https://img.shields.io/npm/v/postcss-normalize.svg

[npm-url]: https://www.npmjs.com/package/postcss-normalize



[browserslist]: http://browserl.ist/

[CSS Libraries]: #css-libraries

[normalize.css]: https://github.com/csstools/normalize.css

[Options]: #options

[PostCSS]: https://github.com/postcss/postcss

[PostCSS Import]: https://github.com/postcss/postcss-import

[PostCSS Import Usage]: #postcss-import-usage

[PostCSS Normalize]: https://github.com/csstools/postcss-normalize

[sanitize.css]: https://github.com/csstools/sanitize.css