Stylelint
Stylelint is a popular linter for CSS.
Run Locally
The mozlint integration of Stylelint can be run using mach:
$ mach lint --linter stylelint <file paths>
Alternatively, omit the --linter stylelint
and run all configured linters, which will include
Stylelint.
Stylelint also supports the --fix
option to autofix most errors raised from most of the rules.
See the Usage guide for more options.
Understanding Rules and Errors
Only some files are linted, see the configuration for details.
By design we do not lint/format reftests not crashtests as these are specially crafted tests.
If you don’t understand a rule, you can look it in stylelint.io’s rule list for more information about it.
Common Issues and How To Solve Them
This code should neither be linted nor formatted
If it is a third-party piece of code, please add it to ThirdPartyPaths.txt.
If it is a generated file, please add it to Generated.txt.
If intentionally invalid, please add it to .stylelintignore.
Configuration
The global configuration file lives in topsrcdir/.stylelintrc.js
.
For an overview of the supported configuration, see Stylelint’s documentation.
Please keep differences in rules across the tree to a minimum. We want to be consistent to make it easier for developers.
Sources
Builders
Gijs Kruitbosch (gijs) owns the builders. Questions can also be asked on #lint:mozilla.org on Matrix.
Stylelint task
This is a tier-1 task. For test failures the patch causing the issue should be backed out or the issue fixed.
Some failures can be fixed with ./mach lint -l stylelint --fix path/to/file
.
For test harness issues, file bugs in Developer Infrastructure :: Lint and Formatting.