Core

Foundation

Sdílené traity, které skládá každá komponenta, základní třídy pod nimi a support utility, po kterých sahá obojí.

Na této stránce

Concerny (traity)
Konfigurace komponenty
Stav a chování
Infrastruktura
Specifické pro akce
Vyhodnocování closur
Základní třídy
Support utility
V této sekci
Související

Foundation je trvalé jádro wire-core: vrstva, kterou nic nad ní nesmí měnit a ze které je všechno nad ní postavené. Pole, sloupec, akce a widget jsou různé objekty, které odpovídají na tytéž otázky — jaký má popisek, ikonu, barvu, velikost, jestli je vidět — a odpovídají na ně stejnými traity. Proto se ten slovník vyplatí naučit jednou.

Concerny (traity)

Konfigurace komponenty

Trait	Metody	Popis
`HasLabel`	`label($label)`, `translateLabel()`, `getLabel()`	Zobrazovací popisek
`HasDescription`	`description($text)`, `getDescription()`	Popisný text
`HasHelperText`	`helperText($text)`, `getHelperText()`	Helper text pod polem
`HasHint`	`hint($text)`, `hintIcon($icon)`, `getHint()`	Hint text/ikona
`HasName`	`name($name)`, `getName()`	Identifikátor
`HasDefault`	`default($value)`, `getDefault()`	Výchozí hodnota
`HasIcon`	`icon($name, $position)`, `getIcon()`	Ikona podle názvu (`pencil` nebo `prefix:name`)
`HasColor`	`color($color)`, `getColor()`	Název Tailwind barvy
`HasSize`	`size($size)`, `getSize()`	Varianta velikosti (sm/md/lg/xl)
`HasColumns`	`columnSpan($span)`, `columnStart($start)`	Layout sloupců gridu
`HasExtraAttributes`	`extraAttributes(array $attrs)`	Libovolné HTML atributy
`HasSortOrder`	`sort($position)`, `getSort()`	Pozice ve vykreslovaném seznamu — položka menu, skupina menu. Ne řazení dotazu (`Column::sortable()`)

Stav a chování

Trait	Metody	Popis
`HasState`	`state($value)`, `getState()`, `live()`, `debounce($ms)`	Livewire vazba stavu
`HasVisibility`	`hidden($condition)`, `visible($condition)`, `isHidden()`	Podmíněná viditelnost
`HasDisabled`	`disabled($condition)`, `isDisabled()`	Disabled stav
`HasValidation`	`required()`, `rules($rules)`, `validationMessages($msgs)`	Validační pravidla

Infrastruktura

Trait	Metody	Popis
`HasMake`	`static make(...$args)`	Statická factory
`HasEvaluate`	`evaluate($value, $params)`	Vyhodnocení closura-nebo-hodnota s DI
`HasSchema`	`schema(array $components)`, `getSchema()`	Pole dětských komponent
`HasHtmlAttributes`	`htmlAttributes()`, `getHtmlAttributes()`	Sloučené HTML atributy
`EvaluatesClosures`	`evaluate($value, $record, ...)`	Per-záznam resolvování closur

Specifické pro akce

Trait	Metody	Popis
`HasDynamicProperties`	`resolve($record)`	Per-záznam resolvování vlastností
`HasKeyboardShortcut`	`keyboardShortcut($keys)`	Alpine.js klávesová vazba
`HasLifecycle`	`before($fn)`, `after($fn)`, `halt()`	Before/after hooky s halt
`HasLoadingState`	`loadingIndicator()`, `debounce($ms)`	UI stav načítání
`HasModal`	`requiresConfirmation()`, `modalHeading()`, `slideOver()`, ...	Konfigurace modalu

CSS třídy tlačítek/badge pocházejí z kanonických HasColor resolverů (viz Kanonické color resolvery), ne z mapy pro jednotlivé komponenty. HasButtonStyles zůstává jen jako deprecated alias.

Vyhodnocování closur

Všechny konfigurační metody přijímají skalární hodnoty i closury:

// Skalár
TextColumn::make('name')->label('Full Name');
 
// Closura — vyhodnocená pro každý záznam v době renderu
TextColumn::make('name')->label(fn (User $record) => "Name: {$record->name}");
 
// Closura s dependency injection
Action::make('edit')->hidden(fn (User $record, Table $table) => ! $table->isEditable());

Základní třídy

Třída	Namespace	Popis
`Component`	`Foundation\Components`	Abstraktní základ — `make()`, `name`, `key`
`ViewComponent`	`Foundation\Components`	Komponenta vykreslující Blade pohled
`LayoutComponent`	`Foundation\Components`	Komponenta s dětskou `schema()`

// Všechny komponenty používají vzor statické factory
$field = TextInput::make('email');
$column = TextColumn::make('name');
$action = Action::make('delete');

Support utility

Třída	Popis
`EvaluatesClosures`	Trait — vyhodnocuje closura-nebo-hodnota s injekcí parametrů
`ArrayDotHelper`	Přístup tečkovou notací: `get('user.name', $array)`, `set()`, `has()`, `forget()`
`EnumResolver`	Statický — kanonický normalizér enum/pole (`scalar`, `label`, `display`, `color`, `icon`, `options`)

V této sekci

Stránka	Co pokrývá
Ikony	Ikonový slovník, vlastní ikony a použití několika sad naráz
Barvy	Kanonický resolver, kterým prochází každý barevný povrch
Enumy	Kontrakty, díky kterým si enum pojmenuje vlastní popisek, barvu a ikonu
Blade komponenty	Samostatné `<x-wire::*>` komponenty a layoutové vedle nich

Související

Wire Core — jak jsou tyhle moduly navrstvené
Motivy a přizpůsobení — jak přizpůsobit to, co je definované tady
Schéma — layoutový slovník postavený na těchhle concernech
Pluginy — registrace vlastních věcí do stejných registrů