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

Liquid コメント構文のリファレンス

Liquid テンプレート内でコメントを記述する方法を示すリファレンス。複数行コメント、ネストされたコメント、インラインコメントの各形式に対応する。

用途
テーマ開発時にコードの一部を一時的に無効化したり、将来の保守のため内容を記述したりするときに使う。
設置場所
直接ペーストするものではなく、theme.liquid や各セクション・スニペットで `{% comment %} ... {% endcomment %}` または `{% # ... %}` の形で自由に挿入できる。
注意点
複数行コメント内のマークアップ(閉じていない HTML など)は解析されず、Prettier 等のフォーマッターでもインデント調整のみで内容は変わらない。ネストされたコメントは複数の `{% comment %}` ブロック内に同じ構造を持つため、ツールによっては予期しない動作をするケースがあるので、深くネストさせることは避ける。インラインコメント `{% # ... %}` は1行のみ対応している。
タグ:commentliquid-syntaxreferencecode-organization

コード

50 行 / liquid
{% comment %}
  This gets reindented, but we don't parse the content.
  So stuff can be unclosed and it'll be fine.
  <article id="1234">
{% endcomment %}

{% comment %}theme-check-disable foo{% endcomment %}

It should support nested comments
{% comment %}
  ho
  {% comment %}
    hi
  {% endcomment %}
  ha
{% endcomment %}

It should support empty comments
{% comment %}{% endcomment %}

It should support nested empty comments
{% comment %}{% comment %}{% endcomment %}{% endcomment %}

It should support nested empty comments (pt 2)
{% comment %}
  hi
  {% comment %}
  {% endcomment %}
  ho
{% endcomment %}

It should support inline comments
{% # hello world %}

It should maintain paragraphs, but not indentation
{%
  # hello world how are you doing today?
  # this keeps on going
  # and it's looking weird
  # Here's a list of things:
  #  - one
  #  - two
  #  - three

  # Here's a new paragraph
  # oh hi!
  #
  # Here's another one with a # before the paragraph
%}

出典・ライセンス

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