stylelint/lib/rules/value-list-comma-newline-after/README.md

A mighty, modern CSS linter.

# value-list-comma-newline-after

Require a newline or disallow whitespace after the commas of value lists.

<!-- prettier-ignore -->
```css
a { background-size: 0,
      0; }            ↑
/**                   ↑
 * The newline after this comma */
```

The [`fix` option](../../../docs/user-guide/usage/options.md#fix) can automatically fix most 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 commas.

The following patterns are considered violations:

<!-- prettier-ignore -->
```css
a { background-size: 0,0; }
```

<!-- prettier-ignore -->
```css
a { background-size: 0
      , 0; }
```

The following patterns are _not_ considered violations:

<!-- prettier-ignore -->
```css
a { background-size: 0,
      0; }
```

### `"always-multi-line"`

There _must always_ be a newline after the commas in multi-line value lists.

The following patterns are considered violations:

<!-- prettier-ignore -->
```css
a { background-size: 0
    , 0; }
```

The following patterns are _not_ considered violations:

<!-- prettier-ignore -->
```css
a { background-size: 0, 0; }
```

<!-- prettier-ignore -->
```css
a { background-size: 0,0; }
```

<!-- prettier-ignore -->
```css
a { background-size: 0,
      0; }
```

### `"never-multi-line"`

There _must never_ be whitespace after the commas in multi-line value lists.

The following patterns are considered violations:

<!-- prettier-ignore -->
```css
a { background-size: 0
      , 0; }
```

The following patterns are _not_ considered violations:

<!-- prettier-ignore -->
```css
a { background-size: 0,0; }
```

<!-- prettier-ignore -->
```css
a { background-size: 0, 0; }
```

<!-- prettier-ignore -->
```css
a { background-size: 0
      ,0; }
```