.config/coc/extensions/node_modules/coc-prettier/node_modules/stylelint/lib/rules/value-list-comma-newline-before/README.md

   1 # value-list-comma-newline-before
   2
   3 Require a newline or disallow whitespace before the commas of value lists.
   4
   5 ```css
   6   a { background-size: 0
   7     , 0; }
   8 /** ↑
   9  * The newline before these commas */
  10 ```
  11
  12 ## Options
  13
  14 `string`: `"always"|"always-multi-line"|"never-multi-line"`
  15
  16 ### `"always"`
  17
  18 There *must always* be a newline before the commas.
  19
  20 The following patterns are considered violations:
  21
  22 ```css
  23 a { background-size: 0,0; }
  24 ```
  25
  26 ```css
  27 a { background-size: 0,
  28       0; }
  29 ```
  30
  31 The following patterns are *not* considered violations:
  32
  33 ```css
  34 a { background-size: 0
  35       , 0; }
  36 ```
  37
  38 ### `"always-multi-line"`
  39
  40 There *must always* be a newline before the commas in multi-line value lists.
  41
  42 The following patterns are considered violations:
  43
  44 ```css
  45 a { background-size: 0,
  46       0; }
  47 ```
  48
  49 The following patterns are *not* considered violations:
  50
  51 ```css
  52 a { background-size: 0, 0; }
  53 ```
  54
  55 ```css
  56 a { background-size: 0,0; }
  57 ```
  58
  59 ```css
  60 a { background-size: 0
  61       , 0; }
  62 ```
  63
  64 ### `"never-multi-line"`
  65
  66 There *must never* be whitespace before the commas in multi-line value lists.
  67
  68 The following patterns are considered violations:
  69
  70 ```css
  71 a { background-size: 0
  72       , 0; }
  73 ```
  74
  75 The following patterns are *not* considered violations:
  76
  77 ```css
  78 a { background-size: 0,0; }
  79 ```
  80
  81 ```css
  82 a { background-size: 0, 0; }
  83 ```
  84
  85 ```css
  86 a { background-size: 0,
  87       0; }
  88 ```