1
0
mirror of https://github.com/thangisme/notes.git synced 2024-06-11 10:50:44 +00:00
notes/node_modules/stylelint/lib/rules/declaration-empty-line-before/README.md
Patrick Marsceill b7b0d0d7bf
Initial commit
2017-03-09 13:16:08 -05:00

241 lines
2.9 KiB
Markdown

# declaration-empty-line-before
Require or disallow an empty line before declarations.
```css
a {
--foo: pink;
/* ← */
top: 15px; /* ↑ */
} /* ↑ */
/** ↑
* This line */
```
## Options
`string`: `"always"|"never"`
### `"always"`
The following patterns are considered warnings:
```css
a {
--foo: pink;
top: 5px;
}
```
```css
a {
bottom: 15px;
top: 5px;
}
```
The following patterns are *not* considered warnings:
```css
a {
--foo: pink;
top: 5px;
}
```
```css
a {
bottom: 15px;
top: 5px;
}
```
### `"never"`
The following patterns are considered warnings:
```css
a {
--foo: pink;
bottom: 15px;
}
```
```css
a {
bottom: 15px;
top: 5px;
}
```
The following patterns are *not* considered warnings:
```css
a {
--foo: pink;
bottom: 15px;
}
```
```css
a {
bottom: 15px;
top: 5px;
}
```
## Optional secondary options
### `except: ["after-comment", "after-declaration", "first-nested"]`
#### `"after-comment"`
Reverse the primary option for declarations that come after a comment.
For example, with `"always"`:
The following patterns are considered warnings:
```css
a {
/* comment */
top: 5px;
}
```
The following patterns are *not* considered warnings:
```css
a {
/* comment */
top: 5px;
}
```
#### `"after-declaration"`
Reverse the primary option for declarations that come after another declaration.
For example, with `"always"`:
The following patterns are considered warnings:
```css
a {
bottom: 15px;
top: 5px;
}
```
The following patterns are *not* considered warnings:
```css
a {
bottom: 15px;
top: 5px;
}
```
#### `"first-nested"`
Reverse the primary option for declarations that are nested and the first child of their parent node.
For example, with `"always"`:
The following patterns are considered warnings:
```css
a {
bottom: 15px;
top: 5px;
}
```
The following patterns are *not* considered warnings:
```css
a {
bottom: 15px;
top: 5px;
}
```
### `ignore: ["after-comment", "after-declaration", "inside-single-line-block"]`
#### `"after-comment"`
Ignore declarations that are preceded by comments.
For example, with `"always"`:
The following patterns are *not* considered warnings:
```css
a {
/* comment */
bottom: 15px;
}
```
#### `"after-declaration"`
Ignore declarations that are preceded by declarations, to allow for multiple declaration sets in the same block.
For example, with `"always"`:
The following patterns are *not* considered warnings:
```css
a {
bottom: 15px;
top: 15px;
}
```
```css
a {
bottom: 15px;
top: 15px;
}
```
```css
a {
color: orange;
text-decoration: none;
bottom: 15px;
top: 15px;
}
```
#### `"inside-single-line-block"`
Ignore declarations that are inside single-line blocks.
For example, with `"always"`:
The following patterns are *not* considered warnings:
```css
a { bottom: 15px; top: 5px; }
```