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.
92 lines
1.7 KiB
92 lines
1.7 KiB
# [postcss][postcss]-reduce-initial |
|
|
|
> Reduce `initial` definitions to the _actual_ initial value, where possible. |
|
|
|
## Install |
|
|
|
With [npm](https://npmjs.org/package/postcss-reduce-initial) do: |
|
|
|
``` |
|
npm install postcss-reduce-initial --save |
|
``` |
|
|
|
## Examples |
|
|
|
See the [data](data) for more conversions. This data is courtesy |
|
of Mozilla. |
|
|
|
### Convert `initial` values |
|
|
|
When the `initial` keyword is longer than the property value, it will |
|
be converted: |
|
|
|
#### Input |
|
|
|
```css |
|
h1 { |
|
min-width: initial; |
|
} |
|
``` |
|
|
|
#### Output |
|
|
|
```css |
|
h1 { |
|
min-width: 0; |
|
} |
|
``` |
|
|
|
### Convert values back to `initial` |
|
|
|
When the `initial` value is smaller than the property value, it will |
|
be converted: |
|
|
|
#### Input |
|
|
|
```css |
|
h1 { |
|
transform-box: border-box; |
|
} |
|
``` |
|
|
|
#### Output |
|
|
|
```css |
|
h1 { |
|
transform-box: initial; |
|
} |
|
``` |
|
|
|
This conversion is only applied when you supply a browsers list that all support |
|
the `initial` keyword; it's worth noting that Internet Explorer has no support. |
|
|
|
## API |
|
|
|
### reduceInitial([options]) |
|
|
|
#### options |
|
|
|
##### ignore |
|
|
|
Type: `Array<String>` |
|
Default: `undefined` |
|
|
|
It contains the Array of properties that will be ignored while reducing its value to initial. |
|
Example : `{ ignore : ["min-height"] }` |
|
|
|
## Usage |
|
|
|
See the [PostCSS documentation](https://github.com/postcss/postcss#usage) for |
|
examples for your environment. |
|
|
|
## Contributors |
|
|
|
See [CONTRIBUTORS.md](https://github.com/cssnano/cssnano/blob/master/CONTRIBUTORS.md). |
|
|
|
## License |
|
|
|
This program uses a list of CSS properties derived from data maintained my the MDN team at Mozilla and licensed under the [CC0 1.0 Universal Public Domain Dedication](https://creativecommons.org/publicdomain/zero/1.0/). |
|
|
|
MIT © [Ben Briggs](http://beneb.info) |
|
|
|
[postcss]: https://github.com/postcss/postcss
|
|
|