Dialog는 jQuery UI의 매우 중요한 기능입니다. JavaScript를 완전히 대체합니다
Alert(), Prompt() 및 기타 메서드도 새 창이나 페이지의 복잡성과 중복을 방지합니다.
1. 여러 대화상자 열기
이를 달성하려면 다른 ID를 설정하면 됩니다.
$('#x').dialog(); $('#y').dialog();
2. 대화상자 스타일 수정
팝업 대화 상자에서 Firefox에서 Firebug를 열거나 마우스 오른쪽 버튼을 클릭하고 ->보기
요소. 대화 스타일을 보고 대화 제목 배경을 수정할 수 있습니다.
//无须修改ui 里的CSS,直接用style.css 替代掉 .ui-widget-header { background:url(../img/xxx.png); }
3. 대화 상자() 메서드의 속성
Dialog 메소드는 1.dialog(options), 옵션은 객체 키-값 쌍의 형태로 되어 있습니다.
매개변수를 전달합니다. 각 키-값 쌍은 옵션을 나타냅니다. 2.dialog('action', param), 작업은 작업 쌍입니다.
대화 상자 메서드의 문자열인 param은 옵션의 옵션입니다.
속성
|
기본값/유형 |
설명 | |||||||||
제목 |
없음/문자열$('#reg').dialog({ title : '注册', buttons : { '按钮' : function () {} } ); |
대화상자 제목은 DOM 요소에서 직접 설정할 수 있습니다 | |||||||||
버튼
|
없음/개체
|
객체 키-값 쌍 형태로 대화상자에 버튼을 추가합니다. 키는 버튼이다
의 이름, 값은 사용자가 를 클릭한 후 호출되는 콜백 함수입니다.
|
속성 | 기본값/유형 | 설명 |
위치 | center/string |
대화상자 창의 좌표 위치를 설정합니다. 기본값은 중앙입니다.
기타 설정값은 왼쪽 위, 오른쪽 위, 왼쪽 아래,
오른쪽 하단(네 모서리), 상단, 하단(상단 또는 하단
하트, 너비 중앙), 왼쪽 또는 오른쪽(왼쪽 또는 오른쪽, 높이
center), center (기본값)
|
$('#reg').dialog({ position : 'left top' });
属性 |
默认值/类型 |
说明 |
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 });
属性 |
默认值/类型 |
说明 |
show |
false/布尔值 |
显示对话框时,默认采用淡入效果。 |
hide |
false 布尔值 |
关闭对话框时,默认采用淡出效果。 |
$('#reg').dialog({ show : true, hide : true });
注意:设置true 后,默认为淡入淡出,如果想使用别的特效,可以使用以下表格中的字符串参数。
特效名称 |
说明 |
blind |
对话框从顶部显示或消失 |
bounce |
对话框断断续续地显示或消失,垂直运动 |
clip |
对话框从中心垂直地显示或消失 |
slide |
对话框从左边显示或消失 |
drop |
对话框从左边显示或消失,有透明度变化 |
fold |
对话框从左上角显示或消失 |
highlight |
对话框显示或消失,伴随着透明度和背景色的变化 |
puff |
对话框从中心开始缩放。显示时“收缩”,消失时“生长” |
scale |
对话框从中心开始缩放。显示时“生长”,消失时“收缩” |
pulsate |
对话框以闪烁形式显示或消失 |
$('#reg').dialog({ show : 'blind', hide : 'blind' });
属性 |
默认值/类型 |
说明 |
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。
事件名 |
说明 |
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, 현재 이동 좌표를 가져오고 top과 의 두 가지 하위 속성이 있습니다.
왼쪽.
2.offset, 현재 이동 좌표를 가져오고 위쪽과 왼쪽이라는 두 가지 하위 속성이 있습니다.
|
드래그 중지 |
대화 상자가 이동하기 시작하면 dragStop 메서드가 호출됩니다. 이 방법에는
두 개의 매개변수(이벤트, UI). 이 이벤트의 UI에는 두 가지 속성 개체가 있습니다.
1.position, 현재 이동 좌표를 가져오고 top과 의 두 가지 하위 속성이 있습니다.
왼쪽.
2.offset, 현재 이동 좌표를 가져오고 위쪽과 왼쪽이라는 두 가지 하위 속성이 있습니다.
|
크기 조정 |
대화상자 크기가 커지면 드래그할 때마다 resize 가 호출됩니다.
방법. 이 메서드에는 두 개의 매개변수(event, ui)가 있습니다. 이번 이벤트에는 UI가 4개 있습니다
속성 개체:
1.size, 대화 상자의 크기를 가져오고 너비와 라는 두 가지 하위 속성이 있습니다.
키.
2.position, 대화 상자의 좌표를 가져오며 top과 left라는 두 가지 하위 속성이 있습니다.
3.originalSize, 대화 상자의 원래 크기를 가져오고 두 개의 하위 속성이 있습니다:
너비와 높이.
4.originalPosition, 대화 상자의 원래 좌표를 가져옵니다. 두 개의 하위 속성이 있습니다
성별: 위쪽 및 왼쪽.
|
크기 조정 시작 |
대화 상자를 드래그하기 시작하면 resizeStart 메서드가 호출됩니다. 이 방법에는
두 개의 매개변수(이벤트, UI). 이 이벤트의 UI에는 네 가지 속성 개체가 있습니다.
1.size, 대화 상자의 크기를 가져오고 너비와 라는 두 가지 하위 속성이 있습니다.
키.
2.position, 대화 상자의 좌표를 가져오며 top과 left라는 두 가지 하위 속성이 있습니다.
3.originalSize, 대화 상자의 원래 크기를 가져오고 두 개의 하위 속성이 있습니다:
너비와 높이.
4.originalPosition, 대화 상자의 원래 좌표를 가져옵니다. 두 개의 하위 속성이 있습니다
성별: 위쪽 및 왼쪽.
|
크기 조정 중지 |
드래그 대화 상자가 종료되면 resizeStart 메서드가 호출됩니다. 이 방법에는
두 개의 매개변수(이벤트, UI). 이 이벤트의 UI에는 네 가지 속성 개체가 있습니다.
1.size, 대화 상자의 크기를 가져오고 너비와 라는 두 가지 하위 속성이 있습니다.
키.
2.position, 대화 상자의 좌표를 가져오며 top과 left라는 두 가지 하위 속성이 있습니다.
3.originalSize, 대화 상자의 원래 크기를 가져오고 두 개의 하위 속성이 있습니다:
너비와 높이.
4.originalPosition, 대화 상자의 원래 좌표를 가져옵니다. 두 개의 하위 속성이 있습니다
성별: 위쪽 및 왼쪽.
|
//当对话框获得焦点后 $('#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('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()方法处理的事件方法。
特效名称 |
说明 |
dialogfocus |
得到焦点时触发 |
dialogopen |
显示时触发 |
dialogbeforeclose |
将要关闭时触发 |
dialogclose |
关闭时触发 |
dialogdrag |
每一次移动时触发 |
dialogdragstart |
开始移动时触发 |
dialogdragstop |
移动结束后触发 |
dialogresize |
每次调整大小时触发 |
dialogresizestart |
开始调整大小时触发 |
dialogresizestop |
结束调整大小时触发 |
$('#reg').on('dialogclose', function () { alert('关闭'); });