css/tools/stylelint-selector-no-utility/README.md

selector-no-utility

This plugin is specific to primer-utilities. We'll accept pull requests to make it more generic, or feel free to fork and use it for your own classes.

Utilities are single purpose styles that should be treated as immutable CSS. They should not be altered by custom CSS as this can cause unwanted side effects.

    .m-0, #bar .float-left, #hoo { border: 1px solid pink; }
/** ↑          ↑
 * Each of these selectors */

The following patterns are considered warnings:

#bar .float-left { border: 1px solid pink; }

#bar {
  .float-left { border: 1px solid pink; }
}

The following patterns are not considered warnings:

#bar { color: pink; }

Install

This repository is distributed with npm. After installing npm, you can install stylelint-function-url-no-domain with this command.

$ npm install --save-dev stylelint-function-url-no-domain

Usage

In your stylelint config add this.

{
  "plugins": [
    "stylelint-selector-no-utility"
  ],
  "rules": {
    "primer/selector-no-utility": true
  }
}

Related

• Stylelint
• primer

License

MIT © GitHub