.config/coc/extensions/node_modules/coc-prettier/node_modules/stylelint/lib/rules/function-parentheses-newline-inside/README.md

   1 # function-parentheses-newline-inside
   2
   3 Require a newline or disallow whitespace on the inside of the parentheses of functions.
   4
   5 ```css
   6   a {
   7     transform: translate(
   8       1,             /* ↑ */
   9       1              /* ↑ */
  10     );               /* ↑ */
  11   }                  /* ↑ */
  12 /** ↑                   ↑
  13  * The newline inside these two parentheses */
  14 ```
  15
  16 ## Options
  17
  18 `string`: `"always"|"always-multi-line"|"never-multi-line"`
  19
  20 ### `"always"`
  21
  22 There *must always* be a newline inside the parentheses.
  23
  24 The following patterns are considered violations:
  25
  26 ```css
  27 a { transform: translate(1, 1); }
  28 ```
  29
  30 ```css
  31 a { transform: translate(1,
  32   1
  33   ); }
  34 ```
  35
  36 The following patterns are *not* considered violations:
  37
  38 ```css
  39 a {
  40   transform: translate(
  41     1, 1
  42   );
  43 }
  44 ```
  45
  46 ```css
  47 a {
  48   transform: translate(
  49     1,
  50     1
  51   );
  52 }
  53 ```
  54
  55 ### `"always-multi-line"`
  56
  57 There *must always* be a newline inside the parentheses of multi-line functions.
  58
  59 The following patterns are considered violations:
  60
  61 ```css
  62 a { transform: translate(1,
  63   1) }
  64 ```
  65
  66 The following patterns are *not* considered violations:
  67
  68 ```css
  69 a { transform: translate(1, 1) }
  70 ```
  71
  72 ```css
  73 a { transform: translate( 1, 1 ) }
  74 ```
  75
  76 ```css
  77 a {
  78   transform: translate(
  79     1, 1
  80   );
  81 }
  82 ```
  83
  84 ```css
  85 a {
  86   transform: translate(
  87     1,
  88     1
  89   );
  90 }
  91 ```
  92
  93 ### `"never-multi-line"`
  94
  95 The following patterns are considered violations:
  96
  97 ```css
  98 a {
  99   transform: translate(
 100     1, 1
 101   );
 102 }
 103 ```
 104
 105 ```css
 106 a {
 107   transform: translate(
 108     1,
 109     1
 110   );
 111 }
 112 ```
 113
 114 The following patterns are *not* considered violations:
 115
 116 ```css
 117 a { transform: translate(1, 1) }
 118 ```
 119
 120 ```css
 121 a { transform: translate( 1, 1 ) }
 122 ```
 123
 124 ```css
 125 a { transform: translate(1,
 126   1) }
 127 ```