useSortedProperties

CSS

Summary

Section titled Summary

Danger

This rule hasn’t been released yet. If you want to try it, you can request and try a preview release of Biome

• Diagnostic Category: assist/source/useSortedProperties
• Use the code source.biome.useSortedProperties in your LSP-ready IDE to apply this action on save.
• The default severity of this rule is information.

Description

Section titled Description

Enforce ordering of CSS properties and nested rules.

This rule ensures the contents of a CSS rule are ordered consistently.

Properties are ordered semantically, with more important properties near the top and similar properties grouped together. Nested rules and at-rules are placed after properties.

The ordering is roughly:

1. Custom properties
2. Layout properties (display, flex, grid)
3. Margin and padding properties
4. Typography properties (font, color)
5. Interaction properties (pointer-events, visibility)
6. Background and border properties
7. Transition and animation properties
8. Nested rules, media queries and other at-rules

Examples

Section titled Examples

Invalid

Section titled Invalid

p {
  transition: opactity 1s ease;
  border: 1px solid black;
  pointer-events: none;
  color: black;
  margin: 8px;
  display: block;
  --custom: 100;
}

p {
  span { color: blue; }
  color: red;
}

Valid

Section titled Valid

p {
  --custom:·100;
  display:·block;
  margin:·8px;
  color: black;
  pointer-events:·none;
  border:·1px·solid·black;
  transition:·opactity·1s·ease;
}

p {
  color: red;
  span { color: blue; }
}

How to configure

Section titled How to configure

biome.json

{
  "linter": {
    "rules": {
      "source": {
        "useSortedProperties": "error"
      }
    }
  }
}