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

default フィルター(空値をデフォルト値に置き換え)

変数が空、false、nil のいずれかの場合に、指定したデフォルト値に置き換えるフィルター。チェーン可能で、最初に当てはまる値を使用する。

用途
選択されたバリアントが存在しない場合は通常商品ページへ、在庫表示設定がない場合はデフォルトテキストを出す、など不完全なデータの穴埋めに使用。
設置場所
Liquid テンプレート内で `{{ product.selected_variant.url | default: product.url }}` のように、パイプ記号で続けてフィルターを適用する。複数のデフォルト値をチェーンする場合は `{{ variable | default: value1 | default: value2 }}` と繋ぎ続ける。
注意点
デフォルトでは `false` 値も置き換え対象になるため、意図的に false を返したい場合は `allow_false: true` パラメータを追加する。空文字列(empty string)は false 扱いで置き換わるため、空文字を許容する場合も `allow_false: true` で対応が必要。
タグ:defaultvariablenilfalseempty

仕様

50 行 / json
{
  "category": "default",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "",
  "parameters": [
    {
      "description": "Whether to use false values instead of the default.",
      "name": "allow_false",
      "positional": false,
      "required": false,
      "types": [
        "boolean"
      ]
    }
  ],
  "return_type": [
    {
      "type": "untyped",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/products/health-potion",
      "raw_liquid": "{{ product.selected_variant.url | default: product.url }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "allow_false",
      "description": "By default, the  `default` filter's value will be used in place of `false` values. You can use the `allow_false` parameter to allow variables to return `false` instead of the default value.\n",
      "syntax": "variable | default: variable, allow_false: boolean",
      "path": "/products/health-potion",
      "raw_liquid": "{%- assign display_price = false -%}\n\n{{ display_price | default: true, allow_false: true }}",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "summary": "Sets a default value for any variable whose value is one of the following:\n\n- [`empty`](/docs/api/liquid/basics#empty)\n- [`false`](/docs/api/liquid/basics#truthy-and-falsy)\n- [`nil`](/docs/api/liquid/basics#nil)",
  "syntax": "variable | default: variable",
  "name": "default"
}

出典・ライセンス

License:
MIT

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

関連項目

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

avatar フィルター(顧客アバター画像HTML生成)

顧客アバターが存在する場合、それを表示する HTML タグを生成するフィルター。customer オブジェクトに対して使用する。

📁 theme-liquid-docs·MIT·19
📘 公式リファレンス🔧 リファレンス/フィルター初級

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

form.errors の各エラーコードに対応する既定のエラーメッセージを自動生成するフィルター。フォーム送信時の入力値不正や必須項目空白などのエラーを言語別に出力する。

📁 theme-liquid-docs·MIT·19
📘 公式リファレンス🔧 リファレンス/フィルター初級

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

日付値を指定されたフォーマット文字列に従って整形する。フォーマット文字列が空の場合は元の値がそのまま返される。入力が日付に変換できない場合も元の値が返される。

📁 theme-liquid-docs·MIT·19
📘 公式リファレンス🔧 リファレンス/フィルター初級

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

product フォームまたは cart フォームに対して使用し、Shop Pay の分割払いオプションを表示するための HTML を生成するフィルター。顧客が購入時に分割払いプランを選択できるようにする。

📁 theme-liquid-docs·MIT·19
📘 公式リファレンス🔧 リファレンス/フィルター初級

abs フィルター(数値の絶対値を取得)

負の数を正の数に変換する。数値の絶対値(ゼロからの距離)を返すフィルター。

📁 theme-liquid-docs·MIT·30
📘 公式リファレンス🔧 リファレンス/フィルター初級

append フィルター(文字列の末尾に追加)

文字列の末尾に別の文字列を連結するフィルター。URL パスの結合やテキストの接尾辞追加に使う。

📁 theme-liquid-docs·MIT·30