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

localization オブジェクト

ストアで利用可能な国・言語、および現在選択されている市場・国・言語の情報を取得するオブジェクト。Shopify Markets や多言語対応を実装する際に使用する。

用途

ストアの言語切り替えフォームやローカライゼーションセクションで、利用可能な言語・国の一覧を動的に表示したり、ユーザーが現在選択している市場や言語を判定したいとき。

設置場所

Liquid テンプレート内で `{{ localization.available_countries }}`、`{{ localization.available_languages }}`、`{{ localization.market }}`、`{{ localization.country }}`、`{{ localization.language }}` の形でプロパティを参照する。通常は localization form タグ内または言語切り替えセクションで使用する。

注意点

localization オブジェクトは Shopify Markets が有効化されている場合に機能する。available_countries、available_languages はそれぞれ country、shop_locale オブジェクトの配列を返すため、ループで各国・言語の詳細情報（名前、コードなど）にアクセスする必要がある。市場未設定のストアでは market、country の値が空になる可能性があるため、テンプレートで `if localization.market` で存在チェックを行う。

タグ:localizationmarketmulti-languagecountryi18n

仕様

101 行 / json

{
  "access": {
    "global": true,
    "parents": [],
    "template": []
  },
  "deprecated": false,
  "deprecation_reason": "",
  "description": "The `localization` object can be used in a [localization form](/docs/api/liquid/tags/form#form-localization).\n\nTo learn about how to offer localization options in your theme, refer to [Support multiple currencies and languages](/themes/internationalization/multiple-currencies-languages).",
  "properties": [
    {
      "deprecated": false,
      "deprecation_reason": "",
      "description": "",
      "examples": [],
      "return_type": [
        {
          "type": "array",
          "name": "",
          "description": "",
          "array_value": "country"
        }
      ],
      "summary": "The countries that are available on the store.",
      "name": "available_countries"
    },
    {
      "deprecated": false,
      "deprecation_reason": "",
      "description": "",
      "examples": [],
      "return_type": [
        {
          "type": "array",
          "name": "",
          "description": "",
          "array_value": "shop_locale"
        }
      ],
      "summary": "The languages that are available on the store.",
      "name": "available_languages"
    },
    {
      "deprecated": false,
      "deprecation_reason": "",
      "description": "",
      "examples": [],
      "return_type": [
        {
          "type": "market",
          "name": "",
          "description": "",
          "array_value": ""
        }
      ],
      "summary": "The currently selected market on the storefront.",
      "name": "market"
    },
    {
      "deprecated": false,
      "deprecation_reason": "",
      "description": "",
      "examples": [],
      "return_type": [
        {
          "type": "country",
          "name": "",
          "description": "",
          "array_value": ""
        }
      ],
      "summary": "The currently selected country on the storefront.",
      "name": "country"
    },
    {
      "deprecated": false,
      "deprecation_reason": "",
      "description": "",
      "examples": [],
      "return_type": [
        {
          "type": "shop_locale",
          "name": "",
          "description": "",
          "array_value": ""
        }
      ],
      "summary": "The currently selected language on the storefront.",
      "name": "language"
    }
  ],
  "summary": "Information about the countries and languages that are available on a store.",
  "name": "localization",
  "examples": [],
  "json_data": {
    "path": "/",
    "handle": "localization",
    "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 によるものです。

localization オブジェクト

仕様

出典・ライセンス

関連項目

content_for_header オブジェクト

metaobjects オブジェクト

additional_checkout_buttons オブジェクト

canonical_url オブジェクト

content_for_index オブジェクト

content_for_additional_checkout_buttons オブジェクト