Skip to content

form.md

Latest commit

 

History

History
80 lines (63 loc) · 2.45 KB

form.md

File metadata and controls

80 lines (63 loc) · 2.45 KB

Form-Komponente

Form ist die kanonische EvoUI-Oberflaeche fuer Einstellungen, Konfigurationseditoren, model-basierte Editoren und resource-aehnliche Manager Screens.

Der vollstaendige technische Vertrag steht in Form Component. Diese lokalisierte Seite beschreibt den praktischen Einsatz in dDocs.

Aufbau

Jedes Standardformular hat:

  • eine Form Surface mit variant, density und layout;
  • optionalen Heading mit Icon, Titel, Meta und Beschreibung;
  • gemeinsame Action Toolbar mit Save, Reset oder URL Actions;
  • optionale interne Tabs;
  • Sections zur Gruppierung von Feldern;
  • Field Rows ueber x-evo::form.field;
  • Dirty-State Marker: data-evo-form und data-evo-form-dirty;
  • eine Source, die Daten laedt, validiert, castet und speichert.

Basisnutzung

<livewire:evo-ui.form
    preset="vendor.module.settings"
    :context="['moduleUrl' => $moduleUrl]"
/>
return [
    'key' => 'vendor.module.settings',
    'variant' => 'config',
    'source' => ['type' => 'config', 'file' => 'vendor/module/settings.php'],
    'density' => 'compact',
    'layout' => 'settings',
    'sections' => [
        [
            'key' => 'general',
            'fields' => [
                ['name' => 'enabled', 'type' => 'checkbox', 'label' => 'Aktiv'],
            ],
        ],
    ],
    'actions' => [
        ['type' => 'save', 'label' => 'evo::global.action_save'],
    ],
];

Source Types

  • config: PHP-Konfigurationsdateien und Moduleinstellungen.
  • model: Speicherung ueber ein Model des Consumer-Moduls.
  • resource: Evolution Resource-Felder, TVs oder lokalisierte Resource-Werte.

Feldvokabular

Nutze die gemeinsamen Typen: text, number, textarea, checkbox, select, radio, multi-checkbox, choices, csv, datetime-local, color-picker, alias, image, file, editor, display, resource-parent, config-map, repeater, builder und registrierte Custom Views.

Feldbeispiele stehen im Form And Field Catalogue.

Ownership

EvoUI besitzt Layout, Labels, Field Chrome, Buttons, Dirty State, Editor/Media-Bridges und Validation Rendering. Das Consumer-Modul besitzt Fields, Source Config, Permissions, Persistence und Business Rules.

Nicht Tun

  • Keine module-lokalen Save Buttons bauen.
  • Kein module-lokales CSS fuer Labels, Spacing oder Input Widths.
  • Dirty-State Logic nicht duplizieren.
  • Modal Shell Behavior nicht im Form Preset dokumentieren.