Dispatch an event to a modal being closed before closing it, so that the modal can prevent it based on its state

[osmianski]

This PR allows a modal to prevent closure on Escape or on click away based on its state.

The idea is that before closing the modal, an event is dispatched, and the modal can handle it and, if needed, prevent closing the modal.

For example, if a modal has a isDirty property, it could have the following handler:

@script
<script>
    $wire.on('closingModalOnEscape', data => {
        if ($wire.isDirty && !confirm('{{ __('You have unsaved changes. Are you sure you want to close this dialog?') }}')) {
            data.closing = false;
        }
    });
    $wire.on('closingModalOnClickAway', data => {
        if ($wire.isDirty && !confirm('{{ __('You have unsaved changes. Are you sure you want to close this dialog?') }}')) {
            data.closing = false;
        }
    });
</script>
@endscript

[osmianski]

Hey @PhiloNL,

What is your opinion of this PR?

I created it fo fulfill a client requirement in a project, so I'm really interested that it's merged. If you see that it needs some changes, please let me know - I'm willing to make them. In a word, please let me know how I can be of help with this.

[PhiloNL]

@osmianski thanks for the PR! Looks good :) If you could update the docs as well, that would be great 🙌

[osmianski]

I updated the docs.

[PhiloNL]

Thanks!