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

sum フィルター（配列の合計値を計算）

配列内のすべての要素の合計値を数値で返すフィルター。配列内のオブジェクトの特定プロパティを指定して合計することも可能。

用途

カートの全商品数量や小計金額の合計を表示するとき、または複数の商品の金額を合算するときに使う。

設置場所

Liquid テンプレート内で `{{ array | sum }}` の形で使う。オブジェクト配列の場合は `{{ array | sum: 'プロパティ名' }}` で対象プロパティを指定する。

注意点

配列要素が数値でない場合は 0 として扱われる。オブジェクト配列を扱う場合はプロパティ名を文字列で指定する必要があり、存在しないプロパティを指定すると 0 として計算される。金額を合計する場合は結果を `| money` フィルターで通貨形式に整形する。

タグ:arraysumnumbercartcalculation

仕様

40 行 / json

{
  "category": "array",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "",
  "parameters": [],
  "return_type": [
    {
      "type": "number",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/",
      "raw_liquid": "{% assign fibonacci = '0, 1, 1, 2, 3, 5' | split: ', ' %}\n\n{{ fibonacci | sum }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "Sum object property values",
      "description": "For an array of Liquid objects, you can specify a property to sum.",
      "syntax": "array | sum: string",
      "path": "/cart",
      "raw_liquid": "Total quantity of all items in cart:\n{{ cart.items | sum: 'quantity' }}\n\nSubtotal price for all items in cart:\n{{ cart.items | sum: 'final_line_price' | money }}",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "summary": "Returns the sum of all elements in an array.",
  "syntax": "array | sum",
  "name": "sum"
}

出典・ライセンス

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

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

sum フィルター（配列の合計値を計算）

仕様

出典・ライセンス

関連項目

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

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

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

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

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

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