# Groupes répétables

Collectez autant d'entrées qu'un répondant en a besoin depuis un seul bloc répétable.

## Groupes répétables

Un groupe répétable rassemble quelques questions liées en un seul bloc que les répondants peuvent ajouter autant de fois qu'ils le souhaitent. Un seul bloc collecte une liste entière — invités, lignes de commande, contacts — sans que vous ayez à deviner combien de lignes prévoir.

<h2 id="what-it-is">Ce qu'est un groupe répétable</h2>

<p>
  Un groupe répétable est un conteneur étiqueté qui contient une ou plusieurs questions — ses <strong>champs membres</strong>. Les
  répondants ajoutent autant d'<strong>entrées</strong> du groupe entier qu'ils en ont besoin. Chaque entrée collecte un nouveau jeu de
  réponses pour chaque champ membre à l'intérieur.
</p>

<p>Utilisez-en un chaque fois qu'un même répondant pourrait fournir plusieurs fois des données de même forme :</p>

<ul>
  <li>
    <strong>Invités d'un événement</strong> — un Nom et un Âge pour chaque personne qu'il amène.
  </li>
  <li>
    <strong>Lignes de commande</strong> — un produit, une quantité et un prix par ligne.
  </li>
  <li>
    <strong>Contacts</strong> — nom, e-mail et rôle pour chaque membre d'une équipe.
  </li>
  <li>
    <strong>Historique professionnel</strong> — employeur, poste et dates pour chaque emploi précédent.
  </li>
</ul>

<h2 id="add-a-repeating-group">Ajouter un groupe répétable</h2>

<p>
  Un groupe répétable est un bloc structurel : un titre de groupe, les champs membres à l'intérieur, et un bouton d'ajout. Les groupes
  vivent au niveau supérieur de votre formulaire — l'éditeur impose automatiquement cette forme, et vous ne pouvez pas en imbriquer un dans
  un autre.
</p>

Groupe répété</strong>. Le curseur se place dans le titre.',
    },
    {
      title: 'Nommer le groupe',
      description:
        "Donnez-lui un titre, comme « Invités supplémentaires ». C'est le titre que les répondants voient au-dessus des entrées. Masquez-le plus tard depuis le menu du bloc si vous n'en voulez pas.",
    },
    {
      title: "Ajouter des champs membres à l'intérieur",
      description:
        'Déposez des questions ordinaires dans le groupe — Champ de texte, Nombre, Sélecteur de date, Liste déroulante, et plus. Chacune garde son propre libellé, son espace réservé et son interrupteur obligatoire.',
    },
    {
      title: "Modifier le libellé du bouton d'ajout",
      description:
        'Le bouton affiche "Add one more" jusqu’à ce que vous le changiez. Faites-le correspondre au contenu — par exemple "Ajouter un autre invité".',
    },
  ]}
/>

<p>
  Vous avez déjà créé les champs ? Sélectionnez-les, ouvrez le menu du bloc depuis la poignée de glissement, et choisissez{' '}
  <strong>Créer un groupe répété</strong> — cela fonctionne sur un seul bloc ou sur une série. Le même menu sur un groupe propose{' '}
  <strong>Masquer le titre</strong> et <strong>Supprimer le regroupement</strong>, qui déballe à nouveau les questions.
</p>

<h2 id="what-respondents-see">Ce que voient les répondants</h2>

<p>
  La première entrée s'affiche en ligne — le titre du groupe, ses champs membres et le bouton d'ajout, comme n'importe quelle autre section
  du formulaire. Dès qu'un répondant ajoute une deuxième entrée, chacune devient une carte numérotée (01, 02, 03…) avec un contrôle de
  suppression dans son coin.
</p>

<ul>
  <li>
    <strong>Bouton d'ajout</strong> — ajoute une nouvelle entrée vierge à chaque clic.
  </li>
  <li>
    <strong>Contrôle de suppression</strong> — le X sur une carte supprime cette entrée. Il apparaît dès qu'il y a deux entrées ou plus.
  </li>
  <li>
    <strong>À la limite</strong> — un groupe contient jusqu'à 100 entrées, et le bouton d'ajout se désactive aussi lorsque les réponses
    atteignent la limite de charge utile de 256 Ko par soumission. Ce sont deux garde-fous contre les soumissions incontrôlées, que les
    répondants ne rencontrent normalement pas.
  </li>
</ul>

<p>
  Sur une <a href="/fr/requests/overview">demande</a> qui verrouille l'un des champs membres du groupe, la forme est figée pour ce
  destinataire : il ne peut ni ajouter ni supprimer d'entrées.
</p>

> 💡 **Gardez les champs membres ciblés**
> <p>
>     Un groupe répétable fonctionne mieux avec une poignée de questions ciblées — l'ensemble qu'un répondant remplit une fois par entrée.
>     L'interrupteur obligatoire s'applique par entrée, donc chaque entrée doit passer la même validation.
>   </p>

<h2 id="logic-and-groups">Groupes et logique conditionnelle</h2>

<p>
  Un groupe entier peut être affiché ou masqué par une règle de <a href="/fr/building-forms/conditional-logic">logique</a>, exactement comme
  n'importe quel autre bloc. Les champs membres ne le peuvent pas : ils ne sont proposés ni comme conditions, ni comme cibles
  d'affichage/masquage, ni comme cibles obligatoire/facultatif, car une règle agirait silencieusement sur la première entrée seulement.
  Branchez-vous plutôt sur une question en dehors du groupe.
</p>

<h2 id="where-answers-show-up">Où apparaissent les réponses</h2>

<p>
  Une fois les réponses arrivées, le groupe reste groupé sur toutes les surfaces. Chaque page ci-dessous porte le détail complet — ceci
  n'est qu'une carte :
</p>

<ul>
  <li>
    <strong>
      <a href="/fr/submissions-analytics/submission-inbox">Boîte de réception des soumissions</a>
    </strong>{' '}
    — une soumission affiche des cartes numérotées par entrée ; la vue tableau reçoit une puce de comptage unique qui ouvre le détail.
  </li>
  <li>
    <strong>
      <a href="/fr/submissions-analytics/question-summary">Résumé agrégé</a>
    </strong>{' '}
    — le groupe apparaît comme une seule carte avec le nombre d'entrées et de soumissions, plus un mini-bloc par champ membre.
  </li>
  <li>
    <strong>
      <a href="/fr/submissions-analytics/exports">Exporter les soumissions</a>
    </strong>{' '}
    — chaque entrée s'exporte sous ses propres clés, et le groupe entier peut aussi se réduire en une seule colonne de texte étiquetée.
  </li>
  <li>
    <strong>
      <a href="/fr/requests/callbacks">Callbacks et l'API</a>
    </strong>{' '}
    — les réponses du groupe apparaissent sous leur propre <a href="/fr/requests/field-keys">clé de champ</a> comme une liste, un objet par
    entrée indexé par champ membre, dans l'ordre où le répondant les a laissées.
  </li>
</ul>

<h2 id="referencing-group-answers">Référencer les réponses d'un groupe</h2>

<p>
  Injectez un groupe répétable dans d'autres questions, notifications ou intégrations avec une mention <strong>@</strong> — mentionnez un
  seul champ membre pour joindre la valeur de ce champ à travers toutes les entrées, ou mentionnez le groupe entier pour récupérer toutes
  les entrées à la fois. Consultez{' '}
  <a href="/fr/building-forms/answer-piping#referencing-repeating-groups">Insertion de réponses → Référencer des groupes répétables</a> pour
  savoir exactement comment chaque référence se résout, avec des exemples.
</p>

<h2 id="next-steps">Étapes suivantes</h2>
<div class="not-prose grid gap-3 sm:grid-cols-2">
  - [Insertion de réponses](/fr/building-forms/answer-piping) — Référencez les réponses du groupe dans tout votre formulaire
  - [Logique conditionnelle](/fr/building-forms/conditional-logic) — Afficher, masquer et créer des branches selon les réponses
  - [Boîte de réception des soumissions](/fr/submissions-analytics/submission-inbox) — Lisez les entrées sous forme de cartes numérotées
  - [Exporter les soumissions](/fr/submissions-analytics/exports) — Téléchargez les entrées du groupe en CSV ou Excel
</div>
