Toaster

Toast notification system with auto-dismiss, multiple positions, and a full-width banner mode. The global appToaster is typically rendered in the shared layout.

Toast Types

Persistent Toast

// PHP: Render the toaster container (typically once in layout)
<?= $m->toaster('appToaster')->position('top-right') ?>

// Positions: top-right, top-left, bottom-right, bottom-left, banner

// Banner mode with initial message
<?= $m->toaster('bannerToaster')
    ->position('banner')
    ->initial('Deployment complete!', 'success') ?>

// Show toasts (from anywhere)
m.toaster('appToaster').show('Task saved!', 'success');
m.toaster('appToaster').show('Something went wrong.', 'error');
m.toaster('appToaster').show('Check your settings.', 'warning');
m.toaster('appToaster').show('New update available.', 'info');

// Persistent toast (duration: 0)
m.toaster('appToaster').show('Please review.', 'info', {duration: 0});

// Clear all toasts
m.toaster('appToaster').clearAll();

// Custom duration (ms)
m.toaster('appToaster').show('Quick!', 'success', {duration: 2000});

PHP PHP Methods (Fluent)

Method / Property	Parameters	Description
`$m->toaster($id)`	`string`	Create a toaster container.
`->position($pos)`	`string`	Position: `top-right`, `top-left`, `bottom-right`, `bottom-left`, `banner`.
`->initial($message, $type)`	`string, string`	Add a server-rendered initial message (banner mode). Type: `success`, `error`, `warning`, `info`.

JS JS Methods

Method / Property	Parameters	Description
`m.toaster(id, opts)`	`string, ?object`	Get or create toaster instance.
`show(message, type, opts)`	`string, string, ?object`	Show a toast. Type: `success`, `error`, `warning`, `info`. Options: `{duration: 5000}`.
`clearAll()`		Remove all active toasts.
`hide(toastElement)`	`HTMLElement`	Hide a specific toast.