postcss-convert-unit
Convert values and units in css through custom conversion rules. A new selector can be generated for the converted property.
Install
npm install postcss-convert-unit --save-dev
Usage
simple
postcss config:
// postcss.config.jsmoduleexports = plugins: "postcss-convert-units": convertConfig: declMatcher: sourceUnit: 'px' targetUnit: 'rem' declConvertRules: value ;
input:
output:
px2rem
postcss config:
// postcss.config.jsmoduleexports = plugins: "postcss-convert-units": convertConfig: declMatcher: sourceUnit: 'px' targetUnit: 'rem' declConvertRules: value / 75 declMatcher: sourceUnit: 'px' targetUnit: 'px' afterDeclComment: 'px' removeMatchDecl: true declConvertRules: `[data-dpr="1"] ` value / 2 `[data-dpr="2"] ` value `[data-dpr="3"] ` value / 2 * 3 ;
input:
output:
[[[
Options
// example convertConfig: declMatcher: sourceUnit: 'px' targetUnit: 'rem' afterDeclComment: 'rem' precision: 5 removeMatchDecl: false declConvertRules: value selector
Attribute | Description | Type | Default | Required |
---|---|---|---|---|
convertConfig | convert config list | convertItem[] | [] | yes |
- convertItem
Attribute | Description | Type | Default | Required |
---|---|---|---|---|
declMatcher | match declaration | string | - | yes |
declConvertRules | declaration convert rules | convertRule[] | - | yes |
precision | value precision | number | 5 | no |
- declMatcher
Attribute | Description | Type | Default | Required |
---|---|---|---|---|
sourceUnit | source unit | string | - | yes |
targetUnit | target unit | string | - | yes |
afterDeclComment | comment after declaration | string | - | no |
- convertRule
notice: If set withNewSelector
, a new selector will be generated for the converted declaration; if not set withNewSelector
, values and units will converted in origin declaration. for @keyframes, it will converted in origin declaration. If multiple convertRules
are configured, the last configuration will take effect, because the post configuration will override the first configuration.
Attribute | Description | Type | Default | Required |
---|---|---|---|---|
value | value convert rule | function(value),value is matched value,you need implement convert rule,and return converted value |
- | yes |
withNewSelector | new selector generated rule | function(selector), selector is matched selector,you need implement convert rule,and return new selector |
- | no |