jq UI中的dialog属性设置

最新推荐文章于 2023-04-10 08:53:48 发布

原创最新推荐文章于 2023-04-10 08:53:48 发布 · 4.4k 阅读

5 ·

CC 4.0 BY-SA版权

JQ方面专栏收录该内容

8 篇文章

订阅专栏

本文详细介绍了jQuery UI中的dialog组件，包括其基本功能、参数设置、事件处理和常用方法。dialog提供了一个浮动窗口，支持移动、调整大小和关闭，并且可以根据配置自动打开、设置背景iframe、添加按钮栏等功能。文章还列举了如autoOpen、bgiframe、buttons、closeOnEscape等参数的详细说明和使用方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

本文转自：http://mfan.iteye.com/blog/1127454
·概述
一个浮动的窗口，包含标题和内容两部分。可以移动，调整大小，以及关闭图标 '×' 。
如果内容长度超过了对话框内容区域的显示，则会自动出现滚动条。
除此之外，还有一些常用的选项，如：添加底部按钮栏、模式窗口屏蔽层等。
官方示例地址：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' )