📘 公式リファレンス🔧 リファレンス/フィルター初級

format_address フィルター（住所を地域形式で整形）

住所オブジェクトを HTML 形式に整形し、各要素を地域ごとの標準順序で並べたテキストを返す。日本なら郵便番号→都道府県→市区町村の順、US なら州→市→郵便番号という具合に自動調整される。

用途

ストア所在地や顧客の配送先住所をフッターや注文確認ページに表示するとき、国の住所フォーマット規則に自動で従わせたい場合に使う。

設置場所

Liquid テンプレート内で `{{ shop.address | format_address }}` や `{{ customer.default_address | format_address }}` の形で使う。footer セクションや order confirmation ページなど、住所表示が必要な箇所に配置する。

注意点

入力値は address オブジェクト（shop.address、customer.default_address など）である必要があり、単なる文字列には使えない。出力は HTML マークアップ（改行に `<br>` タグを含む）なので、そのままテンプレート内に出力するか、必要に応じて `| strip_html` で除去する。複数国での販売時は各国の住所フォーマットが自動判別されるため、手動での順序調整は不要。

タグ:filteraddresslocalizationshopcustomer

仕様

40 行 / json

{
  "category": "localization",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "",
  "parameters": [],
  "return_type": [
    {
      "type": "string",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/",
      "raw_liquid": "{{ shop.address | format_address }}",
      "parameter": false,
      "display_type": "html",
      "show_data_tab": false
    },
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/",
      "raw_liquid": "{{ customer.default_address | format_address }}",
      "parameter": false,
      "display_type": "html",
      "show_data_tab": false
    }
  ],
  "summary": "Generates an HTML address display, with each address component ordered according to the address's locale.",
  "syntax": "address | format_address",
  "name": "format_address"
}

出典・ライセンス

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

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

format_address フィルター（住所を地域形式で整形）

仕様

出典・ライセンス

関連項目

avatar フィルター（顧客アバター画像HTML生成）

default_errors フィルター（フォーム送信エラーを日本語化）

date フィルター（日付を指定形式でフォーマット）

payment_terms フィルター（Shop Pay分割払いバナーを生成）

abs フィルター（数値の絶対値を取得）

append フィルター（文字列の末尾に追加）