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

country_option_tags オブジェクト

ストアの配送設定に含まれる国・地域ごとに `<option>` タグを生成するオブジェクト。各オプションには `data-provinces` 属性で都道府県などの下位地域が JSON 配列として格納される。

用途

チェックアウトページやカスタム住所フォームで、国・地域選択ドロップダウンを実装するとき。選択時に都道府県リストを動的に切り替える UI に対応する。

設置場所

Liquid テンプレート内で `<select>` タグで囲み、`{{ country_option_tags }}` と記述することで HTML の `<option>` タグを出力する。例: `<select name="country">{{ country_option_tags }}</select>`

注意点

country_option_tags は配送設定に登録された国・地域のみを返すため、すべての国を対象にしたい場合は代わりに `all_country_option_tags` を使用する。各オプションの `data-provinces` 属性に下位地域がない国の場合は空配列が設定される。この属性値は JavaScript で JSON.parse() して処理する必要がある。

タグ:countryaddressdropdownshipping-zoneform

仕様

38 行 / json

{
  "access": {
    "global": true,
    "parents": [],
    "template": []
  },
  "deprecated": false,
  "deprecation_reason": "",
  "description": "An attribute called `data-provinces` is set for each `&lt;option&gt;`, and contains a JSON-encoded array of the\ncountry or region's subregions. If a country doesn't have any subregions, then an empty array is set for its\n`data-provinces` attribute.\n\n&gt; Tip:\n&gt; To return all countries and regions included in the store's shipping zones, use [`all_country_option_tags`](/docs/api/liquid/objects/all_country_option_tags).",
  "properties": [],
  "summary": "Creates an `&lt;option&gt;` tag for each country and region that's included in a shipping zone on the [Shipping](https://www.shopify.com/admin/settings/shipping) page of the Shopify admin.",
  "name": "country_option_tags",
  "examples": [
    {
      "name": "",
      "description": "You can wrap the `country_option_tags` object in `&lt;select&gt;` tags to build a country option selector.",
      "syntax": "",
      "path": "/",
      "raw_liquid": "&lt;select name=\"country\"&gt;\n  {{ country_option_tags }}\n&lt;/select&gt;",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "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 によるものです。

country_option_tags オブジェクト

仕様

出典・ライセンス

関連項目

content_for_header オブジェクト

metaobjects オブジェクト

additional_checkout_buttons オブジェクト

canonical_url オブジェクト

content_for_index オブジェクト

content_for_additional_checkout_buttons オブジェクト