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

url_param_escape フィルター（URL パラメータ用文字列エスケープ）

文字列に含まれる URL パラメータとして安全でない文字をエスケープするフィルター。url_escape と同じ文字に加え、アンパサンド(&)もエスケープする。

用途

商品名やタグ名などをクエリ文字列のパラメータ値として URL に埋め込むときに使う。特に & を含む文字列が正しく解析されるようにする。

設置場所

Liquid 内で `{{ 変数 | url_param_escape }}` の形で使う。例えば検索クエリを動的に URL に追加する際、`?q={{ search_term | url_param_escape }}` のように記述する。

注意点

url_escape と異なり & もエスケープするため、複数のパラメータを & で連結する場合は各パラメータ値ごとに適用し、& 記号そのものには適用しない。HTML コンテンツのエスケープが目的の場合は url_param_escape ではなく url_escape を使う。

タグ:urlescapefilterquery-stringparameter

仕様

30 行 / json

{
  "category": "string",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "The `url_param_escape` filter escapes the same characters as [`url_escape`](/docs/api/liquid/filters/url_escape), with the\naddition of `&amp;`.",
  "parameters": [],
  "return_type": [
    {
      "type": "string",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/",
      "raw_liquid": "{{ '&lt;p&gt;Health &amp; Love potions&lt;/p&gt;' | url_param_escape }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "summary": "Escapes any characters in a string that are unsafe for URL parameters.",
  "syntax": "string | url_param_escape",
  "name": "url_param_escape"
}

出典・ライセンス

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

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

url_param_escape フィルター（URL パラメータ用文字列エスケープ）

仕様

出典・ライセンス

関連項目

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

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

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

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

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

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