Files
DeviceManager/node_modules/stylelint/lib/rules/function-parentheses-newline-inside/README.md

147 lines
2.3 KiB
Markdown

# function-parentheses-newline-inside
> **Warning** This rule is deprecated and will be removed in the future. See [the migration guide](../../../docs/migration-guide/to-15.md).
Require a newline or disallow whitespace on the inside of the parentheses of functions.
<!-- prettier-ignore -->
```css
a {
transform: translate(
1, /* ↑ */
1 /* ↑ */
); /* ↑ */
} /* ↑ */
/** ↑ ↑
* The newline inside these two parentheses */
```
The [`fix` option](../../../docs/user-guide/options.md#fix) 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 inside the parentheses.
The following patterns are considered problems:
<!-- prettier-ignore -->
```css
a { transform: translate(1, 1); }
```
<!-- prettier-ignore -->
```css
a { transform: translate(1,
1
); }
```
The following patterns are _not_ considered problems:
<!-- prettier-ignore -->
```css
a {
transform: translate(
1, 1
);
}
```
<!-- prettier-ignore -->
```css
a {
transform: translate(
1,
1
);
}
```
### `"always-multi-line"`
There _must always_ be a newline inside the parentheses of multi-line functions.
The following patterns are considered problems:
<!-- prettier-ignore -->
```css
a { transform: translate(1,
1) }
```
The following patterns are _not_ considered problems:
<!-- prettier-ignore -->
```css
a { transform: translate(1, 1) }
```
<!-- prettier-ignore -->
```css
a { transform: translate( 1, 1 ) }
```
<!-- prettier-ignore -->
```css
a {
transform: translate(
1, 1
);
}
```
<!-- prettier-ignore -->
```css
a {
transform: translate(
1,
1
);
}
```
### `"never-multi-line"`
The following patterns are considered problems:
<!-- prettier-ignore -->
```css
a {
transform: translate(
1, 1
);
}
```
<!-- prettier-ignore -->
```css
a {
transform: translate(
1,
1
);
}
```
The following patterns are _not_ considered problems:
<!-- prettier-ignore -->
```css
a { transform: translate(1, 1) }
```
<!-- prettier-ignore -->
```css
a { transform: translate( 1, 1 ) }
```
<!-- prettier-ignore -->
```css
a { transform: translate(1,
1) }
```