無効化ディレクティブ
サードパーティのスニペットや、意図的に残している従来の並び順など、書かれたとおりの形を保つ必要があるコードもあります。コメントで、そのコードに対して annealer を無効にできます。
規則
- ブロックコメントのみです。 CSS には行コメントがないため、
//には対応しません。 annealer-disableは、それ以降annealer-enableまたは文書の末尾までのすべてを対象にします。文書の先頭に置けばファイル全体が変更されません。annealer-disable-next-lineは、次の行で始まる構文を対象にします。- 開始タグ(複数行にわたる場合もタグ全体。
<style>要素ならその中身も) - CSS の文(宣言、またはルール全体)
- 開始タグ(複数行にわたる場合もタグ全体。
:の後の理由は任意で、annealer は内容を無視します。- 対象のコードは書かれたとおり、その位置のまま残します。 スタイルシートでは、周りの宣言がソートされても、対象の宣言は元の位置に留まります。
- 適用範囲: マークアップのコメントはマークアップ(と
<style>要素全体)に、CSS のコメントはそれが書かれたスタイルシートの中に適用されます。 - 未知のディレクティブはエラーです。
annealer-で始まるのに既知のディレクティブでないコメント(たとえばタイプミスのannealer-disabel)は、無視されずに実行が失敗します。
実装メモ(スタイルシート)
対象の宣言はその位置に留まり、前後でソートされる宣言の区間を区切るため、それをまたいで移動するものはありません。対象のルールは、ネストしたブロックも含めて書かれたとおりに残します。malva 独自の無視コメント(malva-ignore)は : 理由 の形式を受け付けないため使いません。