Subformulier

Een herbruikbaar formulierfragment voor list-velden, yaml-velden en wizardpagina’s

---

Een subformulier is een herbruikbaar formulierfragment. Het verschijnt niet in de tegelweergave en kan niet rechtstreeks worden verzonden. In plaats daarvan wordt ernaar verwezen door:

• Een list-veld: opent het subformulier als drilldown-editor voor elke rij
• Een yaml-veld met de eigenschap subform: opent het subformulier als drilldown-editor voor één object
• Een stap van een wizard: toont het subformulier als één pagina van de wizard

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

---

Eigenschappen

Subformulieren hebben geen typespecifieke eigenschappen. Ze gebruiken alleen de gemeenschappelijke eigenschappen van formulieren: name, description, help, type en fields.

Dient een subformulier als wizardpagina, dan leveren zijn description en help de standaardwaarden voor title en help van de stap. Het kan ook showHelp instellen om die help open te klappen wanneer de pagina laadt.

Uitvoeringseigenschappen (playbook, template, roles, inventory, enz.) gelden niet voor subformulieren, omdat een subformulier nooit rechtstreeks wordt verzonden.