Nine Parsecs from Milwaukee

    way2web.jquery.confirm

    2.7.4 • Public • Published

    jquery.confirm

    Confirm dialogs for buttons and links.

    NPM version Downloads

    Original package: Average time to resolve an issue Percentage of issues still open

    Chat room:

    Requirements

    If you use Bootstrap 2, you can use any 1.x version. From 2.0 and onwards, Bootstrap 3 is required.

    Installation

    The library can be downloaded manually or installed with npm:

    $ npm install way2web.jquery.confirm
    

    Usage

    <a href="home" class="confirm">Go to home</a>
    $(".confirm").confirm();

    Any click on the link will pop up a dialog asking the user to confirm the action.

    Options

    List of the options:

    • text: Text to display in the dialog
    • title: Title of the dialog (can be empty, the dialog will not have a header then)
    • confirm: Handler executed when the user confirms
    • cancel: Handler executed when the user cancels
    • confirmButton: Label of the confirm button
    • cancelButton: Label of the cancel button, if set to false no button at all.
    • post: If false (default) and no confirm handler is set, redirects the user to the URL of the button/link with a GET request. If true, redirects with a POST request (like a form submission).
    • submitForm: If false (default) it has no effect. If true, it submit the form target element.
    • confirmButtonClass: HTML class for the confirmation button, defaults to btn-primary.
    • cancelButtonClass: HTML class for the cancel button, defaults to btn-default.
    • dialogClass: HTML class for the dialog, defaults to modal-dialog.
    • modalOptionsBackdrop: Backdrop option for modal.
    • modalOptionsKeyboard: Keyboard option for bootsrap modal.

    Example:

    <button class="confirm" type="button">Delete the comment</button>
    $(".confirm").confirm({
        text: "Are you sure you want to delete that comment?",
        title: "Confirmation required",
        confirm: function(button) {
            delete();
        },
        cancel: function(button) {
            // nothing to do
        },
        confirmButton: "Yes I am",
        cancelButton: "No",
        post: true,
        confirmButtonClass: "btn-danger",
        cancelButtonClass: "btn-default",
        dialogClass: "modal-dialog modal-lg" // Bootstrap classes for large modal
    });

    You can also use data- attributes to customize the confirmation dialog:

    <button class="confirm" type="button"
            data-text="Do you really want to delete that comment?"
            data-confirm-button="Yes I am"
            data-cancel-button="Whoops no">
        Delete the user
    </button>
    $(".confirm").confirm();

    Manual triggering

    You can manually trigger the confirmation dialog:

    // Will immediately show the confirmation popup
    $.confirm({
        text: "Are you sure you want to delete that comment?",
        confirm: function() {
            delete();
        },
        cancel: function() {
            // nothing to do
        }
    });

    Remember that if you trigger the confirmation dialog manually, you must provide a confirm callback (as shown above).

    Global configuration

    You can configure some options globally, for example if you translate the messages:

    $.confirm.options = {
        text: "Are you sure?",
        title: "",
        confirmButton: "Yes",
        cancelButton: "Cancel",
        post: false,
        submitForm: false,
        confirmButtonClass: "btn-warning",
        cancelButtonClass: "btn-default",
        dialogClass: "modal-dialog"
    }

    Contributing

    Pull requests and bug reports are welcome! Be aware that you do not need to generate the minified version yourself, it will be generated by a release manager (for security reasons).

    Change log

    View the changelog.

    License

    This software is released under the MIT license.

    Install

    npm i way2web.jquery.confirm

    DownloadsWeekly Downloads

    802

    Version

    2.7.4

    License

    MIT

    Last publish

    Collaborators

    • pkeulers
    • johanvanhelden
    • elwinvaneede
    • tomw2w
    • w3news