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

A mighty, modern CSS linter.

# function-parentheses-newline-inside

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/usage/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 violations:

<!-- prettier-ignore -->
```css
a { transform: translate(1, 1); }
```

<!-- prettier-ignore -->
```css
a { transform: translate(1,
  1
  ); }
```

The following patterns are _not_ considered violations:

<!-- 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 violations:

<!-- prettier-ignore -->
```css
a { transform: translate(1,
  1) }
```

The following patterns are _not_ considered violations:

<!-- 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 violations:

<!-- prettier-ignore -->
```css
a {
  transform: translate(
    1, 1
  );
}
```

<!-- prettier-ignore -->
```css
a {
  transform: translate(
    1,
    1
  );
}
```

The following patterns are _not_ considered violations:

<!-- prettier-ignore -->
```css
a { transform: translate(1, 1) }
```

<!-- prettier-ignore -->
```css
a { transform: translate( 1, 1 ) }
```

<!-- prettier-ignore -->
```css
a { transform: translate(1,
  1) }
```