jantinnerezo/livewire-alert

v4.2.0 — Drive loading spinners and live alert updates straight from PHP

Three new methods give your Livewire components server-driven control over an open alert — no more close-and-reopen flicker.

✨ New

• asLoading(?string $title = null) — preset for non-dismissable spinne and backdrop clicks; triggers Swal.showLoading() on open. Default title'Loading...', override with a string argument.

LivewireAlert::title('Saving...')->asLoading()->show();

• close() — dismiss the current alert from the server.

LivewireAlert::close();

• update(?array $options = null) — mutate the open alert in place via Swal.update(). Two forms:

Fluent — only explicitly-set options emitted, config defaults not merged:

LivewireAlert::title('Almost done')->text('90%')->update();

Explicit payload:

LivewireAlert::update([
    'title' => 'Almost done',
    'text'  => '90%',
]);

No-op (with console warning) when no alert is visible. Guards run before calal` no longer throws.

🧩 Why this matters

Pair asLoading() + wire:poll + update() to drive Bus::batch() progreany phased task — all from PHP, with the alert updating live.

🛡 Contract

Alertable interface extended with the three new methods (additive — no break).

Full Changelog: v4.2.0...v4.2.0

Bug Fixes

• Fixed Livewire 4 compatibility - Resolved MethodNotFoundException: Public method [toJSON] not found on component when using the package with Livewire 4. The
  root cause was $wire.call() not being handled correctly by Livewire 4's $wire proxy. It now uses $wire[action]() which works on both Livewire 3 and 4.
  (#181)

New Methods

• timerProgressBar() - Show a visual countdown progress bar
• asToast() - Ready-to-use toast preset (top-end, timer from config, progress bar enabled)
• customClass(array $classes) - Apply custom CSS classes to any part of the alert
• reverseButtons() - Swap confirm and cancel button positions

Input Methods

Dedicated methods for collecting user input directly within an alert:

• withTextInput(), withEmailInput(), withPasswordInput(), withNumberInput(), withTextareaInput()
• withSelectInput(), withRadioInput(), withCheckboxInput(), withFileInput()

Added Livewire 4 support

What's Changed

• Update README.md by @jantinnerezo in #174
• Add native image option support by @yardsoul in #175

New Contributors

• @yardsoul made their first contribution in #175

Full Changelog: v4.0.6...v4.0.7

What's added?

• Added allowOutsideClick method with boolean type parameter "allowed" default is true
• Added allowEscapeKey method with boolean type parameter "allowed" default is true
• Allow null parameter type on timer method

Usage

For example, if you don't want to close alert on outside click, escape key and disable auto close.

LivewireAlert::question()
  ->title("Are you sure do you want to approve proposal?")
  ->allowOutsideClick(false) // new method
  ->allowEscapeKey(false) // new method
  ->timer(null) // You can pass null now instead of only integer and that disables auto closing

Full Changelog: 4.0.5...v4.0.6

• Added html function

LivewireAlert::title('New html function!')
 ->html("<p><strong>You should try it out!</strong></p>")
 ->show();

Full Changelog: v4.0.4...4.0.5

What's Changed

• Feat: add comments to the alert facade to phpstan and editors understand by @juanjoballesteros in #167

New Contributors

• @juanjoballesteros made their first contribution in #167

Full Changelog: v4.0.3...v4.0.4

What's Changed

• Fixed: onDeny method triggers onConfirm automatically by @jantinnerezo in #164

Full Changelog: v4.0.2...v4.0.3

• Fixed eval option typo

Full Changelog: v4.0.1...v4.0.2