jQuery UI庫中dialog對話框功能使用全解析_jquery

   對話框（dialog），是jQuery UI 非常重要的功能。它徹底的取代了JavaScript
的alert()、prompt()等方法，也避免了新視窗或頁面的繁雜冗餘。

一．開啟多個dialog
   只要設定不同的id 即可實現。

$('#x').dialog(); 
$('#y').dialog(); 

二．修改dialog 樣式
   在彈出的dialog 對話框中，在火狐瀏覽器中開啟Firebug 或右鍵->檢視
元素。可以看看dialog 的樣式，對dialog 的標題背景進行修改。

//无须修改ui 里的CSS，直接用style.css 替代掉 
.ui-widget-header { 
 
  background:url(../img/xxx.png); 
 
} 

三． dialog()方法的屬性
   對話方塊方法有兩種形式：1.dialog(options)，options 是以物件鍵值對的形式
傳參，每個鍵值對錶示一個選項；2.dialog('action', param)，action 是操作對
話框方法的字串，param則是options 的某個選項。

屬性

dialog 外观选项

属性	默认值/类型	说明
title	无/字符串	对话框的标题，可以直接设置在DOM 元素上
buttons	无/对象	以对象键值对方式，给dialog 添加按钮。键是按钮 的名称，值是用户点击后调用的回调函数

預設值/類型

說明

title

無/字串

$('#reg').dialog({ 
 
 title : '注册', 
 
 buttons : { 
 
   '按钮' : function () {} 
 
 } 
 
); 

對話框的標題，可以直接設定在DOM 元素上

buttons

無/物件

dialog 页面位置选项

属性	默认值/类型	说明
position	center/字符串	设置一个对话框窗口的坐标位置，默认为center。 其他设置值为：left top、top right、bottom left、 right bottom（四个角）、top、bottom（顶部或底 部，宽度居中）、left 或right（左边或右边，高度 居中）、center（默认值）

以物件鍵值對方式，為dialog 新增按鈕。鍵是按鈕<🎜>

的名稱，值是使用者點擊後呼叫的回呼函數<🎜>

<🎜> <🎜> <🎜> <🎜> <🎜> <🎜>

dialog 頁面位置選項

屬性<🎜>	預設值/類型<🎜>	說明<🎜>
position<🎜>	center/字串<🎜>	設定一個對話框視窗的座標位置，預設為center。 <🎜> 其他設定值為：left top、top right、bottom left、<🎜> right bottom（四個角落）、top、bottom（頂部或底<🎜> 部，寬度居中）、left 或right（左邊或右邊，高度<🎜> 居中）、center（預設值）<🎜>

$('#reg').dialog({ 
 
  position : 'left top' 
 
}); 

dialog 大小选项

属性	默认值/类型	说明
width	300/数值	对话框的宽度。默认为300，单位是像素。
height	auto/数值	对话框的高度。默认为auto，单位是像素。
minWidth	150/数值	对话框的最小宽度。默认150，单位是像素。
minHeight	150/数值	对话框的最小高度。默认150，单位是像素。
maxWidth	auto/数值	对话框的最大宽度。默认auto，单位是像素。
maxHeight	auto/数值	对话框的最大高度。默认auto，单位是像素。

$('#reg').dialog({ 
 
  height : 500, 
 
  width : 500, 
 
  minWidth : 300, 
 
  minHeight : 300, 
 
  maxWidth : 800, 
 
  maxHeight : 600 
 
}); 

dialog 视觉选项

属性	默认值/类型	说明
show	false/布尔值	显示对话框时，默认采用淡入效果。
hide	false 布尔值	关闭对话框时，默认采用淡出效果。

$('#reg').dialog({ 
 
  show : true, 
 
  hide : true 
 
}); 

注意：设置true 后，默认为淡入淡出，如果想使用别的特效，可以使用以下表格中的字符串参数。

show 和hide 可选特效

特效名称	说明
blind	对话框从顶部显示或消失
bounce	对话框断断续续地显示或消失，垂直运动
clip	对话框从中心垂直地显示或消失
slide	对话框从左边显示或消失
drop	对话框从左边显示或消失，有透明度变化
fold	对话框从左上角显示或消失
highlight	对话框显示或消失，伴随着透明度和背景色的变化
puff	对话框从中心开始缩放。显示时“收缩”，消失时“生长”
scale	对话框从中心开始缩放。显示时“生长”，消失时“收缩”
pulsate	对话框以闪烁形式显示或消失

$('#reg').dialog({ 
 
  show : 'blind', 
 
  hide : 'blind' 
 
}); 

dialog 行为选项

属性	默认值/类型	说明
autoOpen	true/布尔值	默认为true，调用dialog()方法时就会打开对话框； 如果为false，对话框不可见，但对话框已创建，可 以通过dialog('open')才能可见。
draggable	true/布尔值	默认为true，可以移动对话框，false 无法移动。
resizable	true/布尔值	默认为true，可以调整对话框大小，false 无法调整
modal	false/布尔值	默认为false，对话框外可操作，true 对话框会遮罩 一层灰纱，无法操作。
closeText	无/字符串	设置关闭按钮的title 文字

$('#reg').dialog({ 
 
  autoOpen : false, 
 
  draggable : false, 
 
  resizable : false, 
 
  modal : true, 
 
  closeText : '关闭' 
 
}); 

四．dialog()方法的事件
除了属性设置外，dialog()方法也提供了大量的事件。这些事件可以给各种不同状态
时提供回调函数。这些回调函数中的this 值等于对话框内容的div 对象，不是整个对话框
的div。

dialog 事件选项

事件名	说明
focus	当对话框被激活时（首次显示以及每次在上面点击）会 调用focus 方法，该方法有两个参数(event, ui)。此事件中 的ui 参数为空。
create	当对话框被创建时会调用create 方法，该方法有两个参 数(event, ui)。此事件中的ui 参数为空。
open	当对话框被显示时（首次显示或调用dialog('open')方法） 会调用open 方法，该方法有两个参数(event, ui)。此事件 中的ui 参数为空。
beforeClose	当对话框将要关闭时（ 当单击关闭按钮或调用 dialog('close')方法），会调用beforeclose 方法。如果该函 数返回false，对话框将不会被关闭。关闭的对话框可以 用dialog('open')重新打开。该方法有两个参数(event, ui)。 此事件中的ui 参数为空。
close	当对话框将要关闭时（ 当单击关闭按钮或调用 dialog('close')方法），会调用close 方法。关闭的对话框可 以用dialog('open')重新打开。该方法有两个参数(event, ui)。此事件中的ui 参数为空。
drag	当对话框移动时，每次移动一点均会调用drag 方法。该 方法有两个参数。该方法有两个参数(event, ui)。此事件 中的ui 有两个属性对象： 1.position，得到当前移动的坐标，有两个子属性：top 和 left。 2.offset，得到当前移动的坐标，有两个子属性：top 和left。
dragStart	当开始移动对话框时，会调用dragStart 方法。该方法有 两个参数(event, ui)。此事件中的ui 有两个属性对象： 1.position, get the current moving coordinates, has two sub-properties: top and left. 2.offset, get the current moving coordinates, has two sub-properties: top and left.
dragStop	When the dialog box starts to be moved, the dragStop method is called. This method has Two parameters (event, ui). The ui in this event has two attribute objects: 1.position, get the current moving coordinates, has two sub-properties: top and left. 2.offset, get the current moving coordinates, has two sub-properties: top and left.
resize	When the dialog box is increased in size, resize will be called every time you drag it. Method. This method has two parameters (event, ui). There are four ui in this event attribute objects: 1.size, gets the size of the dialog box, has two sub-properties: width and height. 2.position, get the coordinates of the dialog box, has two sub-properties: top and left. 3.originalSize, get the original size of the dialog box, has two sub-properties: width and height. 4.originalPosition, get the original coordinates of the dialog box, there are two sub-attributes Sex: top and left.
resizeStart	When starting to drag the dialog box, the resizeStart method will be called. This method has Two parameters (event, ui). The ui in this event has four attribute objects: 1.size, gets the size of the dialog box, has two sub-properties: width and height. 2.position, get the coordinates of the dialog box, has two sub-properties: top and left. 3.originalSize, get the original size of the dialog box, has two sub-properties: width and height. 4.originalPosition, get the original coordinates of the dialog box, there are two sub-attributes Sex: top and left.
resizeStop	When the drag dialog box is ended, the resizeStart method will be called. This method has Two parameters (event, ui). The ui in this event has four attribute objects: 1.size, gets the size of the dialog box, has two sub-properties: width and height. 2.position, get the coordinates of the dialog box, has two sub-properties: top and left. 3.originalSize, get the original size of the dialog box, has two sub-properties: width and height. 4.originalPosition, get the original coordinates of the dialog box, there are two sub-attributes Sex: top and left.

//当对话框获得焦点后 
$('#reg').dialog({ 
 
  focus : function (e, ui) { 
 
   alert('获得焦点'); 
 
  } 
 
}); 
 
//当创建对话框时 
$('#reg').dialog({ 
 
  create : function (e, ui) { 
 
   alert('创建对话框'); 
 
  } 
 
}); 
 
//当将要关闭时 
$('#reg').dialog({ 
 
  beforeClose : function (e, ui) { 
 
   alert('关闭前做的事！'); 
 
   return flag; 
 
  } 
 
}); 
 
//关闭对话框时 
$('#reg').dialog({ 
 
  close : function (e, ui) { 
 
   alert('关闭！'); 
 
  } 
 
}); 
 
//对话框移动时 
$('#reg').dialog({ 
 
  drag : function (e, ui) { 
 
   alert('top:' + ui.position.top + '\n' 
 
        + 'left:' + ui.position.left); 
 
  } 
 
}); 
 
//对话框开始移动时 
$('#reg').dialog({ 
 
  dragStart : function (e, ui) { 
 
   alert('top:' + ui.position.top + '\n' 
 
        + 'left:' + ui.position.left); 
 
  } 
 
}); 
 
//对话框结束移动时 
$('#reg').dialog({ 
 
  dragStop : function (e, ui) { 
 
   alert('top:' + ui.position.top + '\n' 
 
        + 'left:' + ui.position.left); 
 
  } 
 
}); 
 
//调整对话框大小时 
$('#reg').dialog({ 
 
  resize : function (e, ui) { 
 
   alert('size:' + ui.size.width + '\n' 
 
        + 'originalSize:' + ui.originalSize.width); 
 
  } 
 
}); 
 
//开始调整对话框大小时 
$('#reg').dialog({ 
 
  resizeStart : function (e, ui) { 
 
   alert('size:' + ui.size.width + '\n' 
 
        + 'originalSize:' + ui.originalSize.width); 
 
  } 
 
}); 
 
//结束调整对话框大小时 
$('#reg').dialog({ 
 
  resizeStop : function (e, ui) { 
 
   alert('size:' + ui.size.width + '\n' 
 
        + 'originalSize:' + ui.originalSize.width); 
 
  } 
 
}); 

dialog('action', param)方法

方法	返回值	说明
dialog('open')	jQuery 对象	打开对话框
dialog('close')	jQuery 对象	关闭对话框
dialog('destroy')	jQuery 对象	删除对话框，直接阻断了dialog
dialog('isOpen')	布尔值	判断对话框是否打开状态
dialog('widget')	jQuery 对象	获取对话框的jQuery 对象
dialog('option', param)	一般值	获取options 属性的值
dialog('option', param, value)	jQuery 对象	设置options 属性的值

//初始隐藏对话框 
$('#reg').dialog({ 
 
  autoOpen : false 
 
}); 
 
//打开对话框 
$('#reg_a').click(function () { 
 
  $('#reg').dialog('open'); 
 
}); 
 
//关闭对话框 
$('#reg').click(function () { 
 
  $('#reg').dialog('close'); 
 
}); 
 
//判断对话框打开或关闭状态 
$(document).click(function () { 
 
  alert($('#reg').dialog('isOpen')); 
 
}); 
 
//将指定对话框置前 
$(document).click(function () { 
 
  $('#reg').dialog('moveToTop'); 
 
}); 
 
//获取某个options 的param 选项的值 
var title = $('#reg').dialog('option', 'title'); 
 
alert(title); 
 
 
//设置某个options 的param 选项的值 
$('#reg').dialog('option', 'title', '注册'); 

五．dialog 中使用on()
在dialog 的事件中，提供了使用on()方法处理的事件方法。

on()方法触发的对话框事件

特效名称	说明
dialogfocus	得到焦点时触发
dialogopen	显示时触发
dialogbeforeclose	将要关闭时触发
dialogclose	关闭时触发
dialogdrag	每一次移动时触发
dialogdragstart	开始移动时触发
dialogdragstop	移动结束后触发
dialogresize	每次调整大小时触发
dialogresizestart	开始调整大小时触发
dialogresizestop	结束调整大小时触发

$('#reg').on('dialogclose', function () { 
 
  alert('关闭'); 
 
});