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

item_count_for_variant フィルター（カート内の特定バリアント数）

カートオブジェクト内で、指定したバリアント ID の合計数量を取得するフィルター。同じバリアントが複数行に分かれていても、その合計値を返す。

用途

カートドロワーやカート確認画面で、特定の商品バリアント（色・サイズ違い）がカート内に何個入っているか判定し、在庫警告やまとめ買い提案の表示を分岐させるとき。

設置場所

cart オブジェクトに対して `{{ cart | item_count_for_variant: バリアント_ID }}` の形で Liquid テンプレート内に記述。バリアント ID はハードコードするか、ループ内の `variant.id` 変数から取得する。

注意点

バリアント ID は数値であり、カート内に存在しないバリアント ID を指定すると 0 を返す。複数バリアントの数量を足し合わせたい場合はループを使って個別に呼び出し、結果を加算する必要がある。

タグ:cartvariantquantityfilter

仕様

30 行 / json

{
  "category": "cart",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "",
  "parameters": [],
  "return_type": [
    {
      "type": "number",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/cart",
      "raw_liquid": "{{ cart | item_count_for_variant: 39888235757633 }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "summary": "Returns the total item count for a specified variant in the [`cart`](https://shopify.dev/docs/api/liquid/objects/cart) object.",
  "syntax": "cart | item_count_for_variant: {variant_id}",
  "name": "item_count_for_variant"
}

出典・ライセンス

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

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

item_count_for_variant フィルター（カート内の特定バリアント数）

仕様

出典・ライセンス

関連項目

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

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

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

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

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

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