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

Prettier Liquid プラグインの空白処理テスト

Liquid コード整形時に form タグ前後の空白文字を条件付きで削除するかを判定するテストケース。HTML 空白感度設定と Liquid タグの性質に応じた空白保持・削除の動作を検証する。

用途
Prettier による Liquid コード自動整形で、テンプレートの可読性を損なわずに余分な空白を削除したいとき。form タグを含む cart 操作画面や決済フロー上で whitespace-sensitive な箇所を正しく認識させるため。
設置場所
このコードは prettier-plugin-liquid のテストファイルそのもので、実際のテーマに貼り付けるのではなく、npm test や Prettier の dev 環境で空白削除ロジックの動作確認に使用する。ファイルパスは packages/prettier-plugin-liquid/src/test/leading-whitespace-inside-block/fixed.liquid で、入力ファイルの整形後の期待値として機能する。
注意点
このコードは Prettier プラグインの仕様定義であり、実運用テーマには含めない。htmlWhitespaceSensitivity: "strict" コメントは Prettier 設定値の備考であり、実際の .prettierrc または package.json での設定と同期を取る必要がある。form タグの前後空白削除は {%- ... -%} の -(ハイフン)フラグの有無と HTML 要素のブロック・インライン性によって複合的に決まるため、独自の空白制御ロジックがある場合は Prettier デフォルト動作と競合する可能性がある。
タグ:prettierliquid-formattingwhitespacetest-casecode-quality

コード

30 行 / liquid
When it doesn't break, it should conditionally omit the leading space

It should omit the leading space if it is stripped anyway
{% form 'cart' -%}space{% endform %}

It should not omit the leading space if there's leading whitespace and the tag
is leading whitespace sensitive
htmlWhitespaceSensitivity: "strict"
{% form 'cart' %} space{% endform %}
{%- form 'cart' %} space{% endform -%}
{% form 'cart' %} space{% endform %}

It should omit the leading space if there's leading whitespace and the tag is
not leading whitespace sensitive
{% form 'cart' %}space{% endform %}
{%- form 'cart' %}space{% endform -%}
{% form 'cart' %}space{% endform %}

It should not omit the whitespace if it is included in a tag that creates an
inline formatting context
htmlWhitespaceSensitivity: "strict"
<p>haha{% form 'cart' %} space{% endform %}</p>

It should omit the whitespace if it is included in a tag that creates a block
formatting context.
<p>
  haha
  {% form 'cart' %}space{% endform %}
</p>

出典・ライセンス

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