Jquery UI dialog 详解 (中文)
- ·概述
- 一个浮动的窗口，包含标题和内容两部分。可以移动，调整大小，以及关闭图标'×'。
- 如果内容长度超过了对话框内容区域的显示，则会自动出现滚动条。
- 除此之外，还有一些常用的选项，如：添加底部按钮栏、模式窗口屏蔽层等。
- 官方示例地址：http://jqueryui.com/demos/dialog/
- ·参数（名称 : 参数类型 : 默认值）
- autoOpen : Boolean : true
- 如果设置为true，则默认页面加载完毕后，就自动弹出对话框；相反则处理hidden状态。
- 初始：$('.selector').dialog({ autoOpen: false });
- 获取：var autoOpen = $('.selector').dialog('option', 'autoOpen');
- 设置：$('.selector').dialog('option', 'autoOpen', false);
- bgiframe : Boolean : false
- 如果设置为true，则调用bgiframe插件，用于修复在IE6浏览器中无法显示于其它控件（select,flash）之上的问题。
- 初始：$('.selector').dialog({ bgiframe: true });
- 获取：var bgiframe = $('.selector').dialog('option', 'bgiframe');
- 设置：$('.selector').dialog('option', 'bgiframe', true);
- buttons : Object : { }
- 为对话框添加相应的按钮及处理函数。
- 初始：$('.selector').dialog({ buttons: { "Ok": function() { $(this).dialog("close"); } } });
- 获取：var buttons = $('.selector').dialog('option', 'buttons');
- 设置：$('.selector').dialog('option', 'buttons', { "Ok": function() { $(this).dialog("close"); } });
- closeOnEscape : Boolean : true
- 设置当对话框打开的时候，用户按ESC键是否关闭对话框。
- 初始：$('.selector').dialog({ closeOnEscape: false });
- 获取：var closeOnEscape = $('.selector').dialog('option', 'closeOnEscape');
- 设置：$('.selector').dialog('option', 'closeOnEscape', false);
- dialogClass : String : ''
- 设置指定的类名称，它将显示于对话框的标题处。
- 初始：$('.selector').dialog({ dialogClass: 'alert' });
- 获取：var dialogClass = $('.selector').dialog('option', 'dialogClass');
- 设置：$('.selector').dialog('option', 'dialogClass', 'alert');
- draggable : Boolean : true
- 如果设置为true，则允许拖动对话框的标题栏移动窗口。
- 初始：$('.selector').dialog({ draggable: false });
- 获取：var draggable = $('.selector').dialog('option', 'draggable');
- 设置：$('.selector').dialog('option', 'draggable', false);
- height : Number : 'auto'
- 设置对话框的高度（单位：像素）。
- 初始：$('.selector').dialog({ height: 530 });
- 获取：var height = $('.selector').dialog('option', 'height');
- 设置：$('.selector').dialog('option', 'height', 530);
- hide : String : null
- 使对话框关闭（隐藏），可添加动画效果。
- 初始：$('.selector').dialog({ hide: 'slide' });
- 获取：var hide = $('.selector').dialog('option', 'hide');
- 设置：$('.selector').dialog('option', 'hide', 'slide');
- maxHeight : Number : false
- 设置对话框的最大高度（单位：像素）。
- 初始：$('.selector').dialog({ maxHeight: 400 });
- 获取：var maxHeight = $('.selector').dialog('option', 'maxHeight');
- 设置：$('.selector').dialog('option', 'maxHeight', 400);
- maxWidth : Number : false
- 设置对话框的最大宽度（单位：像素）。
- 初始：$('.selector').dialog({ maxWidth: 600 });
- 获取：var maxWidth = $('.selector').dialog('option', 'maxWidth');
- 设置：$('.selector').dialog('option', 'maxWidth', 600);
- minHeight : Number : 150
- 设置对话框的最小高度（单位：像素）。
- 初始：$('.selector').dialog({ minHeight: 300 });
- 获取：var minHeight = $('.selector').dialog('option', 'minHeight');
- 设置：$('.selector').dialog('option', 'minHeight', 300);
- minWidth : Number : 150
- 设置对话框的最小宽度（单位：像素）。
- 初始：$('.selector').dialog({ minWidth: 400 });
- 获取：var minWidth = $('.selector').dialog('option', 'minWidth');
- 设置：$('.selector').dialog('option', 'minWidth', 400);
- modal : Boolean : false
- 是否为模式窗口。如果设置为true，则在页面所有元素之前有个屏蔽层。
- 初始：$('.selector').dialog({ modal: true });
- 获取：var modal = $('.selector').dialog('option', 'modal');
- 设置：$('.selector').dialog('option', 'modal', true);
- position : String, Array : 'center'
- 设置对话框的初始显示位置。可选值: 'center', 'left', 'right', 'top', 'bottom', 或是一个数组['right','top']
- 初始：$('.selector').dialog({ position: 'top' });
- 获取：var position = $('.selector').dialog('option', 'position');
- 设置：$('.selector').dialog('option', 'position', 'top');
- resizable : Boolean : true
- 设置对话框是否可以调整大小。
- 初始：$('.selector').dialog({ resizable: false });
- 获取：var resizable = $('.selector').dialog('option', 'resizable');
- 设置：$('.selector').dialog('option', 'resizable', false);
- show : String : null
- 用于显示对话框。
- 初始：$('.selector').dialog({ show: 'slide' });
- 获取：var show = $('.selector').dialog('option', 'show');
- 设置：$('.selector').dialog('option', 'show', 'slide');
- stack : Boolean : true
- 设置移动时对话框是否前置于其它的对话框前面。
- 初始：$('.selector').dialog({ stack: false });
- 获取：var stack = $('.selector').dialog('option', 'stack');
- 设置：$('.selector').dialog('option', 'stack', false);
- title : String : ''
- 指定对话框的标题，也可以在对话框附加元素的title属性中设置标题。
- 初始：$('.selector').dialog({ title: 'Dialog Title' });
- 获取：var title = $('.selector').dialog('option', 'title');
- 设置：$('.selector').dialog('option', 'title', 'Dialog Title');
- width : Number : 300
- 设置对话框的宽度（单位：像素）。
- $('.selector').dialog({ width: 460 });
- 获取：var width = $('.selector').dialog('option', 'width');
- 设置：$('.selector').dialog('option', 'width', 460);
- zIndex : Integer : 1000
- 设置对话框的zindex值。
- 初始：$('.selector').dialog({ zIndex: 3999 });
- 获取：var zIndex = $('.selector').dialog('option', 'zIndex');
- 设置：$('.selector').dialog('option', 'zIndex', 3999);
- ·事件
- beforeclose : dialogbeforeclose
- 当对话框关闭之前，触发此事件。如果返回false，则对话框仍然显示。
- 初始：$('.selector').dialog({ beforeclose: function(event, ui) { ... } });
- 绑定：$('.selector').bind('dialogbeforeclose', function(event, ui) { ... });
- open : dialogopen
- 当对话框打开后，触发此事件。
- 初始：$('.selector').dialog({ open: function(event, ui) { ... } });
- 绑定：$('.selector').bind('dialogopen', function(event, ui) { ... });
- focus : dialogfocus
- 当对话框获取焦点时，触发此事件。
- 初始：$('.selector').dialog({ focus: function(event, ui) { ... } });
- 绑定：$('.selector').bind('dialogfocus', function(event, ui) { ... });
- dragStart : dragStart
- 当开始拖拽对话框移动时，触发此事件。
- 初始：$('.selector').dialog({ dragStart: function(event, ui) { ... } });
- 绑定：$('.selector').bind('dragStart', function(event, ui) { ... });
- drag : drag
- 当拖拽对话框移动时，触发此事件。
- 初始：$('.selector').dialog({ drag: function(event, ui) { ... } });
- 绑定：$('.selector').bind('drag', function(event, ui) { ... });
- dragStop : dragStop
- 当拖拽对话框动作结束时，触发此事件。
- 初始：$('.selector').dialog({ dragStop: function(event, ui) { ... } });
- 绑定：$('.selector').bind('dragStop', function(event, ui) { ... });
- resizeStart : resizeStart
- 当开始改变对话框大小时，触发此事件。
- 初始：$('.selector').dialog({ resizeStart: function(event, ui) { ... } });
- 绑定：$('.selector').bind('resizeStart', function(event, ui) { ... });
- resize : resize
- 当对话框大小改变时，触发此事件。
- 初始：$('.selector').dialog({ resize: function(event, ui) { ... } });
- 绑定：$('.selector').bind('resize', function(event, ui) { ... });
- resizeStop : resizeStop
- 当对话框大小改变结束时，触发此事件。
- 初始：$('.selector').dialog({ resizeStop: function(event, ui) { ... } });
- 绑定：$('.selector').bind('resizeStop', function(event, ui) { ... });
- close : dialogclose
- 当对话框关闭后，触发此事件。
- 初始：$('.selector').dialog({ close: function(event, ui) { ... } });
- 绑定：$('.selector').bind('dialogclose', function(event, ui) { ... });
- ·属性
- destroy
- 销毁对话框对象。
- 用法：.dialog( 'destroy' )
- disable
- 禁用对话框。
- 用法：.dialog( 'disable' )
- enable
- 启用对话框。
- 用法：.dialog( 'enable' )
- option
- 获取或设置对话框的属性。
- 用法：.dialog( 'option' , optionName , [value] )
- close
- 关闭对话框。
- 用法：.dialog( 'close' )
- isOpen
- 用于判断对话框是否处理打开状态。
- 用法：.dialog( 'isOpen' )
- moveToTop
- 将对话框移至最顶层显示。
- 用法：.dialog( 'moveToTop' )
- open
- 打开对话框。
- 用法：.dialog( 'open' )
===================================================================================================
1 属性
1.11 autoOpen ，这个属性为true的时候dialog被调用的时候自动打开dialog窗口。当属性为false的时候，一开始隐藏窗口，知道.dialog("open")的时候才弹出dialog窗口。默认为：true。
1.12 初始化例：请注意，$('.selector')是dialog 的类名，在本例中.selector=#dialoag,以后不再说明。
$('.selector').dialog({ autoOpen: false });
1.13 初始化后，得到和设置此属性例：
//获得
var autoOpen = $('.selector').dialog('option', 'autoOpen');
//设置
$('.selector').dialog('option', 'autoOpen', false);
1.21 bgiframe 默认为false ，When true, the bgiframe plugin will be used, to fix the issue in IE6 where select boxes show on top of other elements, regardless of zIndex. Requires including the bgiframe plugin. Future versions may not require a separate plugin.
在IE6下，让后面那个灰屏盖住select。
1.22 初始化例：
$('.selector').dialog({ bgiframe: true });
1.23 初始化后，得到和设置：
//获取
var bgiframe = $('.selector').dialog('option', 'bgiframe');
//设置
$('.selector').dialog('option', 'bgiframe', true);
1.31 buttons 显示一个按钮，并写上按钮的文本，设置按钮点击函数。默认为{}，没有按钮。
最上面的例子中已经有buttons属性的用法，请注意。
1.32 初始化例：
$('.selector').dialog({ buttons: { "Ok": function() { $(this).dialog("close"); } } });
1.33 初始化后，得到和设置：
//获取
var buttons = $('.selector').dialog('option', 'buttons');
//设置
$('.selector').dialog('option', 'buttons', { "Ok": function() { $(this).dialog("close"); } });
1.41 closeOnEscape 为true的时候，点击键盘ESC键关闭dialog，默认为true；
1.42 初始化例：
$('.selector').dialog({ closeOnEscape: false });
1.43 初始化后，得到和设置：
//获取
var closeOnEscape = $('.selector').dialog('option', 'closeOnEscape');
//设置
$('.selector').dialog('option', 'closeOnEscape', false);
1.51 dialogClass 类型将被添加到dialog，默认为空
1.52 初始化例：
$('.selector').dialog({ dialogClass: 'alert' });
1.53 初始化后，得到和设置：
//获取
var dialogClass = $('.selector').dialog('option', 'dialogClass');
//设置
$('.selector').dialog('option', 'dialogClass', 'alert');
1.61 draggable、resizable : draggable是否可以使用标题头进行拖动，默认为true，可以拖动;resizable是否可以改变dialog的大小，默认为true，可以改变大小。
1.62 初始化例：
$('.selector').dialog({ draggable: false,resizable:false });
1.63 初始化后，得到和设置：
//获取
var draggable = $('.selector').dialog('option', 'draggable');
//设置
$('.selector').dialog('option', 'draggable', false);
1.71 width、height ，dialog的宽和高，默认为auto，自动。
1.72 初始化例：
$('.selector').dialog({ height: 530,width:200 });
1.73 初始化后，得到和设置：请参考1.63
1.81 maxWidth、maxHeight、minWidth、minHeight ，dialog可改变的最大宽度、最大高度、最小宽度、最小高度。maxWidth、maxHeight的默认为false，为不限。minWidth、minHeight的默认为150。要使用这些属性需要ui.resizable.js 的支持。
1.82 初始化例：
$('.selector').dialog({ maxHeight: 400,maxWidth:600,minHeight:300,minWidth:300 });
1.83 初始化后，得到和设置：请参考1.63
1.91 hide、show ，当dialog关闭和打开时候的效果。默认为null，无效果
1.92 初始化例：最上面的实例中用到，请自己看吧。
1.93 初始化后，得到和设置：请参考1.63
1.101 modal,是否使用模式窗口，模式窗口打开后，页面其他元素将不能点击，直到关闭模式窗口。默认为false不是模式窗口。
1.102 初始化例：$('.selector').dialog({ modal: true });
1.103 初始化后，得到和设置：请参考1.63
1.111 title，dialog的标题文字，默认为空。
1.112 初始化例：见最上面的实例。1.113 初始化后，得到和设置：请参考1.63
1.121 position ，dialog的显示位置：可以是'center', 'left', 'right', 'top', 'bottom',也可以是top和left的偏移量也可以是一个字符串数组例如['right','top']。
1.122 初始化例：$('.selector').dialog({ position: ['top','right'] }); 1.123 初始化后，得到和设置：请参考1.63
1.131 zIndex, dialog的zindex值，默认值为1000.
1.132 初始化例：$('.selector').dialog({ zIndex: 3999 }); 1.133 初始化后，得到和设置：请参考1.63
1.141 stack 默认值为true，当dialog获得焦点是，dialog将在最上面。
1.142 初始化例：$('.selector').dialog({ stack: false }); 1.143 初始化后，得到和设置：请参考1.63
2 事件
2.11 beforeclose 类型dialogbeforeclose ， 当dialog尝试关闭的时候此事件将被触发，如果返回false，那么关闭将被阻止。
2.12 初始化例：$('.selector').dialog({
beforeclose: function(event, ui) { ... }
});
2.13 使用类型绑定此事件例：$('.selector').bind('dialogbeforeclose', function(event, ui) {
...
});
2.21 close 类型：dialogclose ，当dialog被关闭后触发此事件。
2.22 初始化例：$('.selector').dialog({
close: function(event, ui) { ... }
});
2.23 使用类型绑定此事件例：$('.selector').bind('dialogclose', function(event, ui) {
...
});
2.3 open 类型：dialogopen ，当dialog打开时触发。（篇幅有限，该省略的就省略了啊，初始化例和使用类型绑定事件可以向上参考。）
2.4 focus 类型：dialogfocus ，当dialog获得焦点时触发。
2.5 dragStart 类型：dragStart，当dialog拖动开始时触发。
2.6 drag 类型：drag ，当dialog被拖动时触发。
2.7 dragStop 类型：dragStop ，当dialog拖动完成时触发。
2.8 resizeStart 类型：resizeStart ，当dialog开始改变窗体大小时触发。
2.9 resize 类型：resize，当dialog被改变大小时触发。
2.10 resizeStop 类型：resizeStop，当改变完大小时触发。
3 方法
3.1 destroy ，我喜欢这个哦，摧毁地球。。。 例：.dialog( 'destroy' )
3.2 disable，dialog不可用，例：.dialog('disable');
3.3 enable,dialog可用，例，如3.2
3.4 close，open，关闭、打开dialog
3.5 option ，设置和获取dialog属性，例如：.dialog( 'option' , optionName , [value] ) ，如果没有value，将是获取。
3.6 isOpen ，如果dialog打开则返回true，例如：.dialog('isOpen')
3.7 moveToTop ,将dialog移到最上层，例如：.dialog( 'moveToTop' )