|
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421 |
- # at-rule-empty-line-before
-
- Require or disallow an empty line before at-rules.
-
- <!-- prettier-ignore -->
- ```css
- a {}
- /* ← */
- @media {} /* ↑ */
- /** ↑
- * This line */
- ```
-
- This rule ignores:
-
- - at-rules that are the very first node in the source
- - `@import` in Less.
-
- The [`fix` option](../../../docs/user-guide/usage/options.md#fix) can automatically fix all of the problems reported by this rule. We recommend to enable [`indentation`](../indentation/README.md) rule for better autofixing results with this rule.
-
- ## Options
-
- `string`: `"always"|"never"`
-
- ### `"always"`
-
- There _must always_ be an empty line before at-rules.
-
- The following patterns are considered violations:
-
- <!-- prettier-ignore -->
- ```css
- a {} @media {}
- ```
-
- <!-- prettier-ignore -->
- ```css
- a {}
- @media {}
- ```
-
- The following patterns are _not_ considered violations:
-
- <!-- prettier-ignore -->
- ```css
- a {}
-
- @media {}
- ```
-
- ### `"never"`
-
- There _must never_ be an empty line before at-rules.
-
- The following patterns are considered violations:
-
- <!-- prettier-ignore -->
- ```css
- a {}
-
- @media {}
- ```
-
- The following patterns are _not_ considered violations:
-
- <!-- prettier-ignore -->
- ```css
- a {} @media {}
- ```
-
- <!-- prettier-ignore -->
- ```css
- a {}
- @media {}
- ```
-
- ## Optional secondary options
-
- ### `except: ["after-same-name", "inside-block", "blockless-after-same-name-blockless", "blockless-after-blockless", "first-nested"]`
-
- #### `"after-same-name"`
-
- Reverse the primary option for at-rules that follow another at-rule with the same name.
-
- This means that you can group your at-rules by name.
-
- For example, with `"always"`:
-
- The following patterns are _not_ considered violations:
-
- <!-- prettier-ignore -->
- ```css
- @charset "UTF-8";
-
- @import url(x.css);
- @import url(y.css);
-
- @media (min-width: 100px) {}
- @media (min-width: 200px) {}
- ```
-
- <!-- prettier-ignore -->
- ```css
- a {
-
- @extends .foo;
- @extends .bar;
-
- @include x;
- @include y {}
- }
- ```
-
- #### `"inside-block"`
-
- Reverse the primary option for at-rules that are inside a block.
-
- For example, with `"always"`:
-
- The following patterns are considered violations:
-
- <!-- prettier-ignore -->
- ```css
- a {
-
- @extend foo;
- color: pink;
- }
-
- b {
- color: pink;
-
- @extend foo;
- }
- ```
-
- The following patterns are _not_ considered violations:
-
- <!-- prettier-ignore -->
- ```css
- a {
- @extend foo;
- color: pink;
- }
-
- b {
- color: pink;
- @extend foo;
- }
- ```
-
- #### `"blockless-after-same-name-blockless"`
-
- Reverse the primary option for blockless at-rules that follow another blockless at-rule with the same name.
-
- This means that you can group your blockless at-rules by name.
-
- Shared-line comments do not affect this option.
-
- For example, with `"always"`:
-
- The following patterns are _not_ considered violations:
-
- <!-- prettier-ignore -->
- ```css
- @charset "UTF-8";
-
- @import url(x.css);
- @import url(y.css);
- ```
-
- <!-- prettier-ignore -->
- ```css
- @charset "UTF-8";
-
- @import url(x.css); /* comment */
- @import url(y.css);
- ```
-
- <!-- prettier-ignore -->
- ```css
- a {
-
- @extends .foo;
- @extends .bar;
-
- @include loop;
- @include doo;
- }
- ```
-
- #### `"blockless-after-blockless"`
-
- Reverse the primary option for blockless at-rules that follow another blockless at-rule.
-
- Shared-line comments do not affect this option.
-
- For example, with `"always"`:
-
- The following patterns are considered violations:
-
- <!-- prettier-ignore -->
- ```css
- @import url(x.css);
-
- @import url(y.css);
-
- @media print {}
- ```
-
- The following patterns are _not_ considered violations:
-
- <!-- prettier-ignore -->
- ```css
- @import url(x.css);
- @import url(y.css);
-
- @media print {}
- ```
-
- <!-- prettier-ignore -->
- ```css
- @import url(x.css); /* comment */
- @import url(y.css);
-
- @media print {}
- ```
-
- #### `"first-nested"`
-
- Reverse the primary option for at-rules that are nested and the first child of their parent node.
-
- For example, with `"always"`:
-
- The following patterns are considered violations:
-
- <!-- prettier-ignore -->
- ```css
- a {
-
- @extend foo;
- color: pink;
- }
-
- b {
- color: pink;
- @extend foo;
- }
- ```
-
- The following patterns are _not_ considered violations:
-
- <!-- prettier-ignore -->
- ```css
- a {
- @extend foo;
- color: pink;
- }
-
- b {
- color: pink;
-
- @extend foo;
- }
- ```
-
- ### `ignore: ["after-comment", "first-nested", "inside-block", "blockless-after-same-name-blockless", "blockless-after-blockless"]`
-
- #### `"after-comment"`
-
- Ignore at-rules that follow a comment.
-
- Shared-line comments do not trigger this option.
-
- The following patterns are _not_ considered violations:
-
- <!-- prettier-ignore -->
- ```css
- /* comment */
- @media {}
- ```
-
- <!-- prettier-ignore -->
- ```css
- /* comment */
-
- @media {}
- ```
-
- <!-- prettier-ignore -->
- ```css
- @media {} /* comment */
-
- @media {}
- ```
-
- #### `"first-nested"`
-
- Ignore at-rules that are nested and the first child of their parent node.
-
- For example, with `"always"`:
-
- The following patterns are _not_ considered violations:
-
- <!-- prettier-ignore -->
- ```css
- @supports {
- @media {}
-
- @media {}
- }
- ```
-
- #### `"inside-block"`
-
- Ignore at-rules that are inside a block.
-
- For example, with `"always"`:
-
- The following patterns are _not_ considered violations:
-
- <!-- prettier-ignore -->
- ```css
- a {
- @extend foo;
- color: pink;
- }
-
- a {
-
- @extend foo;
- color: pink;
- }
-
- b {
- color: pink;
- @extend foo;
- }
-
- b {
- color: pink;
-
- @extend foo;
- }
- ```
-
- #### `"blockless-after-same-name-blockless"`
-
- Ignore blockless at-rules that follow another blockless at-rule with the same name.
-
- This means that you can group your blockless at-rules by name.
-
- For example, with `"always"`:
-
- The following patterns are _not_ considered violations:
-
- <!-- prettier-ignore -->
- ```css
-
- @charset "UTF-8";
-
- @import url(x.css);
- @import url(y.css);
- ```
-
- <!-- prettier-ignore -->
- ```css
- a {
-
- @extends .foo;
- @extends .bar;
-
- @include loop;
- @include doo;
- }
- ```
-
- #### `"blockless-after-blockless"`
-
- Ignore blockless at-rules that follow another blockless at-rule.
-
- For example, with `"always"`:
-
- The following patterns are _not_ considered violations:
-
- <!-- prettier-ignore -->
- ```css
- @import url(x.css);
-
- @import url(y.css);
-
- @media print {}
- ```
-
- <!-- prettier-ignore -->
- ```css
- @import url(x.css);
- @import url(y.css);
-
- @media print {}
- ```
-
- ### `ignoreAtRules: ["array", "of", "at-rules"]`
-
- Ignore specified at-rules.
-
- For example, with `"always"`.
-
- Given:
-
- ```
- ["import"]
- ```
-
- The following patterns are _not_ considered violations:
-
- <!-- prettier-ignore -->
- ```css
- @charset "UTF-8";
- @import {}
- ```
|