Validace formulářů

Wire Forms poskytuje validaci na třech úrovních: pravidla na úrovni pole, pravidla na úrovni formuláře a programová validace přes Core ValidationPipeline.

Pravidla na úrovni pole

Každé pole deklaruje svá vlastní validační pravidla:

TextInput::make('name')
    ->required()
    ->maxLength(255)
    ->rules(['string', 'regex:/^[a-zA-Z\s]+$/']);
 
TextInput::make('email')
    ->email()
    ->required()
    ->rules('unique:users,email');
 
TextInput::make('age')
    ->numeric()
    ->rules(['integer', 'min:18', 'max:120']);
 
Select::make('role')
    ->required()
    ->rules('in:admin,editor,viewer');

Vestavěné helpery pravidel

Některá pole poskytují fluent helpery mapující na Laravel pravidla:

Vlastní validační zprávy

TextInput::make('name')
    ->required()
    ->validationMessages([
        'required' => 'Please enter a name.',
        'max' => 'Name is too long.',
    ]);

Pravidla na úrovni formuláře

Přidejte pravidla na úrovni formuláře, která zahrnují více polí:

Form::make()
    ->schema([
        TextInput::make('password')->password()->required(),
        TextInput::make('password_confirmation')->password()->required(),
    ])
    ->validationMessages([
        'password.confirmed' => 'Passwords do not match.',
    ]);

Programová validace

validate()

Zvaliduje stav proti všem posbíraným pravidlům a vrátí zvalidovaná data:

// V Livewire komponentě
public function save(): void
{
    $data = $this->form->validate();
    // $data obsahuje jen zvalidovaná pole
    // Při selhání vyhodí Illuminate\Validation\ValidationException
}

getValidationRules()

Prohlédnout si posbíraná pravidla bez validace:

$rules = $this->form->getValidationRules();
// ['name' => ['required', 'string', 'max:255'], 'email' => ['required', 'email'], ...]

Validace v životním cyklu uložení

Při volání $form->save() proběhne validace automaticky jako první krok:

save()
├── 1. Validace ← všechna pravidla polí + formuláře
├── 2. mutateDataBeforeSave()
├── 3. Plugin hook: form.saving
├── 4. beforeSave()
├── 5. Perzistence (create/update)
├── 6. Uložení relací
├── 7. afterSave()
├── 8. Plugin hook: form.saved
└── 9. Úspěšná notifikace

Pokud validace selže, save() vyhodí ValidationException a kroky 2-9 se přeskočí.

Samostatná validace (bez Livewire)

$form = Form::make()
    ->schema([
        TextInput::make('name')->required(),
        TextInput::make('email')->email()->required(),
    ])
    ->state(['name' => '', 'email' => 'not-an-email']);
 
try {
    $data = $form->validate();
} catch (ValidationException $e) {
    $errors = $e->errors();
    // ['name' => ['The name field is required.'], 'email' => ['The email field must be a valid email address.']]
}

Podmíněná pravidla

Pravidla mohou používat closury pro dynamickou validaci. Closura dostane reaktivní accessory $get / $set pole, takže pravidla mohou záviset na živém stavu sousedů. Closura může obalit celou sadu pravidel, nebo sedět uvnitř pole pravidel jako jedna položka:

TextInput::make('company_name')
    ->required(fn (callable $get) => $get('type') === 'business')
    ->rules(fn () => $this->isEditing()
        ? 'unique:companies,name,' . $this->getModel()->id
        : 'unique:companies,name');
 
// Closury mohou být i jednotlivé položky v poli pravidel:
TextInput::make('slug')->rules([
    'string',
    fn (callable $get) => $get('type') === 'business' ? 'required' : 'nullable',
]);

Podmiňovací helpery

Fluent zkratky vyjadřují nejběžnější mezipolní podmínky bez psaní closury. Každá porovnává živou hodnotu jiného pole; předání pole odpovídá „je jedno z".

Select::make('department')
    ->visibleWhen('type', 'business')
    ->requiredIf('type', 'business');

visibleWhen / hiddenWhen / disabledWhen jsou sdílené foundation helpery, takže jsou dostupné i na sloupcích, filtrech a akcích. Na surface bez kontextu živého stavu jsou no-op (nechají komponentu viditelnou/zapnutou).

Skrytá pole se během validace přeskočí, takže pravidlo required na poli, které uživatel aktuálně nevidí, nikdy nezablokuje odeslání.

Live validace

Ve výchozím stavu formulář validuje jako celek při odeslání. Zapněte poli per-field validaci během reaktivního roundtripu, aby se jeho chyba objevila (a zmizela), jak uživatel interaguje, bez označení zbytku formuláře:

TextInput::make('email')->email()->required()->validateLive();   // při každé změně
TextInput::make('name')->required()->validateOnBlur();           // když focus odejde

validateLive() zapne live() a validateOnBlur() zapne blur vazbu, takže server vidí změnu a obnoví jen položku error bagu daného pole. Podmiňovací helpery jako requiredIf() se ctí i live, protože čtou aktuální stav sousedů při každém roundtripu. Live validace funguje i pro pole uvnitř Repeater položek — pole každého řádku validuje proti své vlastní item path (např. data.contacts.0.email).

Live validace kontroluje jedno pole po druhém. Pravidla, která porovnávají surové hodnoty sousedů přes řetězcovou syntax Laravelu (např. required_if:other,value), je nejlepší validovat při odeslání; pro reaktivní ekvivalent použijte requiredIf().

Zobrazení chyb

Validační chyby se automaticky navážou na Livewire error bag a zobrazí se vedle příslušných polí. Prefix state path se aplikuje automaticky:

// Když statePath('data') a pole je TextInput::make('name')
// Klíč chyby: data.name
// Livewire zobrazí: @error('data.name')

V Blade není potřeba žádné manuální vykreslování chyb.