Liquid Snippets by ALSEL
📘 公式リファレンス🏷️ リファレンス/タグ初級

include タグ(スニペットを埋め込む)

スニペットファイルを Liquid テンプレート内に埋め込んでレンダリングする。埋め込み先の変数にアクセス・変更できるため、親テンプレートと子スニペット間でデータを直接共有する。

用途
ヘッダー・フッター・商品カードなど共通パーツをスニペットとして分離し、複数ページから呼び出すときに使う。
設置場所
任意のテンプレートやセクション内で `{% include 'filename' %}` の形で記述し、スニペット名を指定して埋め込む。
注意点
include タグは廃止予定(deprecated)であり、`render` タグへの移行が推奨される。include は親テンプレートの変数スコープを直接共有するため、スニペット内での変数変更が呼び出し元に影響し、複雑な依存関係が発生しやすく可読性が低下する。新規実装では `render` を使い、スニペット間のデータ受け渡しを明示的に引数化するとよい。
タグ:includesnippetdeprecatedrenderembed

仕様

17 行 / json
{
  "category": "theme",
  "deprecated": true,
  "deprecation_reason": "Deprecated because the way that variables are handled reduces performance and makes code harder to both read and maintain.\n\nThe `include` tag has been replaced by [`render`](/docs/api/liquid/tags/render).",
  "description": "Inside the snippet, you can access and alter variables that are [created](/docs/api/liquid/tags/variable-tags) outside of the\nsnippet.",
  "parameters": [],
  "summary": "Renders a [snippet](/themes/architecture/snippets).",
  "name": "include",
  "syntax": "{% include 'filename' %}",
  "syntax_keywords": [
    {
      "keyword": "filename",
      "description": "The name of the snippet to render, without the `.liquid` extension."
    }
  ],
  "examples": []
}

出典・ライセンス

License:
MIT

このコードは Shopify 著作の MIT ライセンスソースです。 原本の著作権は Shopify が保有します。日本語訳は ALSEL によるものです。

関連項目

📘 公式リファレンス🏷️ リファレンス/タグ中級

doc タグ(テンプレートの注釈・ドキュメント)

Liquid テンプレート内にドキュメンテーションコメントを埋め込むタグ。`{% doc %}` ~ `{% enddoc %}` に囲まれたコンテンツは画面に出力されず、内部の Liquid コードは解析されるが実行されない。コード補完、リンティング、インラインドキュメント機能の実装を支援する。

📁 theme-liquid-docs·MIT·12
📘 公式リファレンス🏷️ リファレンス/タグ中級

javascript タグ(セクション・ブロック内のコード)

セクション、ブロック、スニペット内に JavaScript コードを記述するタグ。このタグ内に書いた JavaScript は Shopify のテーマビルドシステムにより自動的に読み込まれて実行される。

📁 theme-liquid-docs·MIT·17
📘 公式リファレンス🏷️ リファレンス/タグ初級

sections タグ(セクショングループを描画)

セクショングループをテーマのレイアウト内で描画するタグ。レイアウトファイル内に配置して、複数のセクションをグループ化した内容を出力する。

📁 theme-liquid-docs·MIT·17
📘 公式リファレンス🏷️ リファレンス/タグ初級

stylesheet タグ(CSS定義)

セクション、ブロック、スニペット内で CSS スタイルを定義するタグ。各ファイルにつき1つだけ記述でき、定義した CSS はそのコンポーネント固有の外側スコープで読み込まれて実行される。

📁 theme-liquid-docs·MIT·17
📘 公式リファレンス🏷️ リファレンス/タグ初級

break タグ(ループの中断)

for ループの反復処理を途中で停止するタグ。指定した条件に達したら以降の反復をスキップして、ループを抜ける。

📁 theme-liquid-docs·MIT·23
📘 公式リファレンス🏷️ リファレンス/タグ初級

continue タグ(ループをスキップ)

for ループ内で現在の反復をスキップし、次のイテレーションに進ませる。条件分岐で特定の要素の処理を除外するときに使う。

📁 theme-liquid-docs·MIT·23