Subform

Um fragmento de formulário reutilizável para campos list, campos yaml e páginas de assistente

---

Um subformulário é um fragmento de formulário reutilizável. Não aparece na vista de mosaicos e não pode ser submetido diretamente. Em vez disso, é referido por:

• Um campo list: abre o subformulário como editor de drilldown para cada linha
• Um campo yaml com a propriedade subform: abre o subformulário como editor de drilldown para um único objeto
• Um passo de wizard: mostra o subformulário como uma página do assistente

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

---

Propriedades

Os subformulários não têm propriedades específicas do tipo. Só usam as propriedades comuns dos formulários: name, description, help, type e fields.

Quando um subformulário serve de página de um assistente, o seu description e o seu help fornecem os valores predefinidos do title e do help do passo. Também pode definir showHelp para expandir essa ajuda quando a página carrega.

As propriedades de execução (playbook, template, roles, inventory, etc.) não se aplicam aos subformulários, porque um subformulário nunca é submetido diretamente.