📘 公式リファレンス🏷️ リファレンス/タグ初級
layout タグ(テンプレートのレイアウトを指定)
テンプレートで使用するレイアウトファイルを指定する。デフォルトは theme.liquid だが、別のレイアウトファイルを選択したり、レイアウトなしで実行できる。
用途
特定のページ(例:ランディングページ、404ページ)で、ヘッダー・フッターなしのフルワイドレイアウトを使いたいとき。
設置場所
各テンプレートファイル(templates/*.liquid)の最上部に `{% layout 'レイアウト名' %}` または `{% layout none %}` の形で記述する。
注意点
layout タグはテンプレートファイルの先頭に記述する必要があり、途中に配置すると無視される。レイアウト名は layouts/ ディレクトリ内のファイル名から .liquid 拡張子を除いた値を指定する(例:layouts/full-width.liquid → 'full-width')。`none` を指定するとレイアウトが適用されず、テンプレート自体の <html> タグから記述する必要がある。
仕様
28 行 / json{
"category": "theme",
"deprecated": false,
"deprecation_reason": "",
"description": "",
"parameters": [],
"summary": "Specify which [layout](/themes/architecture/layouts) to use.",
"name": "layout",
"syntax": "{% layout name %}",
"syntax_keywords": [
{
"keyword": "name",
"description": "The name of the layout file you want to use, wrapped in quotes, or `none` for no layout."
}
],
"examples": [
{
"name": "",
"description": "By default, the `theme.liquid` layout is used. The `layout` tag allows you to specify an alternate layout, or use no layout.\n\n```liquid\n{% layout 'full-width' %}\n{% layout none %}\n```\n",
"syntax": "",
"path": "",
"raw_liquid": "",
"parameter": false,
"display_type": "text",
"show_data_tab": true
}
]
}出典・ライセンス
- Repository:
- https://github.com/Shopify/theme-liquid-docs
- License:
- MIT
このコードは Shopify 著作の MIT ライセンスソースです。 原本の著作権は Shopify が保有します。日本語訳は ALSEL によるものです。
関連項目
📘 公式リファレンス🏷️ リファレンス/タグ中級
doc タグ(テンプレートの注釈・ドキュメント)
Liquid テンプレート内にドキュメンテーションコメントを埋め込むタグ。`{% doc %}` ~ `{% enddoc %}` に囲まれたコンテンツは画面に出力されず、内部の Liquid コードは解析されるが実行されない。コード補完、リンティング、インラインドキュメント機能の実装を支援する。
📁 theme-liquid-docs·MIT·12 行
📘 公式リファレンス🏷️ リファレンス/タグ初級
include タグ(スニペットを埋め込む)
スニペットファイルを Liquid テンプレート内に埋め込んでレンダリングする。埋め込み先の変数にアクセス・変更できるため、親テンプレートと子スニペット間でデータを直接共有する。
📁 theme-liquid-docs·MIT·17 行
📘 公式リファレンス🏷️ リファレンス/タグ中級
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 行