.gitignore added
[dotfiles/.git] / .config / coc / extensions / node_modules / coc-prettier / node_modules / stylelint / lib / rules / block-opening-brace-newline-before / README.md
diff --git a/.config/coc/extensions/node_modules/coc-prettier/node_modules/stylelint/lib/rules/block-opening-brace-newline-before/README.md b/.config/coc/extensions/node_modules/coc-prettier/node_modules/stylelint/lib/rules/block-opening-brace-newline-before/README.md
new file mode 100644 (file)
index 0000000..91d0264
--- /dev/null
@@ -0,0 +1,153 @@
+# block-opening-brace-newline-before
+
+Require a newline or disallow whitespace before the opening brace of blocks.
+
+```css
+  a
+    { color: pink; }
+/** ↑
+ * The newline before this brace */
+```
+
+Refer to [the FAQ](../../../docs/user-guide/faq.md#how-do-i-disallow-single-line-blocks) for more information on using this rule with [`block-opening-brace-newline-after`](../block-opening-brace-newline-after/README.md) to disallow single-line rules.
+
+## Options
+
+`string`: `"always"|"always-single-line"|"never-single-line"|"always-multi-line"|"never-multi-line"`
+
+### `"always"`
+
+There *must always* be a newline before the opening brace.
+
+The following patterns are considered violations:
+
+```css
+a{ color: pink; }
+```
+
+```css
+a{ color: pink;
+}
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a
+{ color: pink; }
+```
+
+```css
+a
+{
+color: pink; }
+```
+
+```css
+a /* foo */
+  {
+    color: pink;
+  }
+```
+
+### `"always-single-line"`
+
+There *must always* be a newline before the opening brace in single-line blocks.
+
+The following patterns are considered violations:
+
+```css
+a{ color: pink; }
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a
+{ color: pink; }
+```
+
+```css
+a{
+color: pink; }
+```
+
+### `"never-single-line"`
+
+There *must never* be whitespace before the opening brace in single-line blocks.
+
+The following patterns are considered violations:
+
+```css
+a { color: pink; }
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a{ color: pink; }
+```
+
+```css
+a {
+color: pink; }
+```
+
+### `"always-multi-line"`
+
+There *must always* be a newline before the opening brace in multi-line blocks.
+
+The following patterns are considered violations:
+
+```css
+a{
+color: pink; }
+```
+
+```css
+a {
+color: pink; }
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a{ color: pink; }
+```
+
+```css
+a { color: pink; }
+```
+
+```css
+a
+{ color: pink; }
+```
+
+```css
+a
+{
+color: pink; }
+```
+
+### `"never-multi-line"`
+
+There *must never* be whitespace before the opening brace in multi-line blocks.
+
+The following patterns are considered violations:
+
+```css
+a {
+color: pink; }
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a { color: pink; }
+```
+
+```css
+a{
+color: pink;}
+```