Fluentný builder formulárov

Fasáda Forms vystavuje fluentný builder, ktorý jedným transakčným volaním definuje celý formulár — skupiny aj polia — a poradie (order) prideľuje podľa poradia deklarácie:

use RoundlyConsulting\Forms\Facades\Forms;
use RoundlyConsulting\Forms\GroupBuilder;

$form = Forms::define('contact', 'Contact us')
    ->public()
    ->expiresAt(now()->addDays(30))
    ->group('details', 'Your details', function (GroupBuilder $g): void {
        $g->field('name', 'Name')->rules(['required', 'string'])->help('Full name');
        $g->field('email', 'Email')->type('email')->rules(['required', 'email']);
    })
    ->group('message', 'Message', function (GroupBuilder $g): void {
        $g->field('body', 'Message')->type('textarea')->rules(['required']);
    })
    ->create(); // returns the Form, persists the structure, dispatches FormCreated

Builder formulára ponúka public(bool $public = true), expiresAt(CarbonInterface), group($key, $name, $callback) a terminálne create(). V callbacku vracia GroupBuilder::field($key, $name) inštanciu FieldBuilder. Nové polia majú predvolene typ text.

Typované skratky polí

Tenká vrstva nad type()/rules()/options() pre bežné druhy polí:

$g->field('email', 'Email')->email()->required();
$g->field('bio', 'Bio')->textarea();
$g->field('terms', 'Terms')->checkbox();      // type=checkbox, rule=boolean
$g->field('age', 'Age')->number();            // type=number, rule=numeric; whole numbers (3.5 fails)
$g->field('dob', 'DOB')->date();              // type=date, rule=date
$g->field('role', 'Role')->select(['a' => 'A', 'b' => 'B']);
$g->field('avatar', 'Avatar')->file();        // type=file (media-backed upload)

Všetky metódy buildera poľa

Metóda	Účinok
`type(string)`	Nastaví typ poľa (predvolene text).
`help(string)`	Pomocný text zobrazený pri poli.
`options(array)`	Možnosti výberu, napr. ['CZ' => 'Czechia'].
`rules(array, array $messages = [])`	Validačné pravidlá Laravelu a voliteľné hlášky k pravidlám.
`messages(array)`	Hlášky k pravidlám, zlúčené s existujúcimi.
`required()`	Pridá pravidlo required.
`autofill(string)`	Názov triedy Autofill alebo doslovná predvolená hodnota.
`visibleWhen(field, value, op)`	Pole sa zobrazí len pri splnení podmienky; field je kľúč alebo group_key.field_key.
`requiredWhen(field, value, op)`	Pole sa zobrazí a je povinné len pri splnení podmienky.
`order(int)`	Prepíše automaticky pridelenú pozíciu — aj na 0.
`email()`	typ email + pravidlo email.
`textarea()`	typ textarea.
`checkbox()`	typ checkbox + pravidlo boolean.
`number()`	typ number + pravidlo numeric; len celé čísla (3.5 neprejde).
`date()`	typ date + pravidlo date.
`select(array)`	typ select + možnosti.
`file()`	typ file — nahrávanie súboru cez médiá.

Vlastné validačné hlášky

Hlášky pre pole odovzdajte ako druhý argument rules() alebo cez messages(). Uložia sa na pole, validátor ich použije a kľúčom je názov pravidla:

$g->field('email', 'Email')->rules(['required', 'email'], [
    'required' => 'We really need your email.',
]);

// or add messages separately — they merge with any passed to rules()
$g->field('age', 'Age')
    ->number()
    ->required()
    ->messages(['numeric' => 'Please enter your age as a number.']);

Zmena poradia

Skupiny aj polia sa radia podľa deklarácie. Pozíciu prepíšete cez ->order(n) na skupine (v jej callbacku) alebo na poli — vrátane ->order(0):

Forms::define('survey', 'Survey')
    ->group('intro', 'Introduction', function (GroupBuilder $g): void {
        $g->order(10);                                    // override the group's position
        $g->field('nps', 'How likely are you to recommend us?')
            ->number()
            ->order(5);                                   // override the field's position
        $g->field('name', 'Name')->order(0);              // an explicit 0 is kept
    })
    ->create();

Prejavte lásku k open source

Tento balík je zadarmo pod licenciou MIT. Ak vám šetrí čas, jednorazový príspevok alebo členstvo na Patreone nám pomôže ho ďalej udržiavať, testovať a dokumentovať.

Ďalšie spôsoby podpory vrátane kryptomien

Odoslaním daru súhlasíte s našimi podmienkami prijímania darov.

Podporte našu open-source prácu Pridajte sa k nám na Patreone

Chcete to zabudovať do svojho produktu?

Naše balíky integrujeme do zákazkových Laravel a AI riešení. Napíšte nám, na čom pracujete, a ozveme sa do 48 hodín.

Ponuka do 48 hodín Prezrieť všetky balíky