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

handleize フィルター（文字列をハンドル形式に変換）

文字列を Shopify ハンドル形式（英小文字・ハイフン区切り）に変換するフィルター。商品名やコレクション名から URL スラッグを生成するときに使う。

用途

商品タイトルを URL フレンドリーなハンドル形式に変換して URL パスを組み立てたり、ユーザー入力をハンドル互換の形式に正規化したいとき。

設置場所

Liquid 内で `{{ product.title | handleize }}` のように、変換したい文字列にパイプで繋いで使う。タグ `handle` でも同じ機能が使える。

注意点

返り値は常に英小文字・ハイフン区切りの文字列になるため、日本語を含む場合は自動的にローマ字化またはハイフンに置換される。ハンドルがすでに存在する商品やコレクションに対しては、Shopify 管理画面で登録されているハンドル値そのものを参照する方が信頼性は高い。

タグ:filterstringhandleurl-slugnormalize

仕様

30 行 / json

{
  "category": "string",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "&gt; Note:\n&gt; The `handleize` filter has an alias of `handle`.",
  "parameters": [],
  "return_type": [
    {
      "type": "string",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/products/health-potion",
      "raw_liquid": "{{ product.title | handleize }}\n{{ product.title | handle }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "summary": "Converts a string into a [handle](/docs/api/liquid/basics#handles).",
  "syntax": "string | handleize",
  "name": "handleize"
}

出典・ライセンス

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

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

handleize フィルター（文字列をハンドル形式に変換）

仕様

出典・ライセンス

関連項目

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

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

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

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

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

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