Répète des instances vivantes : pour chaque ligne d'une source, le <template> enfant est cloné et ses placeholders résolus — texte, attributs, et donc les composants dsfr-data-* qu'il contient. Un graphique par question, un KPI par service.

Attributs

Variables du gabarit

• {{$index}} — rang de la ligne (0-based) ;
• {{$key}} — valeur de key-field (ou le rang) ;
• {{$uid}} — identifiant DOM unique dérivé de la clé, sûr pour id= et aria-labelledby, distinct d'un répéteur à l'autre ;
• {{$scope.alias}} — l'id scopé de la ligne pour l'entrée alias de scopes ; {{$scope}} quand une seule entrée est déclarée.

Ce que repeat promet

• L'identité par clé. À une nouvelle émission de la source, une ligne dont la clé (key-field) subsiste garde ses nœuds : les instances ne sont ni déconnectées ni recréées, leurs attributs sont mis à jour en place ; les clés disparues sont retirées, les nouvelles insérées à leur rang, l'ordre du DOM suit les données. Mesuré : 119 graphiques ré-émis en ~110 ms sans un canvas détruit (contre ~4,7 s de recréation totale avec display).
• L'imbrication. Un <template> intérieur n'est pas parcouru : un dsfr-data-display ou un second dsfr-data-repeat dans le gabarit rend ses propres placeholders.
• Les attributs booléens conditionnels. data-if-horizontal="champ" pose horizontal quand champ est vrai (ni null, undefined, « », [] ni false) et le retire sinon ; data-unless-… inverse. L'attribut de convention est retiré du DOM.
• Rien de silencieux. source absent, gabarit absent, key-field absent des lignes ou en double, per-row invalide, bloc {{#if}} coupé entre deux éléments : erreur de configuration nommée (data-dsfr-config-error, console).

Grammaire du gabarit : la même, deux différences de sortie

Le moteur est celui de dsfr-data-display et de dsfr-data-map-popup — {{chemin[:format[:arg]][|défaut]}}, {{#if}}, {{#unless}}, {{#each}} — sans syntaxe nouvelle. Parce que le rendu est par nœuds : {{{brut}}} n'a pas de sens sur un nœud texte (rendu comme {{brut}}, avec un avertissement) ; un bloc {{#if}}…{{/if}} doit tenir dans un nœud texte ou une valeur d'attribut — ouvert avant un élément et fermé après, il ne peut pas être un bloc : erreur de configuration, et le contenu est rendu quelle que soit la condition.

Exemples

<dsfr-data-repeat source="questions" key-field="code" per-row="1 md:3">
  <template>
    <h4 id="{{$uid}}">{{libelle}}</h4>
    <dsfr-data-query id="q-{{code}}" source="scores" where="code:eq:{{code}}"></dsfr-data-query>
    <dsfr-data-chart source="q-{{code}}" type="{{pres}}"
      label-field="annee" value-field="score" data-if-horizontal="long"></dsfr-data-chart>
  </template>
</dsfr-data-repeat>

<dsfr-data-repeat source="chapitres" key-field="chapitre">
  <template>
    <h4>{{nom}}</h4>
    <dsfr-data-query id="qc-{{chapitre}}" source="questions-par-chapitre" where="chapitre:eq:{{chapitre}}"></dsfr-data-query>
    <dsfr-data-repeat source="qc-{{chapitre}}" key-field="code">
      <template><p>{{$index}}. {{libelle}}</p></template>
    </dsfr-data-repeat>
  </template>
</dsfr-data-repeat>

<dsfr-data-repeat source="vide" empty="Aucune question pour ce périmètre.">
  <template><p>{{libelle}}</p></template>
</dsfr-data-repeat>

<dsfr-data-repeat source="questions" key-field="code" scopes="scores:code:s" lazy>
  <template>
    <h4 id="{{$uid}}">{{libelle}}</h4>
    <dsfr-data-chart source="{{$scope.s}}" type="{{pres}}"
      label-field="annee" value-field="score"></dsfr-data-chart>
  </template>
</dsfr-data-repeat>

Limites, dites d'avance

• Pas de délégation serveur derrière un id scopé : une source lue par N queries reste calculée dans le navigateur (règle #765). La charger en entier (fetch-mode="export", max-records au volume réel). Ni facets ni search ne se répètent.
• Le bus est plat : deux répéteurs qui fabriquent le même id (q-001) se marchent dessus, comme deux auteurs qui écriraient le même id. Préfixer par répéteur.
• Une query par ligne coûte N filtres et N renégociations à chaque inscription (#900) : préférer scopes, qui partitionne la source une fois. La query par ligne reste la voie quand la ligne a besoin d'un regroupement ou d'un agrégat propre — scopes livre les lignes brutes de la clé, il ne calcule pas.
• lazy ne réserve pas de hauteur à votre place : sans min-height sur le gabarit (ou sur .dsfr-data-repeat__row), des conteneurs réduits à un titre tiennent tous dans le viewport et s'estampent d'un coup.