for タグ（配列をループ処理）

{
  "category": "iteration",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "You can do a maximum of 50 iterations with a `for` loop. If you need to iterate over more than 50 items, then use the\n[`paginate` tag](/docs/api/liquid/tags/paginate) to split the items over multiple pages.\n\n> Tip:\n> Every `for` loop has an associated [`forloop` object](/docs/api/liquid/objects/forloop) with information about the loop.",
  "parameters": [
    {
      "description": "The number of iterations to perform.",
      "name": "limit",
      "positional": false,
      "required": false,
      "types": [
        "number"
      ]
    },
    {
      "description": "The 1-based index to start iterating at.",
      "name": "offset",
      "positional": false,
      "required": false,
      "types": [
        "number"
      ]
    },
    {
      "description": "A custom numeric range to iterate over.",
      "name": "range",
      "positional": true,
      "required": false,
      "types": [
        "untyped"
      ]
    },
    {
      "description": "Iterate in reverse order.",
      "name": "reversed",
      "positional": true,
      "required": false,
      "types": [
        "untyped"
      ]
    }
  ],
  "summary": "Renders an expression for every item in an array.",
  "name": "for",
  "syntax": "{% for variable in array %}\n  expression\n{% endfor %}",
  "syntax_keywords": [
    {
      "keyword": "variable",
      "description": "The current item in the array."
    },
    {
      "keyword": "array",
      "description": "The array to iterate over."
    },
    {
      "keyword": "expression",
      "description": "The expression to render for each iteration."
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/collections/sale-potions",
      "raw_liquid": "{% for product in collection.products -%}\n  {{ product.title }}\n{%- endfor %}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "limit",
      "description": "You can limit the number of iterations using the `limit`\nparameter.\n\n> Tip:\n> Limit the amount of data fetched for arrays that can be paginated with the `paginate` tag instead of using the `limit` parameter. Learn more about [limiting data fetching](/docs/api/liquid/tags/paginate#paginate-limit-data-fetching) for improved server-side performance.\n",
      "syntax": "{% for variable in array limit: number %}\n  expression\n{% endfor %}\n",
      "path": "/collections/sale-potions",
      "raw_liquid": "{% for product in collection.products limit: 2 -%}\n  {{ product.title }}\n{%- endfor %}",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "offset",
      "description": "You can specify a 1-based index to start iterating at using the `offset` parameter.",
      "syntax": "{% for variable in array offset: number %}\n  expression\n{% endfor %}\n",
      "path": "/collections/sale-potions",
      "raw_liquid": "{% for product in collection.products offset: 2 -%}\n  {{ product.title }}\n{%- endfor %}",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "range",
      "description": "Instead of iterating over specific items in an array, you can specify a numeric range to iterate over.\n\n> Note:\n> You can define the range using both literal and variable values.\n",
      "syntax": "{% for variable in (number..number) %}\n  expression\n{% endfor %}\n",
      "path": "/collections/all",
      "raw_liquid": "{% for i in (1..3) -%}\n  {{ i }}\n{%- endfor %}\n\n{%- assign lower_limit = 2 -%}\n{%- assign upper_limit = 4 -%}\n\n{% for i in (lower_limit..upper_limit) -%}\n  {{ i }}\n{%- endfor %}",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "reversed",
      "description": "You can iterate in reverse order using the `reversed` parameter.",
      "syntax": "{% for variable in array reversed %}\n  expression\n{% endfor %}\n",
      "path": "/collections/sale-potions",
      "raw_liquid": "{% for product in collection.products reversed -%}\n  {{ product.title }}\n{%- endfor %}",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    }
  ]
}