128 lines
2.0 KiB
Markdown
128 lines
2.0 KiB
Markdown
|
|
# declaration-block-semicolon-newline-after
|
||
|
|
|
||
|
|
Require a newline or disallow whitespace after the semicolons of declaration blocks.
|
||
|
|
|
||
|
|
```css
|
||
|
|
a {
|
||
|
|
color: pink;
|
||
|
|
top: 0; ↑
|
||
|
|
} ↑
|
||
|
|
/** ↑
|
||
|
|
* The newline after this semicolon */
|
||
|
|
```
|
||
|
|
|
||
|
|
This rule ignores:
|
||
|
|
|
||
|
|
- semicolons that are preceded by Less mixins
|
||
|
|
- the last semicolon of declaration blocks
|
||
|
|
|
||
|
|
Use the `block-closing-brace-*-before` rules to control the whitespace between the last semicolon and the closing brace instead.
|
||
|
|
|
||
|
|
This rule allows an end-of-line comment followed by a newline. For example,
|
||
|
|
|
||
|
|
```css
|
||
|
|
a {
|
||
|
|
color: pink; /* end-of-line comment */
|
||
|
|
top: 0;
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
The `--fix` option on the [command line](../../../docs/user-guide/cli.md#autofixing-errors) can automatically fix all of the problems reported by this rule.
|
||
|
|
|
||
|
|
## Options
|
||
|
|
|
||
|
|
`string`: `"always"|"always-multi-line"|"never-multi-line"`
|
||
|
|
|
||
|
|
### `"always"`
|
||
|
|
|
||
|
|
There *must always* be a newline after the semicolon.
|
||
|
|
|
||
|
|
The following patterns are considered violations:
|
||
|
|
|
||
|
|
```css
|
||
|
|
a { color: pink; top: 0; }
|
||
|
|
```
|
||
|
|
|
||
|
|
```css
|
||
|
|
a {
|
||
|
|
color: pink; /* end-of-line comment
|
||
|
|
containing a newline */
|
||
|
|
top: 0;
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
The following patterns are *not* considered violations:
|
||
|
|
|
||
|
|
```css
|
||
|
|
a {
|
||
|
|
color: pink;
|
||
|
|
top: 0;
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
```css
|
||
|
|
a {
|
||
|
|
color: pink; /* end-of-line comment */
|
||
|
|
top: 0;
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
### `"always-multi-line"`
|
||
|
|
|
||
|
|
There *must always* be a newline after the semicolon in multi-line rules.
|
||
|
|
|
||
|
|
The following patterns are considered violations:
|
||
|
|
|
||
|
|
```css
|
||
|
|
a {
|
||
|
|
color: pink; top: 0;
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
The following patterns are *not* considered violations:
|
||
|
|
|
||
|
|
```css
|
||
|
|
a { color: pink; }
|
||
|
|
```
|
||
|
|
|
||
|
|
```css
|
||
|
|
a { color: pink; top: 0; }
|
||
|
|
```
|
||
|
|
|
||
|
|
```css
|
||
|
|
a {
|
||
|
|
color: pink;
|
||
|
|
top: 0;
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
### `"never-multi-line"`
|
||
|
|
|
||
|
|
There *must never* be whitespace after the semicolon in multi-line rules.
|
||
|
|
|
||
|
|
The following patterns are considered violations:
|
||
|
|
|
||
|
|
```css
|
||
|
|
a {
|
||
|
|
color: pink;
|
||
|
|
top: 0;
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
The following patterns are *not* considered violations:
|
||
|
|
|
||
|
|
```css
|
||
|
|
a { color: pink; }
|
||
|
|
```
|
||
|
|
|
||
|
|
```css
|
||
|
|
a { color: pink; top: 0; }
|
||
|
|
```
|
||
|
|
|
||
|
|
```css
|
||
|
|
a {
|
||
|
|
color: pink
|
||
|
|
; top: 0;
|
||
|
|
}
|
||
|
|
```
|