Recorrer elementos secundarios en Twig como Element :: children ()

Al tratar con una matriz renderizable en PHP, puedo usar Element :: children () para acceder a los elementos que no son #propiedades sino elementos renderizables subordinados (elementos de formulario dentro de un conjunto de campos, elementos dentro de un widget de campo, etc.). Por ejemplo, este fragmento de file.module:

<?php
if ($element['#multiple']) {
  foreach (Element::children($element) as $name) {
    // ...
  }
}
?>

¿Cómo puedo hacer lo mismo en una plantilla Twig? Si lo hago {% for child in element %}, incluirá también #type, #cacheetc.

{% for key, child in element if key|first != '#' %}
  <div>{{ child }}</div>
{% endfor %}

He creado un filtro Twig que vuelve con los hijos como un ArrayIterator.

mymodule/mymodule.services.yml

services:
  mymodule.twig_extension:
    arguments: ['@renderer']
    class: Drupal\mymodule\TwigExtension\Children
    tags:
      - { name: twig.extension }

mymodule/src/TwigExtension/Children.php

<?php

namespace Drupal\mymodule\TwigExtension;


class Children extends \Twig_Extension
{

  /**
   * Generates a list of all Twig filters that this extension defines.
   */
  public function getFilters()
  {
    return [
      new \Twig_SimpleFilter('children', array($this, 'children')),
    ];
  }


  /**
   * Gets a unique identifier for this Twig extension.
   */
  public function getName()
  {
    return 'mymodule.twig_extension';
  }


  /**
   * Get the children of a field (FieldItemList)
   */
  public static function Children($variable)
  {
    if (!empty($variable['#items'])
      && $variable['#items']->count() > 0
    ) {
      return $variable['#items']->getIterator();
    }

    return null;
  }

}

en la plantilla Twig:

{% for headline in entity.field_headline|children %}
  {{ headline.get('value').getValue() }}
{% endfor %}

Utilice el módulo Twig Tweak , que, entre otras características maravillosas, tiene un filtro "secundario":

{% for item in content.field_name | children(true) %}
  {# loop.length, loop.revindex, loop.revindex0, and loop.last are now available #}
{% endfor %}

Aquí hay una modificación de /drupal//a/236408/67965 que recorre los elementos secundarios de representación en lugar del campo #items.

La extensión de la ramita:

/**
 * Generates a list of all Twig filters that this extension defines.
 */
public function getFilters() {
  return [
    new \Twig_SimpleFilter('children', array($this, 'children')),
  ];
}

/**
 * Get the render children of a field
 */
public static function children($variable) {
  return array_filter(
    $variable, 
    function($k) { return (is_numeric($k) || (strpos($k, '#') !== 0)); },
    ARRAY_FILTER_USE_KEY
  );
}

En Twig, puede pasar directamente a los niños renderizados, lo que ayuda en los patrones de diseño atómico. Defina una plantilla de entidad, por ejemplo:

{% include '@molecules/grid.html.twig' with { 
   head : content.field_title,
   grid_columns: content.field_collection_items|children
} %}

donde grid.html.twig es algo así como:

{% if head %}
<div class="slab__wrapper">
  {{ head }}
</div>
{% endif %}
<div class="grid">          
  {% for col in grid_columns %}
  <div class="grid__column">
    {{ col }}
  </div>
  {% endfor %}
</div>

Esto suele ser más útil que tener que representar una plantilla de campo {{ content.field_collection_items }}porque el diseño de los elementos secundarios puede controlarse en el contexto del elemento de diseño principal.