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

escape_once フィルター（二重エスケープ防止）

文字列内の HTML 特殊文字（<、>、&、ダブルクォートなど）をエスケープするが、既にエスケープ済みの文字（& など）は重ねてエスケープしない。

用途

ユーザー入力やメタフィールド、外部データソースから混在したエスケープ済み・未エスケープ文字を受け取るとき、二重エスケープを防ぎながら安全に HTML に出力する。

設置場所

Liquid テンプレート内で `{{ text | escape_once }}` の形で使用。メタフィールドの説明欄や HTML コンテンツが混在しやすいフィールドに適用する。

注意点

`escape` フィルターと異なり、既にエスケープされた文字（& → &amp; にならない）をそのまま保持するため、部分的にエスケープ済みの文字列の処理に向いている。ただし信頼できるソース以外では使わないこと。完全に未エスケープな入力には `escape` を使う。

タグ:escapehtmlstringsecurity

仕様

30 行 / json

{
  "category": "string",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "",
  "parameters": [],
  "return_type": [
    {
      "type": "string",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/",
      "raw_liquid": "# applying the escape filter to already escaped text escapes characters in HTML entities:\n\n{{ \"&amp;lt;p&amp;gt;Text to be escaped.&amp;lt;/p&amp;gt;\" | escape }}\n\n# applying the escape_once filter to already escaped text skips characters in HTML entities:\n\n{{ \"&amp;lt;p&amp;gt;Text to be escaped.&amp;lt;/p&amp;gt;\" | escape_once }}\n\n# use escape_once to escape strings where a combination of HTML entities and non-escaped characters might be present:\n\n{{ \"&amp;lt;p&amp;gt;Text to be escaped.&amp;lt;/p&amp;gt; &amp; some additional text\" | escape_once }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "summary": "Escapes a string without changing characters that have already been escaped.",
  "syntax": "string | escape_once",
  "name": "escape_once"
}

出典・ライセンス

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

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

escape_once フィルター（二重エスケープ防止）

仕様

出典・ライセンス

関連項目

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

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

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

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

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

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