Liquid Snippets by ALSEL
🧰 ユーティリティ中級

Prettier フォーマット無視コメント

Liquid および HTML の Prettier フォーマッターに対し、特定の行やブロックをフォーマット対象外にするコメント構文の実装例。HTML コメント形式と Liquid コメント形式の両方に対応している。

用途
テーマコード整形時に、特定の Liquid ループやマークアップを意図的にフォーマット対象外にしたいとき。Prettier プラグイン統合時の無視ルール検証に。
設置場所
このコードはテストファイル・参考資料であり、実装ファイルではない。テーマの .liquid ファイルで Prettier を無視したい箇所の直前に `<!-- prettier-ignore -->` または `{% # prettier-ignore %}` を挿入する。
注意点
HTML コメント形式 `<!-- prettier-ignore -->` は HTML ブロックに、Liquid コメント形式 `{% # prettier-ignore %}` は Liquid タグに対して有効。無視コメントは対象行または直後のブロック全体に作用するため、複雑なネスト構造では意図しない範囲までフォーマット外れになる可能性がある。Prettier・Liquid プラグインのバージョン依存性があるため、ローカル環境で動作確認してから本番コードに適用する。
タグ:prettiercode-formattingliquid-commenthtml-commentlinting

コード

45 行 / liquid
It should respect the html prettier-ignore comment
printWidth: 1
<!-- prettier-ignore -->
{% cycle a,b,c %}

It should respect the html prettier-ignore comment on tags
printWidth: 1
<a>
<!-- prettier-ignore -->
<b>{% cycle a,b,c %}</b>hi
</a>

It should respect the html prettier-ignore comment on liquid tags
printWidth: 1
<a>
<!-- prettier-ignore -->
{%capture foo%}{% for x in (0 .. 1) %}{% cycle a,b,c %}{% endfor %}{%endcapture%}
</a>

It should respect the liquid prettier-ignore comment
printWidth: 1
{% # prettier-ignore %}
{% cycle a,b,c %}

It should respect the liquid prettier-ignore comment on tags
printWidth: 1
<a>
{% # prettier-ignore %}
<b>{% cycle a,b,c %}</b>hi
</a>

It should respect the liquid prettier-ignore comment on liquid tags
printWidth: 1
<a>
{% # prettier-ignore %}
{%capture foo%}{% for x in (0 .. 1) %}{% cycle a,b,c %}{% endfor %}{%endcapture%}
</a>

It should respect the liquid prettier-ignore comment on tags (and maintain whitespace semantic meaning)
printWidth: 1
<a>
{% # prettier-ignore %}
{%capture foo%}{% for x in (0 .. 1) %}{% cycle a,b,c %}{% endfor %}{%endcapture%}{{ 'hi' }}
</a>

出典・ライセンス

License:
MIT

このコードは Shopify 著作の MIT ライセンスソースです。 原本の著作権は Shopify が保有します。日本語訳は ALSEL によるものです。

関連項目

🧰 ユーティリティ初級

コメント後の空白フォーマット

Liquid コメントタグの直後に改行や空白がある場合の正しいフォーマット例。prettier-plugin-liquid によるコード整形テストケース。

📁 theme-tools·MIT·6
🧰 ユーティリティ初級

Liquidコメントのフォーマット

Liquid のコメントタグ直後に改行がある場合の正しいフォーマット例。prettier-plugin-liquid による自動整形テストケース。

📁 theme-tools·MIT·6
🧰 ユーティリティ初級

セクション呼び出しの改行制御

{% sections %} タグの前後の空白制御(ホワイトスペース削除演算子 `{%-` と `-%}` の使い方)を示すサンプル。Prettier による Liquid コードフォーマットで改行が崩れないことを確認するテストケース。

📁 theme-tools·MIT·7
🧰 ユーティリティ初級

Prettier フォーマッタの HTML リスト整形テスト

Prettier Liquid プラグインが HTML のリスト要素(ul / ol)をどのように整形・改行するかをテストするサンプルコード。短い行は1行、長い行は複数行に自動で分割される動作を検証する。

📁 theme-tools·MIT·8
🧰 ユーティリティ上級

Vue.js属性のLiquid整形

Vue.js のディレクティブ(@click、:class など)を含む Liquid コードを Prettier で正しく整形するテストケース。spec 準拠の属性名を保持したまま、改行・インデント処理を行う。

📁 theme-tools·MIT·9
🧰 ユーティリティ上級

sections タグのフォーマット

Liquid の sections タグ構文と、Prettier によるフォーマット時の動作を示すテストファイル。タグ名の直前・直後の空白や改行が保持される仕様を確認するサンプル。

📁 theme-tools·MIT·9