stylelint/lib/rules/function-comma-newline-before/README.md

A mighty, modern CSS linter.

# function-comma-newline-before

Require a newline or disallow whitespace before the commas of functions.

<!-- prettier-ignore -->
```css
  a { transform: translate(1
    , 1) }
/** ↑
 * This comma */
```

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 before the commas.

The following patterns are 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) }
```

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 before the commas in 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"`

There _must never_ be whitespace before the commas in 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)
}
```