tablerow タグ（配列をHTML表に展開）

{
  "category": "iteration",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "The `tablerow` tag must be wrapped in HTML `<table>` and `</table>` tags.\n\n> Tip:\n> Every `tablerow` loop has an associated [`tablerowloop` object](/docs/api/liquid/objects/tablerowloop) with information about the loop.",
  "parameters": [
    {
      "description": "The number of columns that the table should have.",
      "name": "cols",
      "positional": false,
      "required": false,
      "types": [
        "number"
      ]
    },
    {
      "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"
      ]
    }
  ],
  "summary": "Generates HTML table rows for every item in an array.",
  "name": "tablerow",
  "syntax": "{% tablerow variable in array %}\n  expression\n{% endtablerow %}",
  "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."
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/collections/sale-potions",
      "raw_liquid": "<table>\n  {% tablerow product in collection.products %}\n    {{ product.title }}\n  {% endtablerow %}\n</table>",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "cols",
      "description": "You can define how many columns the table should have using the `cols` parameter.",
      "syntax": "{% tablerow variable in array cols: number %}\n  expression\n{% endtablerow %}\n",
      "path": "/collections/sale-potions",
      "raw_liquid": "<table>\n  {% tablerow product in collection.products cols: 2 %}\n    {{ product.title }}\n  {% endtablerow %}\n</table>",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "limit",
      "description": "You can limit the number of iterations using the `limit` parameter.",
      "syntax": "{% tablerow variable in array limit: number %}\n  expression\n{% endtablerow %}\n",
      "path": "/collections/sale-potions",
      "raw_liquid": "<table>\n  {% tablerow product in collection.products limit: 2 %}\n    {{ product.title }}\n  {% endtablerow %}\n</table>",
      "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": "{% tablerow variable in array offset: number %}\n  expression\n{% endtablerow %}\n",
      "path": "/collections/sale-potions",
      "raw_liquid": "<table>\n  {% tablerow product in collection.products offset: 2 %}\n    {{ product.title }}\n  {% endtablerow %}\n</table>",
      "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": "{% tablerow variable in (number..number) %}\n  expression\n{% endtablerow %}\n",
      "path": "/",
      "raw_liquid": "<table>\n  {% tablerow i in (1..3) %}\n    {{ i }}\n  {% endtablerow %}\n</table>\n\n{%- assign lower_limit = 2 -%}\n{%- assign upper_limit = 4 -%}\n\n<table>\n  {% tablerow i in (lower_limit..upper_limit) %}\n    {{ i }}\n  {% endtablerow %}\n</table>",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    }
  ]
}