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

Liquid タグの改行と空白トリム判定

Prettier Liquid プラグインが Liquid タグの改行時に空白トリム文字を挿入する判定ロジックをテストするコード。タグが改行で分割される際、前後の空白が preserve されるか trimmed されるかを検証する。

用途
Liquid テンプレートの自動フォーマッタを開発・デバッグするときに、改行による空白処理が正しく動作するかを確認するテストケース集として使用する。
設置場所
Prettier または同等のテンプレートフォーマッタのテストスイート内に配置。`packages/prettier-plugin-liquid/src/test/` ディレクトリ配下のテストランナーで各ケースを実行する。
注意点
このコードはテスト用途のみで、本番テーマには貼り付けない。空白トリムの挙動は Liquid エンジンのバージョンや前処理の有無により変わるため、フォーマッタ側の設定と theme.liquid の render / include タグの呼び出し方を統一する必要がある。改行が増えると HTML ファイルサイズが増加するため、本番環境では minify オプションを有効にしてから納品する。
タグ:whitespaceliquid-tagformattingprettiertest-case

コード

25 行 / liquid
it should not add Whitespace Trim Characters (WTC) if the liquid tag does not
break on a new line
<div>{% echo 'hello' %}</div>

it should not add wtc if the liquid tag breaks on a new line, is not leading
space sensitive and there was no leading space.
<div>{% echo 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' %}</div>

it should add wtc if the liquid tag breaks on a new line and is leading space
sensitive
<span>{% echo 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' %}</span>

it should not add wtc if the liquid tag breaks on a new line and the
previous/next characters were spaces
<div> {% echo 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' %} </div>

it should break next to a character, so there should be wtc
<div>
  Hey {% echo 'aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' %}, how are you doing?
</div>

it should add wtc when it adds hardlines in places there wasn't whitespace before
<span>{% render 'icon-error' %}{{ 'blogs.article.email' | t }} {{ form.errors.messages['email'] }}.</span>

出典・ライセンス

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