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

images オブジェクト

ストアにアップロードされたすべての画像にアクセスするグローバルオブジェクト。ファイル名をキーとして画像を取得し、image_url や image_tag フィルターで処理できる。

用途

テーマ共通の装飾画像やロゴ、バナーなど、Shopify 管理画面にアップロードした画像をテンプレート内で参照して表示したいとき。

設置場所

テンプレート内の任意の場所で `{{ images['ファイル名'] }}` でアクセスする。通常は image_url フィルターで URL 取得後、image_tag フィルターで img タグに変換して使う。

注意点

ファイル名の大文字・小文字は区別される。Shopify 管理画面の「ファイル」セクションにアップロードされていない画像は参照できず、nil になるため存在確認が必要。ファイル名にスペースや特殊文字が含まれる場合は管理画面の URL を確認して正確に指定する。

タグ:imagesassetglobalimage-urlimage-tag

仕様

38 行 / json

{
  "access": {
    "global": true,
    "parents": [],
    "template": []
  },
  "deprecated": false,
  "deprecation_reason": "",
  "description": "",
  "properties": [],
  "summary": "All of the [images](/docs/api/liquid/objects/image) that have been [uploaded](https://help.shopify.com/manual/online-store/images/theme-images#upload-images)\nto a store.",
  "name": "images",
  "examples": [
    {
      "name": "",
      "description": "You can access images from the `images` array by their filename.\n",
      "syntax": "",
      "path": "/",
      "raw_liquid": "{{ images['potions-header.png'] | image_url: width: 300 | image_tag }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "json_data": {
    "path": "",
    "handle": "",
    "data_from_file": ""
  },
  "return_type": [
    {
      "type": "array",
      "name": "",
      "description": "",
      "array_value": "image"
    }
  ]
}

出典・ライセンス

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

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

images オブジェクト

仕様

出典・ライセンス

関連項目

content_for_header オブジェクト

metaobjects オブジェクト

additional_checkout_buttons オブジェクト

canonical_url オブジェクト

content_for_index オブジェクト

content_for_additional_checkout_buttons オブジェクト