This site uses cookies for analytics. By continuing to browse this site, you agree to this use.

Avoid CSS limits

Avoid CSS limits (stylesheet-limits)

stylesheet-limits checks if CSS exceeds known stylesheet limits.

Why is this important?

Internet Explorer 9 and below have limits on the number of CSS stylesheets, imports, and rules which are relatively small compared to modern browsers. Once these limits are exceeded, additional stylesheets, imports, and rules are ignored. For more details see “Stylesheet limits in Internet Explorer”.

Similar behavior existed in older versions of other browsers, such as Chrome. Newer browsers have much higher limits such as 65535 rules in Internet Explorer 10+ and Edge.

Even in modern browsers large numbers of CSS selectors can negatively impact performance. You can customize this hint and set appropriate limits for your project or team.

What does the hint check?

When targeting versions of Internet Explorer 9 and below, this hint checks if one of the following limits is exceeded:

  • 4095 rules
  • 31 stylesheets
  • 4 levels of imports

Examples that trigger the hint

  • A page targeting Internet Explorer 9 containing 4096 or more CSS rules.

Examples that pass the hint

  • A page targeting Internet Explorer 9 with fewer than 4096 CSS rules.
  • A page not targeting Internet Explorer 9 or below regardless of the number of CSS rules.

Can the hint be configured?

You can overwrite the defaults by specifying custom values for the number of CSS rules to allow. Note that if the custom values are above the default values, the default values will still be used.

In the .hintrc file:

{
    "connector": {...},
    "formatters": [...],
    "hints": {
        "stylesheet-limit": ["error", {
            "maxRules": 1000,
            "maxSheets": 10,
            "maxImports": 2
        }],
        ...
    },
    ...
}

How to use this hint?

This package is installed automatically by webhint:

npm install hint --save-dev

To use it, activate it via the .hintrc configuration file:

{
    "connector": {...},
    "formatters": [...],
    "hints": {
        "stylesheet-limits": "error",
        ...
    },
    "parsers": [...],
    ...
}

Note: The recommended way of running webhint is as a devDependency of your project.