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

render タグのフォーマット規則

Prettier の Liquid プラグイン用テストケース。render タグの記述パターン(スニペット名・エイリアス・変数・引数の組み合わせ)ごとに、自動整形時の改行・スペース・カンマの扱いを定義する。

用途
テーマ構築時に render タグを書くとき、自動フォーマッターがどの条件で改行するか、複数引数の場合のスペースやカンマをどう整形するかを確認したい場合。
設置場所
このコード自体は Prettier プラグインのテストスイート用であり、直接テーマに貼り付けない。代わりに theme.liquid や section ファイル内の render タグが以下のルール通りに自動整形されることを確認する目安として参照する。
注意点
このテストファイルは Prettier 設定(printWidth: 1 等)に基づいた結果を定義するため、実プロジェクトの `.prettierrc` や `settings.json` の printWidth 値が異なると整形結果が変わる。エイリアス(as xxx)を使う場合、変数が指定されなければ改行されず、変数が指定されると改行が入る挙動。トレーリングカンマは Prettier デフォルトで自動削除されるため、手動で入れても整形時に消える。
タグ:render-tagprettiercode-formattingliquid-syntaxtest-case

コード

59 行 / liquid
It should never break a name
printWidth: 1
{% render block %}
{%- render 'snippet' -%}

It should not break aliases if there's no variable (obscure syntax)
printWidth: 1
{% render 'foo/bar' as foo %}

It should not break on variable expression alone
printWidth: 1
{% render 'foo' with foo %}

It should break on variable expression + alias
printWidth: 1
{% render 'foo'
  with foo as bar
%}

It should break on alias + args
printWidth: 1
{% render 'foo/bar' as bar,
  key1: val1,
  key2: (0..1)
%}

It should break on variable + args (after variable)
printWidth: 1
{% render 'foo/bar' with 'string',
  key1: val1,
  key2: (0..1)
%}

It should break on variable + alias + args (before variable)
printWidth: 1
{% render 'foo/bar'
  with 'string' as bar,
  key1: val1,
  key2: (0..1)
%}

It should break on named args
printWidth: 1
{% render 'foo/bar',
  key1: val1,
  key2: (0..1)
%}

It should not require commas (as per syntax) but add them when pretty printed
{% render 'foo/bar', key1: val1, key2: (0..1) %}

It should not require spaces (as per syntax) but add them when pretty printed
{% render 'foo/bar', key1: val1, key2: (0..1) %}

It should strip trailing commas by default
{% render 'foo' %}
{% render 'foo', product: product %}
{% render 'foo' with foo as bar %}

出典・ライセンス

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