Skip to content

Latest commit

 

History

History
97 lines (67 loc) · 2.7 KB

readme.md

File metadata and controls

97 lines (67 loc) · 2.7 KB

sublime-autoprefixer

Sublime plugin to prefix your CSS or SCSS

You shouldn't have to care about vendor prefixes. Now you don't have to!



Adding prefixes manually is a chore. It's also hard to keep track of where and which prefixes are needed. This plugin uses the Autoprefixer module to prefix properties and values according to the Can I Use database. Which means it will only add the necessary prefixes and not bloat your stylesheet. It even lets you specify what browsers you want to target. In addition it will remove existing prefixes which are no longer needed.

Works with CSS and SCSS, but not other preprocessors.

Install

Install Autoprefixer with Package Control and restart Sublime.

You need to have Node.js 20+ installed.
Make sure it's in your $PATH by running node --version in your command-line.
On macOS you need to make sure it's in /usr/local/bin or symlink it there.

See the Autoprefixer version in use here.

Getting started

In a CSS file, open the Command Palette (Command Shift P) and choose Autoprefix CSS. You can alternatively create one or more selections before running the command to only prefix those parts.

Options

(Settings → Package Settings → Autoprefixer)

You can specify which browsers you need to support using an array of rules.

See the supported browser names.

Default

{
	"browsers": ["defaults"],
	"prefixOnSave": false
}

Example

{
	"browsers": [
		"last 1 version",
		"> 10%",
		"> 5% in US",
		"ie 8",
		"ie 7"
	]
}

This will add the needed prefixes for the last version of each browser, all browsers with market share of more than 10% globally and 5% in the US, and Internet Explorer 7 and 8.

Keyboard shortcut

You can also set up a keyboard shortcut to run the command by opening up "Settings → Key Bindings - User" and adding your shortcut with the autoprefixer command.

Example:

[
	{
		"keys": [
			"alt+super+p"
		],
		"command": "autoprefixer"
	}
]

Project settings

You can override the default and user settings for individual projects. Just add an "Autoprefixer" object to the "settings" object in the project's .sublime-project file containing your project specific settings.

Example:

{
	"settings": {
		"Autoprefixer": {
			"browsers": [
				"last 1 version"
			]
		}
	}
}