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