Formuláře

Select

Rozbalovací seznam nad statickými nebo dotazovanými možnostmi, s hledáním na serveru, vícenásobným výběrem a založením nové položky.

Rozbalovací seznam se statickými nebo dynamickými možnostmi, hledáním a vícenásobným výběrem.

use NyonCode\WireForms\Components\Select;

Mobil. Rozbalovací/hledací panel se otevře jako bottom sheet pod nakonfigurovaným breakpointem (searchable selecty zůstanou plovoucím panelem ve výchozím stavu, aby vyhledávací pole zůstalo použitelné). Přepište u jednotlivých polí pomocí ->sheetOnMobile() / ->mobileBreakpoint('md') — viz mobilní prezentace.

Základní použití

Select::make('role')
    ->options([
        'admin' => 'Administrator',
        'editor' => 'Editor',
        'user' => 'User',
    ])

Dynamické možnosti

Select::make('category_id')
    ->options(fn () => Category::pluck('name', 'id')->toArray())
    ->placeholder('Choose category')

Možnosti z enumu

Předejte třídu PHP enumu přímo místo pole — case se rozvinou na mapu value => label. Klíč je backing hodnota (nebo název case pro unit enumy) a popisek pochází z getLabel() enumu, když implementuje kontrakt Foundation\Contracts\Enum\HasLabel, s fallbackem na headline z názvu case.

use NyonCode\WireCore\Foundation\Contracts\Enum\HasLabel;
 
enum Status: string implements HasLabel
{
    case Draft = 'draft';
    case Published = 'published';
 
    public function getLabel(): ?string
    {
        return match ($this) {
            self::Draft => 'Draft',
            self::Published => 'Published',
        };
    }
}
 
Select::make('status')->options(Status::class)
// → ['draft' => 'Draft', 'published' => 'Published']

Enum bez HasLabel stále funguje — z názvu case se udělá headline pro popisek (LowPriority → Low Priority). Closura vracející třídu enumu se rozvine také.

Automatická validace. Jednohodnotový Select (nebo Radio), jehož možnosti pocházejí z enumu, je automaticky omezen na tyto hodnoty pravidlem in: — odeslání mimo enum je odmítnuto, aniž byste ho museli znovu uvádět. Přeskočí se pro multiple() selecty (stav pole) a když deklarujete vlastní pravidlo in: / Rule::in() / Rule::enum().

Stejná zkratka ->options(Enum::class) funguje na Radio, CheckboxList, table SelectColumn a table SelectFilter.

Zrušení výběru

Zvolení prázdné (placeholder) položky uloží null, ne prázdný řetězec — což je podstatné hlavně u sloupce castovaného na enum, kde '' není platná hodnota a cast by při ukládání vyhodil chybu:

Select::make('status')
    ->options(Status::class)      // sloupec castovaný na enum
    ->placeholder('Bez stavu')    // zvolením se uloží null

Vícenásobný výběr to nemění: jeho prázdný stav je [], což cast na pole uloží tak, jak je.

Vyhledávatelné

Select::make('user_id')
    ->options(fn () => User::pluck('name', 'id')->toArray())
    ->searchable()
    ->noSearchResultsMessage('No users found')
    ->searchPrompt('Type to search...')
    ->loadingMessage('Loading...')

Remote hledání

Místo filtrování přednačteného seznamu v prohlížeči resolvujte shody na serveru, jak uživatel píše:

Select::make('author_id')
    ->getSearchResultsUsing(fn (string $search) =>
        User::where('name', 'like', "%{$search}%")->limit(50)->pluck('name', 'id')->all()
    )
    ->getOptionLabelUsing(fn ($value) => User::find($value)?->name)

• getSearchResultsUsing() implikuje searchable() a vrací mapu value => label.
• getOptionLabelUsing() (single) / getOptionLabelsUsing() (multiple) resolvují popisek nebo popisky pro aktuální výběr, takže trigger zůstane čitelný i když vybraná možnost nebyla nikdy přednačtená.
• preload() dychtivě naplní remote seznam při renderu (spustí search callback s prázdným výrazem) místo čekání na první stisk klávesy.

Hostitel musí vystavit search endpoint — jakákoli WithForms komponenta nebo table action modal to dělá. BelongsToSelect dostane remote hledání řízené relací automaticky.

Vytvoření a úprava možností

Nechte uživatele vytvořit novou možnost — nebo upravit vybranou — z modalu bez opuštění formuláře:

Select::make('category_id')
    ->options(fn () => Category::pluck('name', 'id')->all())
    ->createOptionForm([
        TextInput::make('name')->required(),
    ])
    ->createOptionUsing(fn (array $data) => Category::create($data)->getKey())
    ->editOptionForm([
        TextInput::make('name')->required(),
    ])
    ->fillEditOptionUsing(fn ($value) => Category::find($value)->only('name'))
    ->updateOptionUsing(fn ($value, array $data) => Category::find($value)->update($data))

Prvek „+ Create“ (a pro vybranou hodnotu „Edit“) se objeví v patičce panelu comboboxu a otevře izolovaný modal. Validace drží modal otevřený s chybami; při úspěchu se nová hodnota vybere (přidá u multi-selectu).

• createOptionUsing() vrací hodnotu nové možnosti — skalární klíč nebo model, jehož klíč se použije.
• Editace cílí na jedinou vybranou možnost, takže není dostupná na multiple().
• Funguje v samostatných WithForms komponentách i uvnitř table action modalů.
• Aby nově vytvořená hodnota vykreslila popisek, spárujte s getOptionLabelUsing() nebo přednačteným seznamem možností.
• Vytvořená/upravená možnost se okamžitě sloučí do otevřeného comboboxu (hostitel odesílá browser události select-option-created / select-option-updated) — žádné obnovení stránky není potřeba.

Plnohodnotný formulář, ne seznam polí

Schéma možnosti je běžné formulářové schéma a namountovaný formulář možnosti je plnohodnotný formulář hostitele, takže věci, které potřebují, aby hostitel našel pole podle state path, uvnitř něj fungují stejně jako kdekoli jinde:

Select::make('category_id')
    ->createOptionForm([
        Wizard::make('category')->schema([                       
            Step::make('Základ')->schema([
                TextInput::make('name')->required(),
            ]),
            Step::make('Zařazení')->schema([
                Select::make('parent_id')
                    ->getSearchResultsUsing(fn (string $search) =>
                        Category::where('name', 'like', "%{$search}%")->pluck('name', 'id')->all()
                    ),
            ]),
        ]),                                                      
    ])
    ->createOptionUsing(fn (array $data) => Category::create($data)->getKey())

• Wizard gatuje jednotlivé kroky: „Next“ validuje jen pole daného kroku a při neúspěchu zůstane stát, přičemž chyby přistanou v bagu možnosti (createOptionFormData.*), kde je modal už zobrazuje.
• Vnořený Select dosáhne na endpoint remote searche a field actions (suffixAction(), hintAction(), Button) se resolvnou a proběhnou.
• Otevření druhého modalu možnosti zevnitř formuláře možnosti je odmítnuto, ne vnořeno: na každý druh je jedna mounted path a jeden data bag, takže vyhovět by znamenalo zahodit rozepsaný formulář.

Přidejte wizardu navigation(false) a patička modalu převezme jeho navigaci — Back a Next vedle Cancel, s tlačítkem odeslání, které se objeví až na posledním kroku, místo druhého navigačního řádku uvnitř panelu. Wizard pojmenujte, když můžou být oba modaly možnosti otevřené naráz: patička a wizard se najdou právě podle toho názvu.

Konfigurace modalu možnosti

Ani jeden modal možnosti není zvláštní případ: oba se konfigurují přes stejný objekt Modal, jaký používají action modaly, takže nadpis, popis, ikona, šířka, chování při zavírání, sticky chrome i popisky obou tlačítek žijí na jednom místě.

use NyonCode\WireCore\Modals\Modal;
 
Select::make('category_id')
    ->options(fn () => Category::pluck('name', 'id')->all())
    ->createOptionForm([TextInput::make('name')->required()])
    ->createOptionUsing(fn (array $data) => Category::create($data)->getKey())
    ->createOptionModal(fn (Modal $modal) => $modal   
        ->heading('Nová kategorie')
        ->description('Bude vybratelná, jakmile ji uložíte.')
        ->icon('outline:folder-plus')
        ->width('2xl')
        ->closeOnClickAway(false)
        ->stickyFooter()
        ->submitLabel('Vytvořit kategorii')
        ->cancelLabel('Zahodit'))                     
    ->editOptionModal(fn (Modal $modal) => $modal->width('xl'))

Callback konfiguruje modal na místě; vrácený Modal ho nahradí celý. Běží při definici schématu, ne jednou za render, takže text závislý na stavu jde přes closure podporu samotného configu — $modal->heading(fn (Select $field) => …), vyhodnocenou s polem jako kontextem.

createOptionModalHeading() / createOptionModalWidth() a jejich editOption… dvojčata zůstávají jako zkratky a zapisují do téhož objektu, takže se dva způsoby nastavení nadpisu nemůžou rozejít. Šířka bere case ModalWidth nebo jeho token (sm…7xl, full); neznámý token spadne na md a nenakonfigurovaný modal následuje wire-core.modals.default_width jako každý jiný modal.

id modalu, wire:model a zavírací akce konfigurovatelné záměrně nejsou. Klíčují teleport, podle kterého Livewire morfuje, a oba modaly možnosti můžou být namountované najednou — id nastavené volajícím by nechalo jejich obsah prohodit.

Reaktivita

Combobox se váže deferred ve výchozím stavu. Přidejte live(), když na výběr reagují jiná pole — afterStateUpdated(), visibleWhen() souseda nebo Form::live() — aby se výběr možnosti synchronizoval na server při kliknutí místo čekání na další roundtrip:

Select::make('type')
    ->options([...])
    ->live()
    ->afterStateUpdated(fn ($state, $set) => $set('label', ucfirst((string) $state)))

Multi-select

Select::make('tags')
    ->multiple()
    ->maxItems(5)
    ->minItems(1)
    ->options([...])

Relace

Select::make('author_id')
    ->relationship('author', 'name')
    ->searchable()

Nativní vs vlastní

Každý Select se ve výchozím stavu vykresluje přes vlastní combobox, takže searchable a non-searchable selecty sdílejí jeden design — searchable() jen přidá in-panel search input. Použijte native() pro nativní <select> element prohlížeče.

Select::make('country')
    ->searchable()      // combobox se search inputem
    ->native()          // vynutit nativní <select> prohlížeče

Boolean select

Select::make('active')
    ->boolean()         // Možnosti Ano/Ne

Zakázané možnosti

Vykreslit konkrétní možnosti jako nevybíratelné:

Select::make('status')
    ->options([
        'draft'     => 'Draft',
        'review'    => 'In Review',
        'published' => 'Published',
        'archived'  => 'Archived',
    ])
    ->disabledOptions(['archived'])

Dynamicky zakázané možnosti:

Select::make('tier')
    ->options(Plan::pluck('name', 'id')->toArray())
    ->disabledOptions(fn () => Plan::unavailable()->pluck('id')->toArray())

Metody

Popisek, hint, tooltip a další sdílené metody viz Společné API pole.