Sous-formulaire

Un fragment de formulaire réutilisable pour les champs list, les champs yaml et les pages d’assistant

---

Un sous-formulaire est un fragment de formulaire réutilisable. Il n’apparaît pas dans la vue en tuiles et ne peut pas être soumis directement. Il est référencé par :

• Un champ list : ouvre le sous-formulaire comme éditeur détaillé pour chaque ligne
• Un champ yaml avec la propriété subform : ouvre le sous-formulaire comme éditeur détaillé pour un seul objet
• Une étape d’wizard : affiche le sous-formulaire comme une page de l’assistant

A reusable form fragment used as the per-row editor of a list field, or as the single-object editor of a yaml field with the subform property.
Subforms are not shown in the tile view and cannot be submitted directly.
They share the same field types and validation rules as regular forms.

Address subform

- name: Address
  type: subform
  fields:
    - name: street
      type: text
      label: Street
      required: true
    - name: city
      type: text
      label: City
      required: true
    - name: country
      type: text
      label: Country
      required: true
- name: My Main Form
  type: ansible
  playbook: site.yml
  roles:
    - default
  fields:
    - name: addresses
      type: list
      label: Addresses
      subform: Address

---

Propriétés

Les sous-formulaires n’ont aucune propriété propre à leur type. Ils n’utilisent que les propriétés communes des formulaires : name, description, help, type et fields.

Quand un sous-formulaire sert de page d’assistant, sa description et son help fournissent les valeurs par défaut du title et du help de l’étape. Il peut aussi définir showHelp pour déplier cette aide au chargement de la page.

Les propriétés d’exécution (playbook, template, roles, inventory, etc.) ne s’appliquent pas aux sous-formulaires, car un sous-formulaire n’est jamais soumis directement.