Pole formulářů

Reference pro vestavěné Wire Forms field a layoutové komponenty.

Vyberte podle případu užití

Layoutové komponenty

Layoutové komponenty (Grid, Flex, Section, Fieldset, Tabs, Wizard) žijí ve sdílené sekci Schema — stejný slovník používají formuláře, infolisty i modály.

Zobrazovací komponenty

Postavte si vlastní

Potřebujete pole, které zde není? Stavbu vlastních polí a zobrazovacích komponent, znovupoužitelné presety a balíčkování polí do pluginu viz Rozšíření formulářů.

Společné API pole

Každé pole dědí následující metody ze sdílené základní třídy Field. Jednotlivé dokumentace polí se soustředí na volby specifické pro dané pole; pro cokoli tam neuvedeného se vraťte sem.

Label a nápověda

Viditelnost a stav

Výchozí hodnota

TextInput::make('status')->default('draft')
TextInput::make('user_id')->default(fn () => auth()->id())

Při naplnění formuláře se každé pole ze schématu naseeduje automaticky: jeho ->default(), pokud je nastaven, jinak typově správná prázdná hodnota (''/null u textu, [] u polí typu pole jako CheckboxList/Tags/ multi-select, false u přepínačů). Nikdy nemusíš pole předvyplňovat jen proto, aby jeho klíč existoval — pole typu pole zejména začínají jako [] místo aby zkolabovala.

Výchozí hodnoty doplní jen klíče, které příchozí data nedodala, takže se uplatní při vytváření a u nových/virtuálních polí a nikdy nepřepíšou uloženou hodnotu záznamu — ani záměrný null. Pro předvyplnění z recordu nebo kontextu nad rámec výchozích hodnot použij fillFormUsing() na akci (viz Akce).

Doplnění výchozí hodnoty i pro null

Jednotlivé pole můžeš přihlásit k tomu, aby null (nebo prázdný řetězec) v edit módu bralo jako nenastavené, takže se i tam doplní jeho výchozí hodnota:

TextInput::make('quantity')->numeric()->default(1)->defaultOnNull()
Select::make('status')->options(Status::class)->default(Status::Draft)->defaultOnNull()

Používej to jen tam, kde null není hodnota, kterou si uživatel může záměrně zvolit — třeba u sloupce, který musí vždy nést hodnotu. Pokud pole uživatel může vědomě vymazat, nech defaultOnNull() vypnuté, ať jeho volba zůstane; pro nápovědu k prázdnému stavu použij radši placeholder(). Když sloupec jen nikdy nemá být null, dej přednost výchozí hodnotě na modelu/v DB, ať jsou create i edit konzistentní už na datové vrstvě.

Validace

Live aktualizace

Prefix a suffix

Dostupné na TextInput, Textarea a Select.

Affix a hint akce běží na serveru s reaktivním $get / $set kontextem pole — viz Field akce a tlačítka.

Ostatní

Běžné vzory

Základní create nebo edit formulář

use NyonCode\WireForms\Components\TextInput;
use NyonCode\WireForms\Components\Select;
use NyonCode\WireForms\Components\Toggle;
 
->schema([
    TextInput::make('name')
        ->required()
        ->maxLength(255),
 
    TextInput::make('email')
        ->email()
        ->required(),
 
    Select::make('role')
        ->options([
            'admin' => 'Admin',
            'editor' => 'Editor',
            'viewer' => 'Viewer',
        ])
        ->required(),
 
    Toggle::make('active'),
])

Seskupení polí do sekcí

use NyonCode\WireForms\Components\Layout\Grid;
use NyonCode\WireForms\Components\Layout\Section;
 
->schema([
    Section::make('User')
        ->schema([
            Grid::make()->columns(2)->schema([
                TextInput::make('name')->required(),
                TextInput::make('email')->email()->required(),
            ]),
        ]),
])

Související dokumentace

• Přehled formulářů
• Validace
• Životní cyklus ukládání