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

Prettier Liquid プラグイン・自己クローズタグのフォーマット仕様

Prettier Liquid プラグインにおいて、自己クローズタグ（`<self-closing />`）のフォーマット動作を検証するテストケース集。printWidth や htmlWhitespaceSensitivity の設定に応じた改行・インデント処理の期待値を定義している。

用途
Liquid テンプレートの自動整形ツール開発時に、自己クローズタグの折り返しルールが正しく機能しているか確認する。親タグとの空白処理やホワイトスペース感度の設定による出力差を検証する際に参照。
設置場所
このファイルは Prettier Liquid プラグインのテストスイート用であり、実装プロジェクトでは直接貼り付けない。代わりに Prettier の設定ファイル（`.prettierrc`）で `printWidth` や `htmlWhitespaceSensitivity` を指定し、テンプレート内の自己クローズタグ整形動作を確認する際の参照資料として活用する。
注意点
このファイルはテスト用の仕様定義であり、実行可能な Liquid コードではない。実際のテンプレートで自己クローズタグを使う場合、Shopify 管理画面が対応しているカスタム HTML 要素や SVG 内の `<use />` など、実際に自己クローズで解釈される要素に限定する。printWidth が短く設定されていると、属性数が多いタグが複数行に折り返されるため、Prettier 設定とテンプレート内容の整合性を確認してから本番リリースする。
タグ:prettierliquidformatterhtmltesting

コード

39 行 / liquid
It should format self closing tags as expected
printWidth: 40
<self-closing />
<self-closing />
<self-closing with="attributes" />
<self-closing
  with="attributes"
  that="would"
  span="on"
  multiple
  lines
/>

It should borrow parent and close tag parameters
<span
  ><sc src="aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
/></span>

It should not borrow parent and close tag parameters when htmlWhitespaceSensitivity is set to ignore
htmlWhitespaceSensitivity: "ignore"
<span>
  <sc src="aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" />
</span>

It should borrow prev and next tag parameters
<span
  ><sc
  /><sc src="aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  /><sc
/></span>

It should not borrow prev and next tag parameters when htmlWhitespaceSensitivity is set to ignore
htmlWhitespaceSensitivity: "ignore"
<span>
  <sc />
  <sc src="aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" />
  <sc />
</span>

出典・ライセンス

Source:
Shopify/theme-tools/packages/prettier-plugin-liquid/src/test/html-self-closing-element/fixed.liquid
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 行