NOTE: This is a static archive copy of STWiki. The site can no longer be edited.

JQueryUIDialog

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.

Button Click Actions

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
width width of the dialog 300
height height of the dialog auto
auto-open boolean flag to either open the dialog when loaded (true) or delay opening it until the user says so (false) false
draggable boolean flag to make the dialog draggable false
resizable boolean flag to make the dialog resizable false
close-on-escape boolean flag to let the user close the dialog using the ESC key false
show animation to be used to display the dialog fade
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

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

Name:
Password:
Come on in Never mind

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.
Topic revision: r1 - 30 Jan 2017, ProjectContributor
This site is powered by FoswikiCopyright © by the contributing authors. All material on this site is the property of the contributing authors.
Ideas, requests, problems regarding STWiki? Send feedback