You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
176 lines
4.1 KiB
176 lines
4.1 KiB
# 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)
|
|
|