Skip to content

form.md

Latest commit

 

History

History
78 lines (61 loc) · 2.87 KB

form.md

File metadata and controls

78 lines (61 loc) · 2.87 KB

Компонент Form

Form - канонічна EvoUI поверхня для налаштувань, config editors, model-backed editors і resource-like manager screens.

Повний технічний контракт лежить у Form Component; ця сторінка українською описує, як цим користуватись у dDocs.

Анатомія форми

Кожна стандартна форма має:

  • form surface з класами variant, density і layout;
  • опційний heading з icon, title, meta і description;
  • спільний action toolbar із Save, Reset або URL actions;
  • опційні внутрішні tabs;
  • sections, які групують поля;
  • field rows через x-evo::form.field;
  • dirty-state markers: data-evo-form і data-evo-form-dirty;
  • source service, який завантажує, валідовує, кастить і зберігає дані.

Базове використання

<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' => 'Увімкнено'],
            ],
        ],
    ],
    'actions' => [
        ['type' => 'save', 'label' => 'evo::global.action_save'],
    ],
];

Типи source

  • config: PHP config files і module settings.
  • model: persistence через model, який належить consumer module.
  • resource: Evolution resource fields, TVs або localized resource values.

Словник полів

Використовуй спільні типи: 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 і зареєстровані custom views.

Приклади окремих полів лежать у Каталозі форм і полів.

Ownership

EvoUI відповідає за layout, labels, field chrome, buttons, dirty state, editor/media bridges і validation rendering. Consumer відповідає за fields, source config, permissions, persistence і business rules.

Не робити

  • Не створювати module-local Save buttons.
  • Не додавати module-local CSS для labels, spacing або input widths.
  • Не дублювати dirty-state logic.
  • Не описувати modal shell behavior у form preset.