Subformulari

Un fragment de formulari reutilitzable per a camps list, camps yaml i pàgines d’assistent

---

Un subformulari és un fragment de formulari reutilitzable. No apareix a la vista de mosaic i no es pot enviar directament. En lloc d’això, s’hi fa referència des de:

• Un camp list: obre el subformulari com a editor de detall per a cada fila
• Un camp yaml amb la propietat subform: obre el subformulari com a editor de detall per a un sol objecte
• Un pas d’un wizard: mostra el subformulari com una pàgina de l’assistent

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

---

Propietats

Els subformularis no tenen propietats específiques del tipus. Només fan servir les propietats comunes dels formularis: name, description, help, type i fields.

Quan un subformulari fa de pàgina d’un assistent, el seu description i el seu help proporcionen els valors per defecte del title i el help del pas. També pot definir showHelp per desplegar aquesta ajuda quan es carrega la pàgina.

Les propietats d’execució (playbook, template, roles, inventory, etc.) no s’apliquen als subformularis, perquè un subformulari no s’envia mai directament.