撰寫自訂語法

自訂語法是 PostCSS 語法，由社群撰寫，用於支援其他樣式語言，例如 SCSS，以及容器，例如 HTML，使用 customSyntax 選項。

要撰寫自訂語法，請熟悉 PostCSS 的 撰寫自訂語法指南。您可以參考 讚 Stylelint 中現有的自訂語法之一。

例如

import postcss from "postcss";

function parse(css, opts) {
  const root = postcss.root();
  // adding other nodes to root...
  return root;
}

function stringify(node, builder) {
  // just use the default stringifier
  postcss.stringify(node, builder);

  // or write custom stringifier...
}

export default { parse, stringify };

發布自訂語法後，我們建議建立一個共用設定檔，用於

• 延伸 標準設定檔
• 組合您的自訂語法
• 關閉任何不相容的內建規則

全部在支援的檔案副檔名的 overrides 內。

例如，如果您要為稱為「foo」的語言建立自訂語法（使用檔案副檔名 .foo），我們建議建立一個名為「stylelint-config-standard-foo」的共用設定檔，內容如下

import yourCustomSyntax from "postcss-your-custom-syntax";

export default {
  overrides: [
    {
      files: ["*.foo", "**/*.foo"],
      customSyntax: yourCustomSyntax,
      extends: ["stylelint-config-standard"],
      rules: {
        "at-rule-no-unknown": null
        // ..
      }
    }
  ]
};

我們建議在 PostCSS v7 不再流通之前，要求使用自訂語法。