stylelint-browser-compat

Yet another linter rule to detect compatibility of CSS features.

This plugin checks if the CSS you're using is supported by the browsers you're targeting. It uses @mdn/browser-compat-data to detect browser support.

:warning: This plugin is beta. USE AT YOUR OWN RISK.

Table of Contents

• Background
• Install
• Usage
• Contributing
• License

Background

stylelint-no-unsupported-browser-features (using doiuse) is available to detect compatibility of CSS features.

However, doiuse have not been maintained for a long time.

This library provides another alternative to detect compatibility of CSS features.

Although doiuse detects compatibility from caniuse data, this library uses @mdn/browser-compat-data to do so.

Install

1$ npm install --dev browserslist stylelint stylelint-browser-compat

1$ yarn add --dev browserslist stylelint stylelint-browser-compat

Usage

1module.exports = {
2  plugins: ['stylelint-browser-compat'],
3  rules: {
4    'plugin/browser-compat': [
5      true,
6      {
7        allow: {
8          features: ['at-rules.supports'],
9          flagged: false,
10          partialImplementation: false,
11          prefix: true,
12        },
13        browserslist: ['last 2 versions'],
14      },
15    ],
16  },
17};

Options

• browserslist (string or array, optional)
  • Accepts browserslist queries for target browsers.
  • By default, browserslist automatically loads the configuration file (e.g. package.json, .browserslistrc).
• allow.features (array, optional)
  • Accepts an array of features to allow.
  • Feature names are from @mdn/browser-compat-data.
    • For example, if you want to use @supports at-rules, pass at-rules.supports.
• allow.flagged (boolean, optional)
  • Allows features that are available when the browser's feature flags is enabled.
  • false by default
• allow.partialImplementation (boolean, optional)
  • Allows features that are partial implementations.
  • false by default
• allow.prefix (boolean, optional)
  • Allows features with vendor prefix.
  • true by default

Contributing

PRs accepted.

License

MIT (c) 3846masa