coins-jquery-ui-utilities

    2.0.6 • Public • Published

    coins-jquery-ui-utilities

    Codeship Status for MRN-Code/coins-jquery-ui-utilities

    Common GUI actions and objects, standardized and simplified for constructing jQ UI widget instances

    why

    So modals, buttons, datepickers, etc get created through a common interface to yield improved consistency through the FE app.

    interface

    button

    All button functions, accessible via .button.FUNCNAME accept a common set of options to override the default behavior.

    All button functions accept the options hash, and most provide some helpful defaults. Apply any button options usually fed the jQuery button API to the options hash. Additional actions supported are:

    • class ['string'] (default: 'default') - a button class to apply. see btnClasses
    • el [Element] - element to buttonize. If no element provided, the button config (see returnConfig) is returned by default
    • returnConfig [boolean] - return the button configuration object, vs the button instance
    • closeDialog booean - If button is fed to a dialog, buttons: [] array, the button will close the dialog after any click function has executed, and after any action function(s) have executed. This will auto-enable click regardless if no click is defined.
    • destroyDialog boolean - See closeDialog, but destroys widget instance
    • action [Function | [Function]] - additional action function(s) to be performed on button click. This will auto-enable click regardless if no click is defined. All actions are run synchronously.

    btnClasses

    String indexed hash of boostrap correllated classNames. Available classes are: 'default', 'danger', 'info', 'primary', 'success', 'warning'

    See jquery bootstrap classes.

    base

    All button constructors below utilize base. Can be used directly with above configurations as needed.

    close

    Sugar for a button titled "Close" that will attempt to close a Dialog instance on click.

    destroy

    Sugar for a button titled "Close" that will attempt to destroy a Dialog instance on click.

    delete

    Sugar for a red button titled "Delete" that ensures that a click or action attr is defined.

    dialog

    All dialog functions accept the options hash, and most provide some helpful defaults. Apply any dialog options usually fed the jQuery dialog API to the options hash. Additional actions supported are:

    base

    All dialog constructors below utilize base. Can be used directly with above configurations as needed. Close buttons in the button pane destroy the dialog by default.

    fail

    Generates a dialog with a default title of "Operation Failed", a friendly error message, and a red close button.

    api

    [Deprecated] Passed an api error, builds a fail dialog with details from the failed API call. Not recommended for use.

    This is a dated means of dependency management, however, until all COINS tools migrate to a FE DI system, it shall suffice.

    demo

    run npm run demo and open the posted url! demo/index.html should load with some helpful examples.

    changelog

    • 2.0.1/2/3 - fulfill 2.0.0 claim
    • 2.0.0 - require jquery and lodash individually. only consumed lodash fns are required into bundle
    • 1.1.1 - Force close handlers before destroy
    • 1.1.0 - Added destroy button and default dialog closing to destroy

    todo

    1. Formally deprecate ApiError

    Keywords

    none

    Install

    npm i coins-jquery-ui-utilities

    DownloadsWeekly Downloads

    2

    Version

    2.0.6

    License

    MIT

    Unpacked Size

    1.22 MB

    Total Files

    52

    Last publish

    Collaborators

    • cdaringe
    • dylancwood
    • jwtlake
    • mstone
    • swashcap