---
title: "Fasáda Forms — Forms for Laravel | Roundly"
description: "Celé API na jednej fasáde — definícia, hľadanie, validácia, odoslanie, koncepty, čítanie a schvaľovanie formulárov, plus buildery a handly."
url: https://roundly-consulting.com/sk/open-source/navody/forms-for-laravel/fasada
language: sk
---

[Všetky balíky](https://roundly-consulting.com/sk/open-source.md)

[Forms for Laravel](https://roundly-consulting.com/sk/open-source/navody/forms-for-laravel.md)

# Fasáda Forms

Odporúčaným vstupným bodom je RoundlyConsulting\\Forms\\Facades\\Forms. Jej koreňom je RoundlyConsulting\\Forms\\FormsManager — tenký manažér, ktorý pri každom volaní získa z kontajnera jednu akciu. Vaše prepísania v kontajneri aj Forms::fake() sa preto uplatnia na každej ceste. Celé API na jednom mieste:

```php
use RoundlyConsulting\Forms\Facades\Forms;
use RoundlyConsulting\Forms\GroupBuilder;

Forms::define('contact', 'Contact us')                   // FormBuilder, stored by create()
    ->group('details', 'Details', function (GroupBuilder $g): void {
        $g->field('email', 'Email')->email()->required();
    })
    ->create();

$form = Forms::find('contact');                          // groups + fields, ordered
Forms::update('contact')->name('Contact us')->save();    // diff and save a structural edit
Forms::sync();                                           // forms from config('forms.definitions')

$data   = Forms::validate($form, $request);              // or a ValidationException
$result = Forms::submit($form, $request, $user);         // SubmissionResult
$draft  = Forms::draft($form, $request, $user);          // a resumable draft
Forms::finalize($draft->uuid);                           // validate and promote it

Forms::submissions($form)->latest()->get();              // Collection<AssembledSubmission>
Forms::submission($result->uuid)->get();                 // one submission, by uuid or model
Forms::review($result->uuid)->requiring([$lead, $qa])->quorum(2)->open();

Forms::createSubmission($field, ['value' => 'Jane'], $user); // one raw field row
```

## Všetky metódy

| Metóda | Vracia | Čo robí |
| --- | --- | --- |
| `find($key)` | Form | Formulár so zoradenými skupinami a poliami. |
| `define($key, $name)` | FormBuilder | Fluentne definovaný nový formulár; uloží ho ->create(). |
| `create(FormDefinitionData)` | Form | Formulár z definície v jednej transakcii. |
| `update($key)` | UpdateFormBuilder | Fluentná úprava štruktúry; ->save() porovná a uloží zmeny. |
| `sync(?array $definitions = null)` | list<string> | Vytvorí alebo aktualizuje formuláre z forms.definitions (alebo z odovzdaného zoznamu). |
| `validate($form, $request)` | array | Zvalidované dáta, alebo ValidationException. |
| `submit($form, $request, ?$sender, bypassClosed:)` | SubmissionResult | Finálna odpoveď; spustí FormSubmitted. |
| `draft($form, $request, ?$sender, ?$uuid, bypassClosed:)` | SubmissionResult | Nevalidovaný koncept, v ktorom možno pokračovať. |
| `finalize($uuid, bypassClosed:)` | SubmissionResult | Zvaliduje koncept a povýši ho na finálnu odpoveď. |
| `submissions($form)` | SubmissionQuery | Čítač, ktorý skladá jednu sadu odpovedí na každé odoslanie. |
| `submission($uuid \| FormSubmission)` | SubmissionHandle | Jedna odpoveď či koncept: uuid(), get(), model(), finalize(), review(). |
| `review($uuid \| FormSubmission)` | PendingSubmissionReview | Schvaľovanie určenými schvaľovateľmi; spustí ho ->open(). |
| `createSubmission($field, $value, ?$sender, ?$uuid, bypassClosed:)` | Submission | Jeden surový riadok poľa (importy, seedy), zaradený pod odpoveď so svojím uuid. |
| `fake()` | FormsFake | Zapne zaznamenávajúci fake (pozrite Testovanie). |

## Buildery a handly

- Forms::define($key, $name) → FormBuilder: public(), expiresAt(), group($key, $name, $callback), create() — pozrite Fluentný builder formulárov.
- Forms::update($key) → UpdateFormBuilder: name(), public(), expiresAt(), group(), save() — pozrite Úprava formulárov.
- Forms::submissions($form) → SubmissionQuery: forSender(), latest(), oldest(), withDrafts(), whereUuid(), pendingApproval(), approved(), rejected() a nakoniec get(), first() alebo count().
- Forms::submission($uuid | $model) → SubmissionHandle: uuid(), get(), model(), finalize(), review(). Neznáme uuid vyhodí SubmissionNotFoundException.
- Forms::review($uuid | $model) → PendingSubmissionReview: requiring(), rule(), unanimous(), any(), quorum(), weighted(), open().

Buildery aj handly volajú späť manažéra a rovnako aj trait HasForms — nech váš kód zvolí ktorúkoľvek cestu, prejde tým istým manažérom a zobrazí sa vo Forms::fake().

## 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](https://roundly-consulting.com/sk/podporte-nas.md)

Odoslaním daru súhlasíte s našimi [podmienkami prijímania darov](https://roundly-consulting.com/sk/podmienky-darov.md).

[Podporte našu open-source prácu (otvorí sa v novej karte)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Pridajte sa k nám na Patreone (otvorí sa v novej karte)](https://www.patreon.com/cw/roundly)

## 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](https://roundly-consulting.com/sk/kontakt.md) [Prezrieť všetky balíky](https://roundly-consulting.com/sk/open-source/navody/forms-for-laravel.md)