Sha256: 2dabe04cb14c7f2dbd2d816e18b64723019c19a1aefc5570a67fd5957c83b862

Contents?: true

Size: 1.42 KB

Versions: 28

Compression:

Stored size: 1.42 KB

Contents

# Check Title (`AssetSizeCSSStylesheetTag`)

The `stylesheet_tag` filter generates a link tag that points to a given stylesheet. This rule exists to prevent large CSS bundles (for speed).

## Check Details

This rule disallows the use of too much CSS in themes, as configured by `threshold_in_bytes`.

:-1: Examples of **incorrect** code for this check:
```liquid
<!-- Here, assets/theme.css is **greater** than `threshold_in_bytes` compressed. -->
{{ 'theme.css' | asset_url | stylesheet_tag }}
```

:+1: Example of **correct** code for this check:
```liquid
<!-- Here, assets/theme.css is **less** than `threshold_in_bytes` compressed. -->
{{ 'theme.css' | asset_url | stylesheet_tag }}
```

## Check Options

The default configuration for this check is the following:

```yaml
AssetSizeCSSStylesheetTag:
  enabled: false
  threshold_in_bytes: 100_000
```

### `threshold_in_bytes`

The `threshold_in_bytes` option (default: `100_000`) determines the maximum allowed compressed size in bytes that a single CSS file can take.

## When Not To Use It

This rule is safe to disable.

## Version

This check has been introduced in Theme Check 1.0.0

## Resources

- [The Performance Inequality Gap](https://infrequently.org/2021/03/the-performance-inequality-gap/)
- [Rule Source][codesource]
- [Documentation Source][docsource]

[codesource]: /lib/theme_check/checks/asset_size_css_stylesheet_tag.rb
[docsource]: /docs/checks/asset_size_css_stylesheet_tag.md

Version data entries

28 entries across 28 versions & 1 rubygems

Version Path
theme-check-1.15.0 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.14.0 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.13.0 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.12.1 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.12.0 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.11.0 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.10.3 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.10.2 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.10.1 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.10.0 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.9.2 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.9.1 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.9.0 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.8.0 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.7.2 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.7.1 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.7.0 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.6.2 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.6.1 docs/checks/asset_size_css_stylesheet_tag.md
theme-check-1.6.0 docs/checks/asset_size_css_stylesheet_tag.md