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

measurement オブジェクト

メタフィールドの measurement 型から取得した、寸法・体積・重量の単位付き数値を扱うオブジェクト。type、value、unit の3つのプロパティで構成される。

用途

商品の外装サイズ（縦×横×高さ）、容器容量、パッケージ重量などを管理画面のメタフィールドで登録し、商品詳細ページやカート内に単位付きで表示するとき。

設置場所

商品詳細テンプレート（product.liquid）内で `{{ product.metafields.namespace.key.value.type }}`、`{{ product.metafields.namespace.key.value.value }}`、`{{ product.metafields.namespace.key.value.unit }}` の形で参照し、測定値・単位を出力する。

注意点

measurement オブジェクトは metafield の value プロパティ配下でのみアクセス可能であり、メタフィールドが dimension、volume、weight のいずれかの型で定義されていることが前提。type には「dimension」「volume」「weight」いずれかの文字列が入るため、表示時に日本語ラベルに変換する場合はフィルター処理を別途追加する。

タグ:metafieldmeasurementproductdimensionvolumeweight

仕様

86 行 / json

{
  "access": {
    "global": false,
    "parents": [
      {
        "object": "metafield",
        "property": "value"
      }
    ],
    "template": []
  },
  "deprecated": false,
  "deprecation_reason": "",
  "description": "&gt; Tip:\n&gt; To learn about metafield types, refer to [Metafield types](/apps/metafields/types).",
  "properties": [
    {
      "deprecated": false,
      "deprecation_reason": "",
      "description": "",
      "examples": [],
      "return_type": [
        {
          "type": "string",
          "name": "dimension",
          "description": "",
          "array_value": ""
        },
        {
          "type": "string",
          "name": "volume",
          "description": "",
          "array_value": ""
        },
        {
          "type": "string",
          "name": "weight",
          "description": "",
          "array_value": ""
        }
      ],
      "summary": "The measurement type.",
      "name": "type"
    },
    {
      "deprecated": false,
      "deprecation_reason": "",
      "description": "",
      "examples": [],
      "return_type": [
        {
          "type": "number",
          "name": "",
          "description": "",
          "array_value": ""
        }
      ],
      "summary": "The measurement value.",
      "name": "value"
    },
    {
      "deprecated": false,
      "deprecation_reason": "",
      "description": "",
      "examples": [],
      "return_type": [
        {
          "type": "string",
          "name": "",
          "description": "",
          "array_value": ""
        }
      ],
      "summary": "The measurement unit.",
      "name": "unit"
    }
  ],
  "summary": "A measurement from one of the following metafield types:\n\n- `dimension`\n- `volume`\n- `weight`",
  "name": "measurement",
  "examples": [],
  "json_data": {
    "path": "/products/dandelion-milk",
    "handle": "product.metafields.details.milk_container_volume.value",
    "data_from_file": ""
  },
  "return_type": []
}

出典・ライセンス

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

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

measurement オブジェクト

仕様

出典・ライセンス

関連項目

content_for_header オブジェクト

metaobjects オブジェクト

additional_checkout_buttons オブジェクト

canonical_url オブジェクト

content_for_index オブジェクト

content_for_additional_checkout_buttons オブジェクト