inline-style-prefixer adds required vendor prefixes to your style object. It only adds prefixes if they're actually required by evaluating the browser's userAgent against data from caniuse.com.
Alternatively it ships a static version that adds all available vendor prefixes.
yarn add inline-style-prefixerIf you're still using npm, you may run npm i --save inline-style-prefixer.
We also provide UMD builds for each package in the dist folder. You can easily use them via unpkg.
<!-- Unminified versions -->
<script src="https://unpkg.com/inline-style-prefixer@3.0.1/dist/inline-style-prefixer.js"></script>
<script src="https://unpkg.com/inline-style-prefixer@3.0.1/dist/inline-style-prefix-all.js"></script>
<!-- Minified versions -->
<script src="https://unpkg.com/inline-style-prefixer@3.0.1/dist/inline-style-prefixer.min.js"></script>
<script src="https://unpkg.com/inline-style-prefixer@3.0.1/dist/inline-style-prefix-all.min.js"></script>It supports all major browsers with the following versions. For other, unsupported browses, we automatically use a fallback.
- Chrome: 46+
- Android (Chrome): 46+
- Android (Stock Browser): 4+
- Android (UC): 9+
- Firefox: 40+
- Safari: 8+
- iOS (Safari): 8+
- Opera: 16+
- Opera (Mini): 12+
- IE: 11+
- IE (Mobile): 11+
- Edge: 12+
It will only add prefixes if a property still needs them in one of the above mentioned versions.
Therefore, e.g. border-radius will not be prefixed at all.
Need to support legacy browser versions?
Don't worry - we got you covered. Check this guide.
Before using the prefixer, you have to decide which one you want to use. We ship two different versions - a dynamic and a static version.
The dynamic prefixer evaluates the userAgent to identify the browser environment. Using this technique, we are able to only add the bare minimum of prefixes. Browser detection is quite accurate (~90% correctness), but yet also expensive which is why the package is almost 3 times as big as the static version.
It uses the static prefixer as a fallback.
import Prefixer from 'inline-style-prefixer'
const style = {
transition: '200ms all linear',
userSelect: 'none',
boxSizing: 'border-box',
display: 'flex',
color: 'blue'
}
const prefixer = new Prefixer()
const prefixedStyle = prefixer.prefix(style)
// prefixedStyle === output
const output = {
transition: '200ms all linear',
WebkitUserSelect: 'none',
boxSizing: 'border-box',
display: '-webkit-flex',
color: 'blue'
}The static prefixer, on the other hand, adds all required prefixes according the above mentioned browser versions. Removing the browser detection makes it both smaller and fast, but also drastically increases the output.
import prefixAll from 'inline-style-prefixer/static'
const style = {
transition: '200ms all linear',
boxSizing: 'border-box',
display: 'flex',
color: 'blue'
}
const prefixedStyle = prefixAll(style)
// prefixedStyle === output
const output = {
WebkitTransition: '200ms all linear',
transition: '200ms all linear',
MozBoxSizing: 'border-box',
boxSizing: 'border-box',
display: [ '-webkit-box', '-moz-box', '-ms-flexbox', '-webkit-flex', 'flex' ]
color: 'blue'
}You can use TypeScript definition from DefinitelyTyped using @types/inline-style-prefixer
npm install --save @types/inline-style-prefixerThen import in your code:
import prefixAll = require('inline-style-prefixer/static');
const prefixedStyle = prefixAll({
transition: '200ms all linear',
boxSizing: 'border-box',
display: 'flex',
color: 'blue'
});If you got any issue using this prefixer, please first check the FAQ's. Most cases are already covered and provide a solid solution.
Here are some popular users of this library:
PS: Feel free to add your solution!
Join us on Gitter. We highly appreciate any contribution.
We also love to get feedback.
inline-style-prefixer is licensed under the MIT License.
Documentation is licensed under Creative Common License.
Created with ♥ by @rofrischmann and all contributors.