177 lines
4.1 KiB
Markdown
177 lines
4.1 KiB
Markdown
|
# PostCSS Initial
|
|||
|
[![CSS Standard Status][css-img]][css] [![Build Status][ci-img]][ci] [![NPM Module][npm-img]][npm] [![David DM][david-img]][david]
|
|||
|
|
|||
|
<img align="right" width="135" height="95"
|
|||
|
title="Philosopher’s stone, logo of PostCSS"
|
|||
|
src="http://postcss.github.io/postcss/logo-leftp.png">
|
|||
|
|
|||
|
[PostCSS] plugin to fallback `initial` keyword. Very useful in combination with
|
|||
|
[postcss-autoreset][reset].
|
|||
|
|
|||
|
[PostCSS]: https://github.com/postcss/postcss
|
|||
|
[css-img]: https://jonathantneal.github.io/css-db/badge/css-cascade-all-shorthand.svg
|
|||
|
[css]: https://jonathantneal.github.io/css-db/#css-cascade-all-shorthand
|
|||
|
[ci-img]: https://travis-ci.org/maximkoretskiy/postcss-initial.svg
|
|||
|
[ci]: https://travis-ci.org/maximkoretskiy/postcss-initial
|
|||
|
[npm-img]: https://badge.fury.io/js/postcss-initial.svg
|
|||
|
[npm]: https://www.npmjs.com/package/postcss-initial
|
|||
|
[david-img]: https://david-dm.org/maximkoretskiy/postcss-initial.svg
|
|||
|
[david]: https://david-dm.org/maximkoretskiy/postcss-initial
|
|||
|
[reset]: https://github.com/maximkoretskiy/postcss-autoreset
|
|||
|
|
|||
|
|
|||
|
```css
|
|||
|
a {
|
|||
|
animation: initial;
|
|||
|
background: initial;
|
|||
|
white-space: initial;
|
|||
|
}
|
|||
|
p {
|
|||
|
background: url(/img1.png),
|
|||
|
url(/img2.png);
|
|||
|
background-repeat: initial no-repeat
|
|||
|
}
|
|||
|
```
|
|||
|
|
|||
|
```css
|
|||
|
a {
|
|||
|
animation: none 0s ease 0s 1 normal none running;
|
|||
|
animation: initial;
|
|||
|
background: transparent none repeat 0 0 / auto auto padding-box border-box scroll;
|
|||
|
background: initial;
|
|||
|
white-space: normal;
|
|||
|
white-space: initial;
|
|||
|
}
|
|||
|
p {
|
|||
|
background: url(/img1.png),
|
|||
|
url(/img2.png);
|
|||
|
background-repeat: repeat no-repeat
|
|||
|
}
|
|||
|
```
|
|||
|
|
|||
|
[!['Can I use' table](https://caniuse.bitsofco.de/image/css-initial-value.png)](https://caniuse.com/#feat=css-initial-value)
|
|||
|
|
|||
|
**Killer feature!**
|
|||
|
|
|||
|
Universal reset from future css!
|
|||
|
```css
|
|||
|
a {
|
|||
|
all: initial;
|
|||
|
}
|
|||
|
```
|
|||
|
|
|||
|
```css
|
|||
|
a {
|
|||
|
animation: none 0s ease 0s 1 normal none running;
|
|||
|
backface-visibility: visible;
|
|||
|
background: transparent none repeat 0 0 / auto auto padding-box border-box scroll;
|
|||
|
border: medium none currentColor;
|
|||
|
border-collapse: separate;
|
|||
|
border-image: none;
|
|||
|
border-radius: 0;
|
|||
|
border-spacing: 0;
|
|||
|
bottom: auto;
|
|||
|
box-shadow: none;
|
|||
|
box-sizing: content-box;
|
|||
|
caption-side: top;
|
|||
|
clear: none;
|
|||
|
clip: auto;
|
|||
|
color: #000;
|
|||
|
columns: auto;
|
|||
|
column-count: auto;
|
|||
|
column-fill: balance;
|
|||
|
column-gap: normal;
|
|||
|
column-rule: medium none currentColor;
|
|||
|
column-span: 1;
|
|||
|
column-width: auto;
|
|||
|
content: normal;
|
|||
|
counter-increment: none;
|
|||
|
counter-reset: none;
|
|||
|
cursor: auto;
|
|||
|
direction: ltr;
|
|||
|
display: inline;
|
|||
|
empty-cells: show;
|
|||
|
float: none;
|
|||
|
font-family: serif;
|
|||
|
font-size: medium;
|
|||
|
font-style: normal;
|
|||
|
font-variant: normal;
|
|||
|
font-weight: normal;
|
|||
|
font-stretch: normal;
|
|||
|
line-height: normal;
|
|||
|
height: auto;
|
|||
|
hyphens: none;
|
|||
|
left: auto;
|
|||
|
letter-spacing: normal;
|
|||
|
list-style: disc outside none;
|
|||
|
margin: 0;
|
|||
|
max-height: none;
|
|||
|
max-width: none;
|
|||
|
min-height: 0;
|
|||
|
min-width: 0;
|
|||
|
opacity: 1;
|
|||
|
orphans: 2;
|
|||
|
outline: medium none invert;
|
|||
|
overflow: visible;
|
|||
|
overflow-x: visible;
|
|||
|
overflow-y: visible;
|
|||
|
padding: 0;
|
|||
|
page-break-after: auto;
|
|||
|
page-break-before: auto;
|
|||
|
page-break-inside: auto;
|
|||
|
perspective: none;
|
|||
|
perspective-origin: 50% 50%;
|
|||
|
position: static;
|
|||
|
right: auto;
|
|||
|
tab-size: 8;
|
|||
|
table-layout: auto;
|
|||
|
text-align: left;
|
|||
|
text-align-last: auto;
|
|||
|
text-decoration: none;
|
|||
|
text-indent: 0;
|
|||
|
text-shadow: none;
|
|||
|
text-transform: none;
|
|||
|
top: auto;
|
|||
|
transform: none;
|
|||
|
transform-origin: 50% 50% 0;
|
|||
|
transform-style: flat;
|
|||
|
transition: none 0s ease 0s;
|
|||
|
unicode-bidi: normal;
|
|||
|
vertical-align: baseline;
|
|||
|
visibility: visible;
|
|||
|
white-space: normal;
|
|||
|
widows: 2;
|
|||
|
width: auto;
|
|||
|
word-spacing: normal;
|
|||
|
z-index: auto;
|
|||
|
all: initial;
|
|||
|
}
|
|||
|
```
|
|||
|
|
|||
|
## Options
|
|||
|
|
|||
|
### reset
|
|||
|
|
|||
|
Takes `string`.
|
|||
|
Describes what subset of rules should be unsetted with `all` property (to reduce code weight).
|
|||
|
Possible subsets: `all`, `inherited`.
|
|||
|
Default value: `'all'`.
|
|||
|
|
|||
|
### replace
|
|||
|
|
|||
|
Takes `boolean`.
|
|||
|
Replace the `initial` with the fallback instead of adding it.
|
|||
|
Default value: `false`.
|
|||
|
|
|||
|
## Usage
|
|||
|
|
|||
|
```js
|
|||
|
postcss([ require('postcss-initial')({
|
|||
|
reset: 'inherited' // reset only inherited rules
|
|||
|
}) ])
|
|||
|
```
|
|||
|
|
|||
|
See [PostCSS] docs for examples for your environment.
|
|||
|
|
|||
|
## [Changelog](./CHANGELOG.md)
|