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

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

Liquid テンプレートの Prettier フォーマッタプラグインにおいて、ブロックタグ前後の空白文字をどう扱うかを検証するテストファイル。htmlWhitespaceSensitivity の設定に応じて、leading space(先頭スペース)を保持するか削除するかを制御する。

用途
theme-tools の Prettier Liquid プラグイン開発時に、form タグなどのブロック要素が含まれるテンプレートのフォーマット挙動が仕様通りに動作しているかを確認する。
設置場所
このファイルは Prettier プラグインの自動テストの一部として配置されており、直接テーマに貼り付けるものではない。プラグイン開発の際に test/leading-whitespace-inside-block/ ディレクトリ配下の期待出力と比較される。
注意点
このテストは Prettier フォーマッタの内部ロジック検証用であり、実際のストア運用には直接関係ない。htmlWhitespaceSensitivity の設定値(strict / standard)によって空白の取り扱いが異なるため、プラグイン設定ファイル(.prettierrc)での指定を確認する。form タグの直後の半角スペースがコード品質チェックで削除・保持される動作は、HTML 要素の block / inline 文脈判定に依存する。
タグ:prettierformatterwhitespaceliquid-syntaxtesting

コード

27 行 / 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