Notifikace

Notifikace je nejdřív hodnotový objekt a až potom doručení: popíšete, co se stalo — titulek, text, barva, ikona, případně akce — a kam to dopadne, rozhodne driver. Výměna driveru nemění na volajícím kódu nic, a právě proto může být tentýž řádek toastem v prohlížeči i řádkem v databázi.

Drivery

Vestavěný výchozí je CurrentComponentDriver obalující SessionDriver: sám resolvuje právě renderovanou Livewire komponentu, takže call-sites nikdy nemusí předávat $this. SessionDriver i LivewireEventDriver forwardují plný payload (title, duration, icon, actions, …), takže bohaté toasty přežijí server round-trip.

Který driver na co?

Které drivery krmí toast kontejner? <x-wire-notifications::toast-container /> naslouchá Livewire browser události, takže ho dosáhnou drivery odesílající události: výchozí CurrentComponentDriver, SessionDriver a LivewireEventDriver — všechny forwardují plný title/duration/icon/actions payload. FlasherDriver vykresluje vlastní UI a kontejner obchází; NullDriver nezobrazí nic.

Vykreslí i to, co najde flashnuté, což je táž notifikace, jen druhou cestou. Viz Toasty, které přežijí stránku — právě díky tomu se vůbec ohlásí successRedirect() u akce nebo stránka se založením, která dopadne na právě podaný záznam.

Notification builder

Notification je immutable hodnotový objekt. Vytvořte přes statickou factory, pak odešlete přes NotificationManager.

use NyonCode\WireCore\Notifications\Notification;
use NyonCode\WireCore\Notifications\NotificationManager;
 
// Zkratkové factory — vytvořit a odeslat okamžitě
NotificationManager::success('User saved');
NotificationManager::error('Failed to delete');
 
// Sestavit notifikaci, pak odeslat
$notification = Notification::success('The user was successfully updated.')
    ->title('Record Saved');
 
NotificationManager::send($notification);
 
// Plné přizpůsobení
$notification = Notification::make('success', 'Changes saved.')
    ->title('Done')
    ->icon('check')
    ->duration(5000)            // ms, 0 = trvalé
    ->position('top-right')     // top-right, top-left, bottom-right, bottom-left
    ->extra(['link' => '/details']);
 
NotificationManager::send($notification);

API Notification

Statické factory — každá vrací novou Notification:

Notification::make(string $type, string $message): static
Notification::success(string $message): static
Notification::error(string $message): static
Notification::warning(string $message): static
Notification::info(string $message): static

Fluent modifikátory. Objekt je immutable, takže každý vrací novou instanci:

->title(?string $title): static
->duration(?int $ms): static      // čas automatického zavření, 0 = trvalé
->persistent(bool $on = true): static   // sticky toast: duration 0, bez odpočtové lišty
->icon(?string $icon): static
->position(?string $position): static
->extra(array $data): static      // libovolná extra data (sloučená)
->url(?string $url): static       // kam vede — faktura, ne notifikace
->to(?Model $notifiable): static  // komu patří; přebíjí ResolvesNotifiable
->action(NotificationAction|string $action, ?string $event = null): static
->actions(array $actions): static      // nahradit sadu akčních tlačítek
->toArray(): array                // jen payload — nikdy příjemce

Akční tlačítka. Odkaz přežije uložení; událost potřebuje svého listenera na stránce, což notifikace otevřená za tři dny nemá důvod čekat:

NotificationAction::make(string $label, string $event): static
NotificationAction::link(string $label, string $url): static
->payload(array $payload): static      // pošle se s dispatchnutou událostí
->url(?string $url): static            // jít sem místo dispatche
->color(?string $color): static        // akcent tlačítka; jinak podle typu
->keepOpen(bool $keepOpen = true): static   // po kliknutí toast nezavírat

Odesílání. $livewire je volitelný — výchozí CurrentComponentDriver si aktivní komponentu resolvuje sám:

NotificationManager::send(Notification $n, ?NotificationDriver $driver = null, mixed $livewire = null): void
NotificationManager::sendTo(Model $notifiable, Notification $n, ...): void
NotificationManager::success(string $message, ...): void
NotificationManager::error(string $message, ...): void
NotificationManager::warning(string $message, ...): void
NotificationManager::info(string $message, ...): void

Konfigurace

// config/wire-core.php
return [
    'notifications' => [
        // session, livewire, flasher, database, broadcast, null — nebo seznam
        'default' => env('WIRE_NOTIFICATIONS_DRIVER', 'session'),
    ],
];

Tato config hodnota řídí container-bound NotificationDriver (resolvovaný service providerem pro constructor/app() injekci).

Pořadí resolvování driveru

Když zavoláte NotificationManager::send() (nebo jeho zkratky), driver se resolvuje v tomto pořadí:

1. Explicitní driver předaný do volání / komponenty (setNotificationDriver(), argument $driver)
2. Globální výchozí nastavený přes NotificationManager::setDefaultDriver()
3. Fallback: vestavěný CurrentComponentDriver obalující SessionDriver

Poznámka: statický NotificationManager nečte wire-core.notifications.default sám o sobě — ta config jen krmí container binding. Aby se nakonfigurovaný driver stal globálním výchozím pro statické API, přemostěte ho jednou v service provideru:

use NyonCode\WireCore\Notifications\Contracts\NotificationDriver;
use NyonCode\WireCore\Notifications\NotificationManager;
 
NotificationManager::setDefaultDriver(app(NotificationDriver::class));

V této sekci

Související

• Modul notifikací — hotová obrazovka s historií
• Akce — to, co notifikaci obvykle vyvolá
• Barvy a Ikony — slovník, kterým notifikace mluví
• Konfigurace — celý notifikační blok