Publikováno
· Autor: Zdeněk Hejzlar · Pod kapotou · Základy · 3 min čtení
Obsah článku
Chcete na stránce živý formulář nebo filtr, který reaguje bez obnovení — ale nechce se vám kvůli tomu učit celý JavaScriptový framework? Přesně pro tuhle situaci vznikl Livewire. Píšete komponenty v PHP a on se postará o to, aby se frontend aktualizoval sám.
Jak Livewire funguje
Komponenta má dvě části: PHP třídu s daty a metodami a Blade šablonu. Když uživatel něco udělá, Livewire pošle na Laravel požadavek, znovu vykreslí komponentu a vrátí jen změněný kus stránky. Vy nepíšete žádné volání API ani obsluhu událostí v JS.
V pozadí přitom nějaký JavaScript samozřejmě běží — Livewire ho obstarává za vás a přidává trochu kouzla přes knihovnu Alpine.js. Vy ale zůstáváte v PHP, což je pro backendového vývojáře obrovská úleva. Nemusíte přepínat mezi dvěma jazyky a držet stav na dvou místech zároveň. Novou komponentu vytvoříte příkazem php artisan make:livewire Pocitadlo, který založí rovnou třídu i její šablonu.
Za zmínku stojí, jak Livewire řeší stav. Veřejné vlastnosti komponenty se mezi požadavky pamatují — putují tam a zpět jištěné kontrolním součtem proti podvržení, takže mezikrok nemusíte řešit vy. Právě proto působí komponenta jako obyčejný objekt, i když ve skutečnosti žije rozprostřená mezi prohlížečem a serverem. Tenhle model má svá pravidla (vlastnosti musí být jednoduché typy nebo modely), ale jakmile mu přijdete na chuť, píše se v něm rychle a příjemně.
První komponenta
Ukažme si počítadlo. V třídě je veřejná vlastnost a dvě metody:
class Pocitadlo extends Component
{
public int $pocet = 0;
public function pridej(): void
{
$this->pocet++;
}
public function render(): \Illuminate\View\View
{
return view('livewire.pocitadlo');
}
}
Šablona se na metodu naváže přes wire:click. Hodnota $pocet se aktualizuje sama:
<div>
<h2>{{ $pocet }}</h2>
<button wire:click="pridej">Přidej</button>
</div>
Do stránky komponentu vložíte jako <livewire:pocitadlo />. A je hotovo — funkční tlačítko bez jediného řádku vlastního JavaScriptu. Veřejné vlastnosti třídy jsou přitom automaticky dostupné v šabloně, takže mezi PHP a HTML nemusíte data ručně přenášet. Právě tahle přímočarost dělá z Livewiru tak příjemný nástroj.
Vazba na formulář a validace
Nejsilnější je Livewire u formulářů. Přes wire:model propojíte vstup s vlastností a data máte v PHP okamžitě k dispozici:
public string $email = '';
public function odesli(): void
{
$this->validate([
'email' => 'required|email',
]);
// uložení...
}
<input type="email" wire:model="email">
<span>@error('email') {{ $message }} @enderror</span>
<button wire:click="odesli">Odeslat</button>
wire:modeldrží hodnotu synchronizovanou mezi vstupem a PHP.- Validace běží stejně jako jinde v Laravelu.
- Chybové hlášky vypíšete přes
@errorpřímo v šabloně.
Kdy Livewire a kdy ne
Buďme upřímní: Livewire posílá požadavky na server při každé interakci. Pro administrace, formuláře a středně živé stránky je to skvělé. Pokud ale stavíte hru nebo editor, kde se musí reagovat okamžitě a offline, sáhněte po klasickém JavaScriptu. Je to o volbě podle situace, ne o tom, že by jedno bylo lepší. Pro naprostou většinu firemních webů a administrací ale platí, že Livewire ušetří spoustu času i řádků kódu.
Livewire skvěle ladí s Filamentem, který na něm stojí — základy najdete v článku Filament resource od nuly. A aby vaše šablony u živých komponent zůstaly přehledné, rozdělujte je na malé, znovupoužitelné části.
Chcete na web přidat živé prvky bez zbytečné složitosti? Napište mi, rád vám poradím s návrhem.