Break free from CSS prefix hell!
A script that lets you use only unprefixed CSS properties everywhere. It works behind the scenes, adding the current browser’s prefix to any CSS code, only when it’s needed.
Note: To use -prefix-free you don't need to write any JS code, just to include prefixfree.js in your page. The following is meant mostly for plugin authors.
-prefix-free creates 2 global variables:
PrefixFree. StyleFix is a framework for building various CSS fixers and -prefix-free depends on it. Currently, StyleFix is bundled with -prefix-free and only available this way, but it might eventually get split to a separate project, with separate documentation.
StyleFix API Documentation
An array of the current callbacks.
callback to the queue of functions that will be called when fixing CSS code.
callback will be called with the following parameters:
- css (String): The CSS code that is being processed,
raw (Boolean): Whether the CSS code can contain rules etc or it's just a bunch of declarations (such as the ones found in the
element (HTMLElement): The node that the CSS code came from (such as a
<style>element or any element with a
and it should return the fixed CSS code.
<link rel="stylesheet"> element and converts it to a
<style> element with fixed code. Relative URLs will be converted.
Fixes code inside a
Fixes code inside the
style attribute of an element. Will not work in IE and Firefox < 3.6 due to a bug those have with
getAttribute('style'): In IE invalid values of valid properties will be dropped, and in Firefox < 3.6 anything invalid will be dropped.
Utility methods that convert a string to camelCase and back.
-prefix-free API Documentation
The detected prefix of the current browser (like
The detected prefix of the current browser in camelCase format (like
PrefixFree.properties PrefixFree.functions PrefixFree.keywords PrefixFree.selectors PrefixFree.atrules
Properties/functions/keywords/etc that are only available with a prefix in the current browser.
PrefixFree.prefixCSS(code [, raw])
Prefixes the properties and values in the code passed with the prefix of the current browser, only when needed. If the second parameter is truthy, it also prefixes selectors and @-rules. This is the most useful method in -prefix-free.
Prefixes the passed selector or property even when it's supported prefix-less. These are more internal methods and I assume they won't be too useful in general.