A Stylelint plugin for enforcing defensive CSS best practices.
A Stylelint plugin to enforce defensive CSS best practices.
Before getting started with the plugin, you must first have Stylelint version 14.0.0 or greater installed
To get started using the plugin, it must first be installed.
npm i stylelint-plugin-defensive-css --save-dev
yarn add stylelint-plugin-defensive-css --dev
With the plugin installed, the rule(s) can be added to the project's Stylelint configuration.
{
"plugins": ["stylelint-plugin-defensive-css"],
"rules": {
"plugin/use-defensive-css": [
true,
{ "severity": "warning" }
]
}
}
The plugin provides multiple rules that can be toggled on and off as needed.
Oftentimes, when using a large image as a background, we tend to forget to account for the case when the design is viewed on a large screen. That background will repeat by default.
Enable this rule in order to prevent unintentional repeating background.
{
"rules": {
"plugin/use-defensive-css": [
true,
{ "background-repeat": true }
]
}
}
div {
background: url('some-image.jpg') repeat black top center;
}
div {
background: url('some-image.jpg') black top center;
background-repeat: no-repeat;
}
div {
background: url('some-image.jpg') black top center;
}
div {
background-image: url('some-image.jpg');
}
CSS variables are gaining more and more usage in web design. There is a method that we can apply to use them in a way that doesn’t break the experience, in case the CSS variable value was empty for some reason.
Enable this rule in order to require fallbacks values for custom properties.
{
"rules": {
"plugin/use-defensive-css": [
true,
{ "custom-property-fallbacks": true }
]
}
}
div {
color: var(--color-primary, #000);
}
div {
color: var(--color-primary);
}
CSS flexbox is one of the most useful CSS layout features nowadays. It’s tempting to add display: flex
to a wrapper and have the child items ordered next to each other. The thing is when there is not enough space, those child items won’t wrap into a new line by default. We need to change that behavior with flex-wrap: wrap
.
Enable this rule in order to require all flex rows to have a flex-wrap value.
{
"rules": {
"plugin/use-defensive-css": [
true,
{ "flex-wrapping": true }
]
}
}
div {
display: flex;
flex-wrap: wrap;
}
div {
display: flex;
flex-direction: row-reverse;
flex-wrap: wrap-reverse;
}
div {
display: flex;
}
div {
display: flex;
flex-direction: row;
}
It's not recommended to group selectors that are meant to work with different browsers. For example, styling an input's placeholder needs multiple selectors per the browser. If we group the selectors, the entire rule will be invalid, according to w3c.
Enable this rule in order to require all vendor-prefixed selectors to be split into their own rules.
{
"rules": {
"plugin/use-defensive-css": [
true,
{ "vendor-prefix-grouping": true }
]
}
}
input::-webkit-input-placeholder {
color: #222;
}
input::-moz-placeholder {
color: #222;
}
input::-webkit-input-placeholder,
input::-moz-placeholder {
color: #222;
}