📘 公式リファレンス🔧 リファレンス/フィルター初級
weight_with_unit フィルター(バリアント重量を単位付きで整形)
バリアントの重量を、ショップの重量単位設定に基づいて整形された文字列で返すフィルター。管理画面の「一般設定」に設定された単位(kg、lb など)を自動で付加する。
用途
商品詳細ページやカート内で、バリアント重量を「1.5 kg」「3.3 lb」のように整形して表示するとき。配送料金の参考情報として重量を顧客に伝える場合に使う。
設置場所
商品テンプレートや商品カード内で、`{{ variant.weight | weight_with_unit }}` の形で使う。デフォルト単位を上書きしたいときは、`{{ variant.weight | weight_with_unit: variant.weight_unit }}` のように単位パラメータを渡す。
注意点
ショップの一般設定で重量単位が kg か lb のいずれかに設定されていることが前提。バリアント側に weight_unit が明示的に設定されていない場合、管理画面の一般設定に従う。パラメータを省略すると常にストア既定単位で整形されるため、バリアントごとに異なる単位を使う場合は第2引数で variant.weight_unit を明示的に指定する。
仕様
50 行 / json{
"category": "format",
"deprecated": false,
"deprecation_reason": "",
"description": "",
"parameters": [
{
"description": "The weight unit to use in place of the default weight unit.",
"name": "weight_unit",
"positional": true,
"required": false,
"types": [
"string"
]
}
],
"return_type": [
{
"type": "string",
"name": "",
"description": "",
"array_value": ""
}
],
"examples": [
{
"name": "",
"description": "",
"syntax": "",
"path": "/products/blue-mountain-flower",
"raw_liquid": "{%- assign variant = product.variants.first -%}\n\n{{ variant.weight | weight_with_unit }}",
"parameter": false,
"display_type": "text",
"show_data_tab": true
},
{
"name": "Override the default unit",
"description": "You can specify a unit to override the default from the general settings.",
"syntax": "number | weight_with_unit: variable",
"path": "/products/blue-mountain-flower",
"raw_liquid": "{%- assign variant = product.variants.first -%}\n\n{{ variant.weight | weight_with_unit: variant.weight_unit }}",
"parameter": true,
"display_type": "text",
"show_data_tab": true
}
],
"summary": "Generates a formatted weight for a [`variant` object](/docs/api/liquid/objects/variant#variant-weight). The weight unit is\nset in the [general settings](https://www.shopify.com/admin/settings/general) in the Shopify admin.",
"syntax": "number | weight_with_unit",
"name": "weight_with_unit"
}出典・ライセンス
- Repository:
- https://github.com/Shopify/theme-liquid-docs
- 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 行