Podformularz

Fragment formularza wielokrotnego użytku dla pól list, pól yaml i stron kreatora


Podformularz to fragment formularza wielokrotnego użytku. Nie pojawia się w widoku kafelków i nie można go wysłać bezpośrednio. Odwołują się do niego:

  • Pole list: otwiera podformularz jako edytor drilldown dla każdego wiersza
  • Pole yaml z właściwością subform: otwiera podformularz jako edytor drilldown dla pojedynczego obiektu
  • Krok wizard: wyświetla podformularz jako jedną stronę kreatora

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

Właściwości

Podformularze nie mają właściwości specyficznych dla typu. Używają tylko wspólnych właściwości formularzy: name, description, help, type i fields.

Gdy podformularz służy jako strona kreatora, jego description i help dostarczają wartości domyślnych dla title i help kroku. Może też ustawić showHelp, aby ta pomoc była rozwinięta po załadowaniu strony.

Właściwości wykonania (playbook, template, roles, inventory itp.) nie dotyczą podformularzy, ponieważ podformularz nigdy nie jest wysyłany bezpośrednio.