Summary
Homepage:
http://api.jqueryui.com/dialog/
Author(s): see
http://jqueryui.com/about
Version: 1.12.0
A dialog is a floating window that contains a title bar and a content area. The dialog window can be moved, resized and closed with the 'x' icon by default.
If the content length exceeds the maximum height, a scrollbar will automatically appear.
A bottom button bar and semi-transparent modal overlay layer are common options that can be added.
A call to
$(foo).dialog()
will initialize a dialog instance and will auto-open the dialog by default. If you want to reuse a dialog, the easiest way is to disable the "auto-open" option with:
$(foo).dialog({ autoOpen: false })
and open it with
$(foo).dialog('open')
. To close it, use
$(foo).dialog('close')
.
Usage
To load the library into the current wiki page, add this somewhere on the page:
%JQREQUIRE{"ui::dialog"}%
This will initialize the following css classes to build the dialog widgets:
-
jqUIDialog
: dialog definition
-
jqUIDialogLink
: anchor pointing to a dialog
-
jqUIDialogButton
: buttons to be added to the dialog
Dialogs can be created inline or loaded on demand. The basic skeleton of a dialog definition looks like
<div class="jqUIDialog" id="mydialog" title="Here's the title of the dialog" >
Here goes the content.
...
<a class="jqUIDialogButton jqUIDialogClose" data-icon="ui-icon-circle-check">%MAKETEXT{"Ok"}%</a>
<a class="jqUIDialogButton jqUIDialogClose" data-icon="ui-icon-cancel">%MAKETEXT{"Cancel"}%</a>
</div>
... which is activated by something like this:
<a href="#mydialog" class="jqUIDialogLink">Open Dialog</a>
A dialog can also be opened using JavaScript:
jQuery("#mydialog").dialog("open");
To load a dialog asynchronously use a fully quallified hyperref as in
<a href="http://...." class="jqUIDialogLink">Open Dialog</a>
This will fetch the content of the dialog from the given url and add it to the page before opening it.
When the button is clicked:
- If the <a> element has the
jqUIDialogClose
class, then the dialog box will close.
- If the <a> element has the
jqUIDialogDestroy
class, then the dialog box will closed and destroyed (removed from DOM).
- If the <a> element has the
jqUIDialogSubmit
class, then a form defined in the dialog box will be submitted.
- If the <a> element has an href attribute, then the specified page will be loaded.
Parameters
Parameters can be set using HTML5 data (
data-<name>
)
Name |
Description |
Default |
auto-open |
boolean flag to either open the dialog when loaded (true) or delay opening it until the user says so (false) |
false |
close-on-escape |
boolean flag to let the user close the dialog using the ESC key |
false |
draggable |
boolean flag to make the dialog draggable |
false |
height |
height of the dialog |
auto |
hide |
animation to be used to hide the dialog |
|
modal |
If set to true, the dialog will have modal behavior; other items on the page will be disabled (i.e. cannot be interacted with). Modal dialogs create an overlay below the dialog but above other page elements. |
false |
position |
Specifies where the dialog should be displayed, e.g. 'center', 'left', 'right', 'top', 'bottom', [350,100], ['right','top'] |
center |
resizable |
boolean flag to make the dialog resizable |
false |
show |
animation to be used to display the dialog |
fade |
width |
width of the dialog |
300 |
See the plugin's homepage for more.
Events
Events are fired on different occasions during the lifetime of a dialog.
Name |
Event |
Description |
create |
dialogcreate |
This event is triggered when dialog is created |
open |
dialogopen |
This event is triggered when the dialog is opened. |
beforeClose |
dialogbeforeclose |
This event is triggered when a dialog attempts to close. If the beforeClose event handler (callback function) returns false, the close will be prevented. |
focus |
dialogfocus |
This event is triggered when the dialog gains focus. |
dragStart |
dialogdragstart |
This event is triggered at the beginning of the dialog being dragged. |
drag |
dialogdrag |
This event is triggered when the dialog is dragged. |
dragStop |
dialogdragstop |
This event is triggered after the dialog has been dragged. |
resizeStart |
dialogresizestart |
This event is triggered at the beginning of the dialog being resized. |
resize |
dialogresize |
This event is triggered when the dialog is resized. |
resizeStop |
dialogresizestop |
This event is triggered after the dialog has been resized. |
close |
dialogclose |
This event is triggered when the dialog is closed. |
A custom event handler can either be registered when creating the dialog:
<div class="jqUIDialog {open: functon() {myOpen.call(this);}}"></div>
... or by binding it afterwards using a jQuery way like
$("selector").bind(event, function)
to register an event to a dom node.
<script>
$("#mydialog").bind("dialogclose", function() {
alert("got a dialogclose event");
});
</script>
Examples
Drop-down login dialog
Login
Dialog fetched asynchronously
Open Dialog
%STARTSECTION{"dialog"}%
<div title="From Ajax call" class="jqUIDialog" data-modal="true" data-resizable="true" data-draggable="true" data-height="300" data-width="600">
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore
et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip
ex ea commodo consequat.
<a class="jqUIDialogButton jqUIDialogClose" data-icon="ui-icon-circle-check">%MAKETEXT{"Ok"}%</a>
<a class="jqUIDialogButton jqUIDialogClose" data-icon="ui-icon-cancel">%MAKETEXT{"Cancel"}%</a>
</div>
%ENDSECTION{"dialog"}%
See
http://jqueryui.com/demos/dialog/ for more demos.