🧰 ユーティリティ上級
Prettier Liquid プラグイン: 末尾空白の最適化テスト
Prettier Liquid プラグインにおいて、タグ内の末尾空白を条件に応じて削除・保持するコード整形ロジックの検証例。form / capture タグ周辺の空白ストリップ時の動作を複数パターンで示す。
用途
Liquid コードのフォーマッター開発時に、ブロックタグの末尾空白が不意に削除されたり保持されたりする現象をテストで網羅するとき。
設置場所
Prettier Liquid プラグインの単体テストファイル(packages/prettier-plugin-liquid/src/test/)に配置。実装の正確性検証や回帰テストの参考値として使用する。
注意点
このファイルはテストケースであり、本番テーマでは直接使用しない。form / capture タグの末尾空白削除の可否は親要素の空白感度(trailing-space-sensitive)と子要素の形状(ブロック vs インライン)の組み合わせで決まり、Prettier の設定に依存する。Liquid コードを手動整形する際も、このテストパターンの意図(不可視の空白が HTML 出力に与える影響)を理解した上で whitespace-strip 構文({% -%})を活用する。
コード
26 行 / liquidWhen it doesn't break, it should conditionally omit the trailing space
It should omit the trailing space if it is stripped anyway
{% form 'cart' %}space {%- endform %}
It should not omit the trailing space if there's trailing whitespace and the
parent is trailing space sensitive
{% capture var %}space {% endcapture %}
{%- capture var %}space {% endcapture -%}
{% capture var %}space {% endcapture %}
It should omit the trailing space if there's trailing whitespace and the parent
is not trailing space sensitive
{% form 'cart' %}space {% endform %}
{%- form 'cart' %}space {% endform -%}
{% form 'cart' %}space {% endform %}
It should not omit the whitespace because of whitespace stripping outside the tag
<p>
{% capture var %}aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa {% endcapture %}{{ value }}
</p>
It should omit the surrounding whitespace and inner whitespace for block
rendering contexts
<p>haha{% form 'cart' %}space {% endform %}haha</p>
出典・ライセンス
- Repository:
- https://github.com/Shopify/theme-tools
- 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 行