Skip to content

form.md

Latest commit

 

History

History
78 lines (61 loc) · 2.38 KB

form.md

File metadata and controls

78 lines (61 loc) · 2.38 KB

Komponent Form

Form to kanoniczna powierzchnia EvoUI dla ustawien, edytorow konfiguracji, edytorow opartych o model i ekranow managera podobnych do resource.

Pelny kontrakt techniczny jest w Form Component. Ta lokalizowana strona opisuje praktyczna implementacje w dDocs.

Anatomia

Kazdy standardowy formularz ma:

  • form surface z variant, density i layout;
  • opcjonalny heading z ikona, tytulem, meta i opisem;
  • wspolny action toolbar z Save, Reset lub URL actions;
  • opcjonalne wewnetrzne tabs;
  • sections grupujace pola;
  • field rows renderowane przez x-evo::form.field;
  • markery dirty state: data-evo-form i data-evo-form-dirty;
  • source, ktory laduje, waliduje, castuje i zapisuje dane.

Podstawowe uzycie

<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' => 'Wlaczone'],
            ],
        ],
    ],
    'actions' => [
        ['type' => 'save', 'label' => 'evo::global.action_save'],
    ],
];

Source Types

  • config: pliki PHP config i ustawienia modulu.
  • model: persistence przez model nalezacy do consumer module.
  • resource: Evolution resource fields, TVs lub lokalizowane wartosci resource.

Slownik pol

Uzywaj wspolnych typow: 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 i zarejestrowanych custom views.

Przyklady pol sa w Form And Field Catalogue.

Ownership

EvoUI posiada layout, labels, field chrome, buttons, dirty state, editor/media bridges i validation rendering. Consumer posiada fields, source config, permissions, persistence i business rules.

Nie Robic

  • Nie tworzyc module-local Save buttons.
  • Nie dodawac module-local CSS dla labels, spacing albo input widths.
  • Nie duplikowac dirty-state logic.
  • Nie dokumentowac modal shell behavior w form preset.