jquery-ui/ui/jquery.ui.dialog.js

762 lines
18 KiB
JavaScript
Raw Normal View History

/*!
* jQuery UI Dialog @VERSION
2012-07-04 13:08:08 +00:00
* http://jqueryui.com
2008-06-04 02:34:33 +00:00
*
2012-07-04 13:08:08 +00:00
* Copyright 2012 jQuery Foundation and other contributors
2012-08-09 14:13:24 +00:00
* Released under the MIT license.
* http://jquery.org/license
*
2012-09-26 23:06:20 +00:00
* http://api.jqueryui.com/dialog/
2008-06-04 02:34:33 +00:00
*
* Depends:
* jquery.ui.core.js
2010-02-03 23:30:37 +00:00
* jquery.ui.widget.js
* jquery.ui.button.js
* jquery.ui.draggable.js
* jquery.ui.mouse.js
* jquery.ui.position.js
* jquery.ui.resizable.js
2008-06-04 02:34:33 +00:00
*/
(function( $, undefined ) {
2008-06-04 02:34:33 +00:00
var uiDialogClasses = "ui-dialog ui-widget ui-widget-content ui-corner-all ui-front ",
sizeRelatedOptions = {
buttons: true,
height: true,
maxHeight: true,
maxWidth: true,
minHeight: true,
minWidth: true,
width: true
},
resizableRelatedOptions = {
maxHeight: true,
maxWidth: true,
minHeight: true,
minWidth: true
};
2008-06-04 02:34:33 +00:00
$.widget("ui.dialog", {
version: "@VERSION",
options: {
autoOpen: true,
buttons: {},
closeOnEscape: true,
2010-12-18 00:53:22 +00:00
closeText: "close",
dialogClass: "",
draggable: true,
hide: null,
2010-12-18 00:53:22 +00:00
height: "auto",
maxHeight: false,
maxWidth: false,
minHeight: 150,
minWidth: 150,
modal: false,
position: {
2010-12-18 00:53:22 +00:00
my: "center",
at: "center",
of: window,
2010-12-18 00:53:22 +00:00
collision: "fit",
// ensure that the titlebar is never outside the document
2010-12-18 00:53:22 +00:00
using: function( pos ) {
var topOffset = $( this ).css( pos ).offset().top;
if ( topOffset < 0 ) {
$( this ).css( "top", pos.top - topOffset );
}
}
},
resizable: true,
show: null,
title: null,
2012-10-27 15:07:13 +00:00
width: 300,
// callbacks
beforeClose: null,
close: null,
drag: null,
dragStart: null,
dragStop: null,
focus: null,
open: null,
resize: null,
resizeStart: null,
resizeStop: null
},
2010-07-16 12:54:50 +00:00
_create: function() {
2010-12-18 00:53:22 +00:00
this.originalTitle = this.element.attr( "title" );
this.options.title = this.options.title || this.originalTitle;
2012-04-19 01:57:51 +00:00
this.oldPosition = {
parent: this.element.parent(),
index: this.element.parent().children().index( this.element )
};
this._createWrapper();
this.element
.show()
.removeAttr( "title" )
.addClass( "ui-dialog-content ui-widget-content" )
.appendTo( this.uiDialog );
2010-12-18 00:53:22 +00:00
this._createTitlebar();
this._createButtonPane();
if ( this.options.draggable && $.fn.draggable ) {
this._makeDraggable();
2010-03-12 01:10:57 +00:00
}
if ( this.options.resizable && $.fn.resizable ) {
this._makeResizable();
2010-03-12 01:10:57 +00:00
}
this._isOpen = false;
},
2010-07-16 12:54:50 +00:00
_init: function() {
if ( this.options.autoOpen ) {
this.open();
}
2008-06-04 02:34:33 +00:00
},
_destroy: function() {
var next,
oldPosition = this.oldPosition;
this._destroyOverlay();
this.element
.removeUniqueId()
2010-12-18 00:53:22 +00:00
.removeClass( "ui-dialog-content ui-widget-content" )
.hide()
// without detaching first, the following becomes really slow
.detach();
this.uiDialog.remove();
if ( this.originalTitle ) {
this.element.attr( "title", this.originalTitle );
2010-03-12 01:10:57 +00:00
}
2012-04-19 01:57:51 +00:00
next = oldPosition.parent.children().eq( oldPosition.index );
// Don't try to place the dialog next to itself (#8613)
if ( next.length && next[ 0 ] !== this.element[ 0 ] ) {
next.before( this.element );
} else {
oldPosition.parent.append( this.element );
2012-04-19 01:57:51 +00:00
}
2008-09-14 14:49:28 +00:00
},
2010-07-16 12:54:50 +00:00
widget: function() {
return this.uiDialog;
},
disable: $.noop,
enable: $.noop,
2010-12-18 00:53:22 +00:00
close: function( event ) {
var that = this;
2012-04-02 23:12:21 +00:00
if ( !this._isOpen ) {
return;
}
if ( this._trigger( "beforeClose", event ) === false ) {
return;
}
this._isOpen = false;
this._destroyOverlay();
if ( !this.opener.filter( ":focusable" ).focus().length ) {
// Hiding a focused element doesn't trigger blur in WebKit
// so in case we have nothing to focus on, explicitly blur the active element
// https://bugs.webkit.org/show_bug.cgi?id=47182
$( this.document[ 0 ].activeElement ).blur();
}
this._hide( this.uiDialog, this.options.hide, function() {
that._trigger( "close", event );
});
2008-09-14 14:49:28 +00:00
},
2008-09-14 14:49:28 +00:00
isOpen: function() {
return this._isOpen;
},
moveToTop: function() {
this._moveToTop();
},
_moveToTop: function( event, silent ) {
var moved = !!this.uiDialog.nextAll( ":visible" ).insertBefore( this.uiDialog ).length;
if ( !silent && moved ) {
this._trigger( "focus", event );
2010-03-12 01:10:57 +00:00
}
return moved;
2008-09-29 13:08:14 +00:00
},
open: function() {
2010-12-18 00:53:22 +00:00
if ( this._isOpen ) {
if ( this._moveToTop() ) {
this._focusTabbable();
}
2010-12-18 00:53:22 +00:00
return;
}
this.opener = $( this.document[ 0 ].activeElement );
this._size();
this._position();
this._createOverlay();
this._moveToTop( null, true );
2012-11-15 22:55:15 +00:00
this._show( this.uiDialog, this.options.show );
this._focusTabbable();
this._isOpen = true;
this._trigger( "open" );
this._trigger( "focus" );
return this;
},
_focusTabbable: function() {
// set focus to the first match:
// 1. first element inside the dialog matching [autofocus]
// 2. tabbable element inside the content element
// 3. tabbable element inside the buttonpane
// 4. the close button
// 5. the dialog itself
var hasFocus = this.element.find( "[autofocus]" );
if ( !hasFocus.length ) {
hasFocus = this.element.find( ":tabbable" );
if ( !hasFocus.length ) {
hasFocus = this.uiDialogButtonPane.find( ":tabbable" );
if ( !hasFocus.length ) {
hasFocus = this.uiDialogTitlebarClose.filter( ":tabbable" );
if ( !hasFocus.length ) {
hasFocus = this.uiDialog;
}
}
}
}
hasFocus.eq( 0 ).focus();
2008-09-14 14:49:28 +00:00
},
_keepFocus: function( event ) {
function checkFocus() {
var activeElement = this.document[ 0 ].activeElement,
isActive = this.uiDialog[ 0 ] === activeElement ||
$.contains( this.uiDialog[ 0 ], activeElement );
if ( !isActive ) {
this._focusTabbable();
}
}
event.preventDefault();
checkFocus.call( this );
// support: IE
// IE <= 8 doesn't prevent moving focus even with event.preventDefault()
// so we check again later
this._delay( checkFocus );
},
_createWrapper: function() {
this.uiDialog = $( "<div>" )
.addClass( uiDialogClasses + this.options.dialogClass )
.hide()
.attr({
// setting tabIndex makes the div focusable
tabIndex: -1,
role: "dialog"
})
.appendTo( this.document[ 0 ].body );
this._on( this.uiDialog, {
keydown: function( event ) {
if ( this.options.closeOnEscape && !event.isDefaultPrevented() && event.keyCode &&
event.keyCode === $.ui.keyCode.ESCAPE ) {
event.preventDefault();
this.close( event );
return;
}
// prevent tabbing out of dialogs
if ( event.keyCode !== $.ui.keyCode.TAB ) {
return;
}
2012-11-16 09:55:11 +00:00
var tabbables = this.uiDialog.find( ":tabbable" ),
first = tabbables.filter( ":first" ),
last = tabbables.filter( ":last" );
if ( ( event.target === last[ 0 ] || event.target === this.uiDialog[ 0 ] ) && !event.shiftKey ) {
first.focus( 1 );
return false;
} else if ( ( event.target === first[ 0 ] || event.target === this.uiDialog[ 0 ] ) && event.shiftKey ) {
last.focus( 1 );
return false;
}
},
mousedown: function( event ) {
if ( this._moveToTop( event ) ) {
this._focusTabbable();
}
}
});
// We assume that any existing aria-describedby attribute means
// that the dialog content is marked up properly
// otherwise we brute force the content as the description
if ( !this.element.find( "[aria-describedby]" ).length ) {
this.uiDialog.attr({
"aria-describedby": this.element.uniqueId().attr( "id" )
});
}
},
_createTitlebar: function() {
var uiDialogTitle;
this.uiDialogTitlebar = $( "<div>" )
.addClass( "ui-dialog-titlebar ui-widget-header ui-corner-all ui-helper-clearfix" )
.prependTo( this.uiDialog );
this._on( this.uiDialogTitlebar, {
mousedown: function( event ) {
// Don't prevent click on close button (#8838)
// Focusing a dialog that is partially scrolled out of view
// causes the browser to scroll it into view, preventing the click event
if ( !$( event.target ).closest( ".ui-dialog-titlebar-close" ) ) {
// Dialog isn't getting focus when dragging (#8063)
this.uiDialog.focus();
}
}
});
this.uiDialogTitlebarClose = $( "<button></button>" )
.button({
label: this.options.closeText,
icons: {
primary: "ui-icon-closethick"
},
text: false
})
.addClass( "ui-dialog-titlebar-close" )
.appendTo( this.uiDialogTitlebar );
this._on( this.uiDialogTitlebarClose, {
"click": function( event ) {
event.preventDefault();
this.close( event );
}
});
uiDialogTitle = $( "<span>" )
.uniqueId()
.addClass( "ui-dialog-title" )
.prependTo( this.uiDialogTitlebar );
this._title( uiDialogTitle );
this.uiDialog.attr({
"aria-labelledby": uiDialogTitle.attr( "id" )
});
},
_title: function( title ) {
if ( !this.options.title ) {
title.html( "&#160;" );
}
title.text( this.options.title );
},
_createButtonPane: function() {
var uiDialogButtonPane = ( this.uiDialogButtonPane = $( "<div>" ) )
.addClass( "ui-dialog-buttonpane ui-widget-content ui-helper-clearfix" );
this.uiButtonSet = $( "<div>" )
.addClass( "ui-dialog-buttonset" )
.appendTo( uiDialogButtonPane );
this._createButtons();
},
_createButtons: function() {
var that = this,
buttons = this.options.buttons;
// if we already have a button pane, remove it
this.uiDialogButtonPane.remove();
this.uiButtonSet.empty();
if ( !$.isEmptyObject( buttons ) ) {
2010-12-18 00:53:22 +00:00
$.each( buttons, function( name, props ) {
var click, buttonOptions;
props = $.isFunction( props ) ?
{ click: props, text: name } :
props;
// Default to a non-submitting button
props = $.extend( { type: "button" }, props );
// Change the context for the click callback to be the main element
click = props.click;
props.click = function() {
click.apply( that.element[0], arguments );
};
buttonOptions = {
icons: props.icons,
text: props.showText
};
delete props.icons;
delete props.showText;
$( "<button></button>", props )
.button( buttonOptions )
.appendTo( that.uiButtonSet );
2008-09-14 14:49:28 +00:00
});
this.uiDialog.addClass( "ui-dialog-buttons" );
this.uiDialogButtonPane.appendTo( this.uiDialog );
} else {
this.uiDialog.removeClass( "ui-dialog-buttons" );
2008-09-14 14:49:28 +00:00
}
},
2008-09-14 14:49:28 +00:00
_makeDraggable: function() {
var that = this,
options = this.options;
2010-12-18 00:53:22 +00:00
function filteredUi( ui ) {
return {
position: ui.position,
offset: ui.offset
};
}
this.uiDialog.draggable({
2010-12-18 00:53:22 +00:00
cancel: ".ui-dialog-content, .ui-dialog-titlebar-close",
handle: ".ui-dialog-titlebar",
containment: "document",
start: function( event, ui ) {
$( this )
.addClass( "ui-dialog-dragging" );
that._trigger( "dragStart", event, filteredUi( ui ) );
2008-09-14 14:49:28 +00:00
},
2010-12-18 00:53:22 +00:00
drag: function( event, ui ) {
that._trigger( "drag", event, filteredUi( ui ) );
2008-09-14 14:49:28 +00:00
},
2010-12-18 00:53:22 +00:00
stop: function( event, ui ) {
options.position = [
ui.position.left - that.document.scrollLeft(),
ui.position.top - that.document.scrollTop()
2010-12-18 00:53:22 +00:00
];
$( this )
.removeClass( "ui-dialog-dragging" );
that._trigger( "dragStop", event, filteredUi( ui ) );
2008-09-14 14:49:28 +00:00
}
});
},
_makeResizable: function() {
var that = this,
options = this.options,
handles = options.resizable,
// .ui-resizable has position: relative defined in the stylesheet
// but dialogs have to use absolute or fixed positioning
position = this.uiDialog.css( "position" ),
2010-12-18 00:53:22 +00:00
resizeHandles = typeof handles === 'string' ?
2010-03-12 01:10:57 +00:00
handles :
2010-12-18 00:53:22 +00:00
"n,e,s,w,se,sw,ne,nw";
2010-12-18 00:53:22 +00:00
function filteredUi( ui ) {
return {
originalPosition: ui.originalPosition,
originalSize: ui.originalSize,
position: ui.position,
size: ui.size
};
}
this.uiDialog.resizable({
2010-12-18 00:53:22 +00:00
cancel: ".ui-dialog-content",
containment: "document",
alsoResize: this.element,
maxWidth: options.maxWidth,
maxHeight: options.maxHeight,
minWidth: options.minWidth,
minHeight: this._minHeight(),
handles: resizeHandles,
2010-12-18 00:53:22 +00:00
start: function( event, ui ) {
$( this ).addClass( "ui-dialog-resizing" );
that._trigger( "resizeStart", event, filteredUi( ui ) );
},
2010-12-18 00:53:22 +00:00
resize: function( event, ui ) {
that._trigger( "resize", event, filteredUi( ui ) );
},
2010-12-18 00:53:22 +00:00
stop: function( event, ui ) {
$( this ).removeClass( "ui-dialog-resizing" );
options.height = $( this ).height();
options.width = $( this ).width();
that._trigger( "resizeStop", event, filteredUi( ui ) );
}
})
2010-12-18 00:53:22 +00:00
.css( "position", position )
.find( ".ui-resizable-se" )
.addClass( "ui-icon ui-icon-grip-diagonal-se" );
},
_minHeight: function() {
var options = this.options;
2010-12-18 00:53:22 +00:00
if ( options.height === "auto" ) {
2010-03-12 01:10:57 +00:00
return options.minHeight;
} else {
2010-12-18 00:53:22 +00:00
return Math.min( options.minHeight, options.height );
2010-03-12 01:10:57 +00:00
}
},
_position: function() {
// need to show the dialog to get the actual offset in the position plugin
var isVisible = this.uiDialog.is( ":visible" );
2010-12-18 00:53:22 +00:00
if ( !isVisible ) {
2010-01-07 04:47:17 +00:00
this.uiDialog.show();
}
this.uiDialog.position( this.options.position );
2010-12-18 00:53:22 +00:00
if ( !isVisible ) {
2010-01-07 04:47:17 +00:00
this.uiDialog.hide();
}
2008-06-04 02:34:33 +00:00
},
_setOptions: function( options ) {
var that = this,
resizableOptions = {},
resize = false;
2010-07-16 12:54:50 +00:00
$.each( options, function( key, value ) {
that._setOption( key, value );
if ( key in sizeRelatedOptions ) {
resize = true;
}
if ( key in resizableRelatedOptions ) {
resizableOptions[ key ] = value;
}
});
if ( resize ) {
this._size();
this._position();
}
if ( this.uiDialog.is( ":data(ui-resizable)" ) ) {
this.uiDialog.resizable( "option", resizableOptions );
}
},
2010-12-18 00:53:22 +00:00
_setOption: function( key, value ) {
2012-04-02 23:12:21 +00:00
var isDraggable, isResizable,
uiDialog = this.uiDialog;
if ( key === "dialogClass" ) {
uiDialog
.removeClass( this.options.dialogClass )
.addClass( value );
}
if ( key === "disabled" ) {
return;
}
this._super( key, value );
if ( key === "buttons" ) {
this._createButtons();
}
if ( key === "closeText" ) {
this.uiDialogTitlebarClose.button({
// ensure that we always pass a string
label: "" + value
});
}
if ( key === "draggable" ) {
isDraggable = uiDialog.is( ":data(ui-draggable)" );
if ( isDraggable && !value ) {
uiDialog.draggable( "destroy" );
}
if ( !isDraggable && value ) {
this._makeDraggable();
}
}
if ( key === "position" ) {
this._position();
}
if ( key === "resizable" ) {
// currently resizable, becoming non-resizable
isResizable = uiDialog.is( ":data(ui-resizable)" );
if ( isResizable && !value ) {
uiDialog.resizable( "destroy" );
}
// currently resizable, changing handles
if ( isResizable && typeof value === "string" ) {
uiDialog.resizable( "option", "handles", value );
}
// currently non-resizable, becoming resizable
if ( !isResizable && value !== false ) {
this._makeResizable();
}
}
if ( key === "title" ) {
this._title( this.uiDialogTitlebar.find( ".ui-dialog-title" ) );
2008-09-14 14:49:28 +00:00
}
},
_size: function() {
2012-10-29 18:37:06 +00:00
// If the user has resized the dialog, the .ui-dialog and .ui-dialog-content
// divs will both have width and height set, so we need to reset them
var nonContentHeight, minContentHeight,
options = this.options;
// reset content sizing
this.element.show().css({
2010-12-18 00:53:22 +00:00
width: "auto",
minHeight: 0,
height: 0
});
2010-12-18 00:53:22 +00:00
if ( options.minWidth > options.width ) {
options.width = options.minWidth;
}
// reset wrapper sizing
// determine the height of all the non-content elements
2010-03-12 01:10:57 +00:00
nonContentHeight = this.uiDialog.css({
2010-12-18 00:53:22 +00:00
height: "auto",
width: options.width
})
.outerHeight();
minContentHeight = Math.max( 0, options.minHeight - nonContentHeight );
if ( options.height === "auto" ) {
this.element.css({
minHeight: minContentHeight,
height: "auto"
});
} else {
this.element.height( Math.max( options.height - nonContentHeight, 0 ) );
}
if (this.uiDialog.is( ":data(ui-resizable)" ) ) {
2010-12-18 00:53:22 +00:00
this.uiDialog.resizable( "option", "minHeight", this._minHeight() );
2010-03-12 01:10:57 +00:00
}
},
2008-06-04 02:34:33 +00:00
_createOverlay: function() {
if ( !this.options.modal ) {
return;
}
if ( $.ui.dialog.overlay.instances.length === 0 ) {
// prevent use of anchors and inputs
// we use a setTimeout in case the overlay is created from an
// event that we're going to be cancelling (see #2804)
setTimeout(function() {
// handle $(el).dialog().dialog('close') (see #4065)
if ( $.ui.dialog.overlay.instances.length ) {
$( document ).bind( "focusin.dialog-overlay", function( event ) {
if ( !$( event.target ).closest( ".ui-dialog").length ) {
event.preventDefault();
$( ".ui-dialog:visible:last .ui-dialog-content" ).data( "ui-dialog" )._focusTabbable();
}
});
}
}, 1 );
}
2012-05-07 13:57:18 +00:00
// reuse old instances due to IE memory leak with alpha transparency (see #5185)
var $el = this.overlay = ( $.ui.dialog.overlay.oldInstances.pop() || $( "<div>" ).addClass( "ui-widget-overlay ui-front" ) );
2012-05-07 13:57:18 +00:00
$el.appendTo( document.body );
this._on( $el, {
mousedown: "_keepFocus"
});
$.ui.dialog.overlay.instances.push( $el );
2008-06-04 02:34:33 +00:00
},
_destroyOverlay: function() {
if ( !this.options.modal ) {
return;
}
var indexOf = $.inArray( this.overlay, $.ui.dialog.overlay.instances );
2012-04-02 23:12:21 +00:00
2010-12-18 00:53:22 +00:00
if ( indexOf !== -1 ) {
$.ui.dialog.overlay.oldInstances.push( $.ui.dialog.overlay.instances.splice( indexOf, 1 )[ 0 ] );
}
if ( $.ui.dialog.overlay.instances.length === 0 ) {
2010-12-18 00:53:22 +00:00
$( [ document, window ] ).unbind( ".dialog-overlay" );
2008-06-04 02:34:33 +00:00
}
this.overlay.remove();
2008-06-04 02:34:33 +00:00
}
});
$.ui.dialog.overlay = {
instances: [],
oldInstances: []
};
2008-06-04 02:34:33 +00:00
// DEPRECATED
if ( $.uiBackCompat !== false ) {
// position option with array notation
// just override with old implementation
$.widget( "ui.dialog", $.ui.dialog, {
_position: function() {
var position = this.options.position,
myAt = [],
offset = [ 0, 0 ],
isVisible;
if ( position ) {
if ( typeof position === "string" || (typeof position === "object" && "0" in position ) ) {
myAt = position.split ? position.split( " " ) : [ position[ 0 ], position[ 1 ] ];
if ( myAt.length === 1 ) {
myAt[ 1 ] = myAt[ 0 ];
}
$.each( [ "left", "top" ], function( i, offsetPosition ) {
if ( +myAt[ i ] === myAt[ i ] ) {
offset[ i ] = myAt[ i ];
myAt[ i ] = offsetPosition;
}
});
position = {
my: myAt[0] + (offset[0] < 0 ? offset[0] : "+" + offset[0]) + " " +
myAt[1] + (offset[1] < 0 ? offset[1] : "+" + offset[1]),
at: myAt.join( " " )
};
}
position = $.extend( {}, $.ui.dialog.prototype.options.position, position );
} else {
position = $.ui.dialog.prototype.options.position;
}
// need to show the dialog to get the actual offset in the position plugin
isVisible = this.uiDialog.is( ":visible" );
if ( !isVisible ) {
this.uiDialog.show();
}
this.uiDialog.position( position );
if ( !isVisible ) {
this.uiDialog.hide();
}
}
});
}
2010-12-18 00:53:22 +00:00
}( jQuery ) );