www.aleph1.co.uk Git - yaffs-website/blob - vendor/twig/twig/doc/filters/batch.rst

   1 ``batch``
   2 =========
   3
   4 .. versionadded:: 1.12.3
   5     The ``batch`` filter was added in Twig 1.12.3.
   6
   7 The ``batch`` filter "batches" items by returning a list of lists with the
   8 given number of items. A second parameter can be provided and used to fill in
   9 missing items:
  10
  11 .. code-block:: jinja
  12
  13     {% set items = ['a', 'b', 'c', 'd', 'e', 'f', 'g'] %}
  14
  15     <table>
  16     {% for row in items|batch(3, 'No item') %}
  17         <tr>
  18             {% for column in row %}
  19                 <td>{{ column }}</td>
  20             {% endfor %}
  21         </tr>
  22     {% endfor %}
  23     </table>
  24
  25 The above example will be rendered as:
  26
  27 .. code-block:: jinja
  28
  29     <table>
  30         <tr>
  31             <td>a</td>
  32             <td>b</td>
  33             <td>c</td>
  34         </tr>
  35         <tr>
  36             <td>d</td>
  37             <td>e</td>
  38             <td>f</td>
  39         </tr>
  40         <tr>
  41             <td>g</td>
  42             <td>No item</td>
  43             <td>No item</td>
  44         </tr>
  45     </table>
  46
  47 Arguments
  48 ---------
  49
  50 * ``size``: The size of the batch; fractional numbers will be rounded up
  51 * ``fill``: Used to fill in missing items