krystal-sf/ux-bootbox

Bootbox Modals for Krystal Symfony Projects

1.0.x-dev 2026-08-04 23:01 UTC

Requires

• php: ^8.1
• krystal-sf/ux-blocks: ^1.0
• krystal-sf/ux-bootstrap-5: ^1.0
• krystal-sf/ux-common: ^1.0
• krystal-sf/ux-menus: ^1.0

Requires (Dev)

• badpixxel/php-sdk: ^3.0
• krystal-sf/ux-notify: ^1.0
• phpunit/phpunit: ^10.0|^11.0
• symfony/debug-bundle: ^6.4|^7.4|^8.0
• symfony/monolog-bundle: ^3.0|^4.0
• symfony/stopwatch: ^6.4|^7.4|^8.0
• symfony/web-profiler-bundle: ^6.4|^7.4|^8.0

MIT

• BadPixxel

• symfony
• bootbox
• modals
• symfony-ux
• krystal-sf

Published on Packagist.org on 2026-08-04 23:01 UTC

README

Bootbox modals for Krystal Symfony UX Projects: confirmations, loading, progress and prompt dialogs driven by Live Components events.

Installation

composer require krystal-sf/ux-bootbox

Enable the bundle in config/bundles.php:

return [
    // ...
    Ksf\Plugins\Bootbox\KsfBootboxBundle::class => ['all' => true],
];

Usage

The Bootbox:Controller Live Component is registered as a Tagged Block on the standard HIDDEN_BOTTOM location — nothing to add in your templates.

Trigger dialogs from menus via the MenuFactory helpers of krystal-sf/ux-menus:

$this->factory->bootboxConfirmedController(
    MyAction::class,
    arguments: array("id" => 27),
    autoload: "bootbox.confirm",
    translationDomain: "MyDomain",
);

Or emit the events directly (all names in BootboxEvents dictionary):

• BootboxEvents::CONFIRM — confirmation dialog executing an action
• BootboxEvents::LOADING — blocking loading dialog
• BootboxEvents::PROGRESS — progress dialog with custom buttons
• BootboxEvents::CLOSE — close the current dialog

Static helpers in BootboxEventArgs build the menus options (createConfirm, createConfirmEvent, confirmArgs, progressArgs).

Testing

make up          # boot the docker stack
make phpunit     # run the test suite
make quality     # lint + style + phpstan

License

MIT — see LICENSE.