📘 公式リファレンス📦 リファレンス/オブジェクト初級

handle オブジェクト

現在表示しているテンプレートに関連するリソース（商品・コレクション・記事など）のハンドルを返す。記事、ブログ、コレクション、ページ、商品テンプレートでのみ利用可能で、その他のテンプレートでは nil を返す。

用途

商品ページで商品ハンドルを取得し、API リクエストのパラメータに使ったり、ページに応じた条件分岐を実装するとき。

設置場所

Liquid テンプレート内で `{{ handle }}` と記述すると、現在のページに対応するリソースのハンドル文字列が展開される。例えば product.liquid で `{{ handle }}` とすれば、その商品のハンドルが出力される。

注意点

article・blog・collection・page・product テンプレート以外では nil が返るため、handle が存在しないテンプレートで参照するときは `{% if handle %}` で事前チェックする。ハンドルは URL スラッグ（英数字とハイフンのみ）であり、日本語スペースや特殊文字は含まれないため、そのまま API パラメータに使用できる。

タグ:handlereferenceglobalresource

仕様

27 行 / json

{
  "access": {
    "global": true,
    "parents": [],
    "template": []
  },
  "deprecated": false,
  "deprecation_reason": "",
  "description": "The `handle` object will return a value only when the following templates are being viewed:\n\n- [article](/themes/architecture/templates/article)\n- [blog](/themes/architecture/templates/blog)\n- [collection](/themes/architecture/templates/collection)\n- [page](/themes/architecture/templates/page)\n- [product](/themes/architecture/templates/product)\n\nIf none of the above templates are being viewed, then `nil` is returned.",
  "properties": [],
  "summary": "The [handle](/docs/api/liquid/basics#handles) of the resource associated with the current template.",
  "name": "handle",
  "examples": [],
  "json_data": {
    "path": "",
    "handle": "",
    "data_from_file": ""
  },
  "return_type": [
    {
      "type": "string",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ]
}

出典・ライセンス

Source:: Shopify/theme-liquid-docs/data/objects.json
Repository:: https://github.com/Shopify/theme-liquid-docs
License:: MIT

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

handle オブジェクト

仕様

出典・ライセンス

関連項目

content_for_header オブジェクト

metaobjects オブジェクト

additional_checkout_buttons オブジェクト

canonical_url オブジェクト

content_for_index オブジェクト

content_for_additional_checkout_buttons オブジェクト