- JqueryUI 教程
- JqueryUI - 主页
- JqueryUI - 概述
- JqueryUI - 环境设置
- JqueryUI 小部件
- JqueryUI - 手风琴
- JqueryUI - 自动完成
- JqueryUI - 按钮
- JqueryUI - 日期选择器
- JqueryUI - 对话框
- JqueryUI - 菜单
- JqueryUI - 进度条
- JqueryUI - 滑块
- JqueryUI - 微调器
- JqueryUI - 选项卡
- JqueryUI - 工具提示
- JqueryUI 效果
- JqueryUI - 添加类
- JqueryUI - 彩色动画
- JqueryUI - 效果
- JqueryUI - 隐藏
- JqueryUI - 删除类
- JqueryUI - 显示
- JqueryUI - 切换类
- JqueryUI - 切换
- JqueryUI - 切换类
- JqueryUI 实用程序
- JqueryUI - 位置
- JqueryUI - 部件工厂
- JqueryUI 有用的资源
- JqueryUI - 快速指南
- JqueryUI - 有用的资源
- JqueryUI - 讨论
JqueryUI - 对话框
对话框是在 HTML 页面上呈现信息的好方法之一。对话框是一个带有标题和内容区域的浮动窗口。该窗口可以移动、调整大小,当然,默认情况下也可以使用“X”图标关闭。
jQueryUI 提供了dialog()方法,该方法将页面上编写的HTML 代码转换为HTML 代码以显示对话框。
句法
dialog ()方法可以以两种形式使用 -
$(选择器,上下文).dialog(选项)方法
对话框(选项)方法声明可以以对话框的形式管理 HTML 元素。options参数是一个指定该窗口的外观和Behave的对象。句法
$(selector, context).dialog(options);
您可以使用 Javascript 对象一次提供一个或多个选项。如果要提供多个选项,那么您将使用逗号分隔它们,如下所示 -
$(selector, context).dialog({option1: value1, option2: value2..... });
下表列出了可以与此方法一起使用的不同选项-
先生。 | 选项和说明 |
---|---|
1 | 附加到
如果此选项设置为false,它将阻止ui-draggable类添加到所选 DOM 元素列表中。默认情况下它的值为true。 |
2 | 自动打开
除非将此选项设置为false,否则该对话框将在创建时打开。当false时,将在调用dialog('open') 时打开对话框。默认情况下它的值为true。 |
3 | 纽扣
此选项在对话框中添加按钮。它们被列为对象,每个属性都是按钮上的文本。该值是用户单击按钮时调用的回调函数。默认情况下,其值为{}。 |
4 | 密室逃脱
除非此选项设置为false,否则当用户在对话框具有焦点时按 Escape 键时,对话框将关闭。默认情况下它的值为true。 |
5 | 关闭文本
此选项包含用于替换关闭按钮的默认“关闭”的文本。默认情况下,其值为“close”。 |
6 | 对话框类
如果此选项设置为false,它将阻止ui-draggable类添加到所选 DOM 元素列表中。默认情况下它的值为""。 |
7 | 可拖动的
除非您将此选项设置为false,否则将通过单击并拖动标题栏来拖动对话框。默认情况下它的值为true。 |
8 | 高度
该选项设置对话框的高度。默认情况下,其值为“auto”。 |
9 | 隐藏
该选项用于设置对话框关闭时使用的效果。默认情况下它的值为null。 |
11 | 最大高度
此选项设置对话框大小可调整到的最大高度(以像素为单位)。默认情况下它的值为false。 |
12 | 最大宽度
此选项设置对话框可调整大小的最大宽度(以像素为单位)。默认情况下它的值为false。 |
13 | 最小高度
此选项是对话框大小可调整到的最小高度(以像素为单位)。默认情况下,其值为150。 |
14 | 最小宽度
此选项是对话框大小可调整到的最小宽度(以像素为单位)。默认情况下,其值为150。 |
15 | 莫代尔
如果此选项设置为true,对话框将具有模态Behave;页面上的其他项目将被禁用,即无法与之交互。模式对话框在对话框下方但在其他页面元素上方创建一个覆盖层。默认情况下它的值为false。 |
16 | 位置
该选项指定对话框的初始位置。可以是预定义位置之一:center (默认)、 left、 right、 top 或 Bottom。也可以是 2 元素数组,其中左侧值和顶部值(以像素为单位)为 [left,top],或文本位置,例如 ['right','top']。默认情况下,其值为{ my: "center", at: "center", of: window }。 |
17 号 | 可调整大小
除非将此选项设置为false,否则对话框可在所有方向上调整大小。默认情况下它的值为true。 |
18 | 展示
该选项是打开对话框时使用的效果。默认情况下它的值为null。 |
20 | 标题
该选项指定对话框标题栏中显示的文本。默认情况下它的值为null。 |
21 | 宽度
此选项指定对话框的宽度(以像素为单位)。默认情况下,其值为300。 |
以下部分将向您展示对话框功能的一些工作示例。
默认功能
以下示例演示了一个不向dialog()方法传递任何参数的对话框功能的简单示例。
<!doctype html> <html lang = "en"> <head> <meta charset = "utf-8"> <title>jQuery UI Dialog functionality</title> <link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css" rel = "stylesheet"> <script src = "https://code.jquery.com/jquery-1.10.2.js"></script> <script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script> <!-- CSS --> <style> .ui-widget-header,.ui-state-default, ui-button { background:#b9cd6d; border: 1px solid #b9cd6d; color: #FFFFFF; font-weight: bold; } </style> <!-- Javascript --> <script> $(function() { $( "#dialog-1" ).dialog({ autoOpen: false, }); $( "#opener" ).click(function() { $( "#dialog-1" ).dialog( "open" ); }); }); </script> </head> <body> <!-- HTML --> <div id = "dialog-1" title = "Dialog Title goes here...">This my first jQuery UI Dialog!</div> <button id = "opener">Open Dialog</button> </body> </html>
让我们将上面的代码保存在 HTML 文件dialogexample.htm中,并在支持 javascript 的标准浏览器中打开它,您还必须看到以下输出。现在,您可以使用结果 -
按钮、标题和位置的使用
下面的例子演示了JqueryUI的对话框小部件中三个选项按钮、标题和位置的用法。
<!doctype html> <html lang = "en"> <head> <meta charset = "utf-8"> <title>jQuery UI Dialog functionality</title> <link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css" rel = "stylesheet"> <script src = "https://code.jquery.com/jquery-1.10.2.js"></script> <script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script> <!-- CSS --> <style> .ui-widget-header,.ui-state-default, ui-button { background:#b9cd6d; border: 1px solid #b9cd6d; color: #FFFFFF; font-weight: bold; } </style> <!-- Javascript --> <script> $(function() { $( "#dialog-2" ).dialog({ autoOpen: false, buttons: { OK: function() {$(this).dialog("close");} }, title: "Success", position: { my: "left center", at: "left center" } }); $( "#opener-2" ).click(function() { $( "#dialog-2" ).dialog( "open" ); }); }); </script> </head> <body> <!-- HTML --> <div id = "dialog-2" title = "Dialog Title goes here...">This my first jQuery UI Dialog!</div> <button id = "opener-2">Open Dialog</button> </body> </html>
让我们将上面的代码保存在 HTML 文件dialogexample.htm中,并在支持 javascript 的标准浏览器中打开它,您还必须看到以下输出。现在,您可以使用结果 -
使用隐藏、显示和高度
以下示例演示了JqueryUI 对话框小部件中hide、show和height三个选项的用法。
<!doctype html> <html lang = "en"> <head> <meta charset = "utf-8"> <title>jQuery UI Dialog functionality</title> <link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css" rel = "stylesheet"> <script src = "https://code.jquery.com/jquery-1.10.2.js"></script> <script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script> <!-- CSS --> <style> .ui-widget-header,.ui-state-default, ui-button { background:#b9cd6d; border: 1px solid #b9cd6d; color: #FFFFFF; font-weight: bold; } </style> <!-- Javascript --> <script> $(function() { $( "#dialog-3" ).dialog({ autoOpen: false, hide: "puff", show : "slide", height: 200 }); $( "#opener-3" ).click(function() { $( "#dialog-3" ).dialog( "open" ); }); }); </script> </head> <body> <!-- HTML --> <div id = "dialog-3" title = "Dialog Title goes here...">This my first jQuery UI Dialog!</div> <button id = "opener-3">Open Dialog</button> </body> </html>
让我们将上面的代码保存在 HTML 文件dialogexample.htm中,并在支持 javascript 的标准浏览器中打开它,您还必须看到以下输出。现在,您可以使用结果 -
模态的使用
下面的例子演示了JqueryUI的对话框小部件中三个选项按钮、标题和位置的用法。
<!doctype html> <html lang = "en"> <head> <meta charset = "utf-8"> <title>jQuery UI Dialog functionality</title> <link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css" rel = "stylesheet"> <script src = "https://code.jquery.com/jquery-1.10.2.js"></script> <script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script> <!-- CSS --> <style> .ui-widget-header,.ui-state-default, ui-button { background:#b9cd6d; border: 1px solid #b9cd6d; color: #FFFFFF; font-weight: bold; } </style> <!-- Javascript --> <script> $(function() { $( "#dialog-4" ).dialog({ autoOpen: false, modal: true, buttons: { OK: function() {$(this).dialog("close");} }, }); $( "#opener-4" ).click(function() { $( "#dialog-4" ).dialog( "open" ); }); }); </script> </head> <body> <!-- HTML --> <div id = "dialog-4" title = "Dialog Title goes here...">This my first jQuery UI Dialog!</div> <button id = "opener-4">Open Dialog</button> <p> Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. </p> <label for = "textbox">Enter Name: </label> <input type = "text"> </body> </html>
让我们将上面的代码保存在 HTML 文件dialogexample.htm中,并在支持 javascript 的标准浏览器中打开它,您还必须看到以下输出。现在,您可以使用结果 -
$(selector, context).dialog("action", [params]) 方法
dialog (action, params)方法可以对对话框执行操作,例如关闭对话框。该操作在第一个参数中指定为字符串,并且可以根据给定的操作提供一个或多个参数(可选)。
基本上,这里的操作什么都不是,只是我们可以以字符串形式使用的 jQuery 方法。
句法
$(selector, context).dialog ("action", [params]);
下表列出了此方法的操作 -
先生。 | 动作与描述 |
---|---|
1 | 关闭()
此操作将关闭对话框。此方法不接受任何参数。 |
2 | 破坏()
此操作将完全删除该对话框。这将使元素返回到其预初始化状态。此方法不接受任何参数。 |
3 | 开了()
此操作检查对话框是否打开。此方法不接受任何参数。 |
4 | 移动到顶部()
此操作将相应的对话框定位到前台(在其他对话框的顶部)。此方法不接受任何参数。 |
5 | 打开()
此操作将打开对话框。此方法不接受任何参数。 |
6 | 选项(选项名称)
此操作获取当前与指定 optionName 关联的值。其中optionName是要获取的选项的名称。 |
7 | 选项()
此操作获取一个对象,其中包含表示当前对话框选项哈希的键/值对。此方法不接受任何参数。 |
8 | 选项(选项名称,值)
此操作设置与指定 optionName 关联的对话框选项的值。 |
9 | 选项(选项)
此操作为对话框设置一个或多个选项。 |
10 | 小部件()
此操作返回对话框的小部件元素;用 ui-dialog 类名注释的元素。此方法不接受任何参数。 |
例子
现在让我们看一个使用上表中的操作的示例。以下示例演示了isOpen()、open()和close()方法的使用。
<!doctype html> <html lang = "en"> <head> <meta charset = "utf-8"> <title>jQuery UI Dialog functionality</title> <link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css" rel = "stylesheet"> <script src = "https://code.jquery.com/jquery-1.10.2.js"></script> <script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script> <!-- CSS --> <style> .ui-widget-header,.ui-state-default, ui-button { background:#b9cd6d; border: 1px solid #b9cd6d; color: #FFFFFF; font-weight: bold; } </style> <!-- Javascript --> <script type = "text/javascript"> $(function() { $("#toggle").click(function() { ($("#dialog-5").dialog("isOpen") == false) ? $( "#dialog-5").dialog("open") : $("#dialog-5").dialog("close") ; }); $("#dialog-5").dialog({autoOpen: false}); }); </script> </head> <body> <button id = "toggle">Toggle dialog!</button> <div id = "dialog-5" title = "Dialog Title!"> Click on the Toggle button to open and close this dialog box. </div> </body> </html>
让我们将上面的代码保存在 HTML 文件dialogexample.htm中,并在支持 javascript 的标准浏览器中打开它,您还必须看到以下输出 -
对话框中的事件管理
In addition to the dialog (options) method which we saw in the previous sections, JqueryUI provides event methods as which gets triggered for a particular event. These event methods are listed below −
Sr.No. | Event Method & Description |
---|---|
1 | beforeClose(event, ui)
This event is triggered when the dialog box is about to close. Returning false prevents the dialog box from closing. It is handy for dialog boxes with forms that fail validation. Where event is of type Event, and ui is of type Object. |
2 | close(event, ui)
This event is triggered when the dialog box is closed. Where event is of type Event, and ui is of type Object. |
3 | create(event, ui)
This event is triggered when the dialog box is created. Where event is of type Event, and ui is of type Object. |
4 | drag(event, ui)
This event is triggered repeatedly as a dialog box is moved about during a drag. Where event is of type Event, and ui is of type Object. |
5 | dragStart(event, ui)
This event is triggered when a repositioning of the dialog box commences by dragging its title bar. Where event is of type Event, and ui is of type Object. |
6 | dragStop(event, ui)
This event is triggered when a drag operation terminates. Where event is of type Event, and ui is of type Object. |
7 | focus(event, ui)
This event is triggered when the dialog gains focus. Where event is of type Event, and ui is of type Object. |
8 | open(event, ui)
This event is triggered when the dialog box is opened. Where event is of type Event, and ui is of type Object. |
9 | resize(event, ui)
This event is triggered repeatedly as a dialog box is resized. Where event is of type Event, and ui is of type Object. |
10 | resizeStart(event, ui)
This event is triggered when a resize of the dialog box commences. Where event is of type Event, and ui is of type Object. |
11 | resizeStop(event, ui)
当对话框的大小调整终止时,会触发此事件。其中event的类型为Event,而ui的类型为Object。 |
以下示例演示了上表中列出的事件的使用。
beforeClose 事件方法的使用
以下示例演示了beforeClose事件方法的使用。
<!doctype html> <html lang = "en"> <head> <meta charset = "utf-8"> <title>jQuery UI Dialog functionality</title> <link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css" rel = "stylesheet"> <script src = "https://code.jquery.com/jquery-1.10.2.js"></script> <script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script> <!-- CSS --> <style> .ui-widget-header,.ui-state-default, ui-button { background:#b9cd6d; border: 1px solid #b9cd6d; color: #FFFFFF; font-weight: bold; } .invalid { color: red; } textarea { display: inline-block; width: 100%; margin-bottom: 10px; } </style> <!-- Javascript --> <script type = "text/javascript"> $(function() { $( "#dialog-6" ).dialog({ autoOpen: false, buttons: { OK: function() { $( this ).dialog( "close" ); } }, beforeClose: function( event, ui ) { if ( !$( "#terms" ).prop( "checked" ) ) { event.preventDefault(); $( "[for = terms]" ).addClass( "invalid" ); } }, width: 600 }); $( "#opener-5" ).click(function() { $( "#dialog-6" ).dialog( "open" ); }); }); </script> </head> <body> <div id = "dialog-6"> <p>You must accept these terms before continuing.</p> <textarea>This Agreement and the Request constitute the entire agreement of the parties with respect to the subject matter of the Request. This Agreement shall be governed by and construed in accordance with the laws of the State, without giving effect to principles of conflicts of law.</textarea> <div> <label for = "terms">I accept the terms</label> <input type = "checkbox" id = "terms"> </div> </div> <button id = "opener-5">Open Dialog</button> </body> </html>
让我们将上面的代码保存在 HTML 文件dialogexample.htm中,并在支持 javascript 的标准浏览器中打开它,您还必须看到以下输出 -
使用resize事件方法
下面的例子演示了resize事件方法的使用。
<!doctype html> <html lang = "en"> <head> <meta charset = "utf-8"> <title>jQuery UI Dialog functionality</title> <link href = "https://code.jquery.com/ui/1.10.4/themes/ui-lightness/jquery-ui.css" rel = "stylesheet"> <script src = "https://code.jquery.com/jquery-1.10.2.js"></script> <script src = "https://code.jquery.com/ui/1.10.4/jquery-ui.js"></script> <!-- CSS --> <style> .ui-widget-header,.ui-state-default, ui-button { background:#b9cd6d; border: 1px solid #b9cd6d; color: #FFFFFF; font-weight: bold; } </style> <!-- Javascript --> <script type = "text/javascript"> $(function() { $( "#dialog-7" ).dialog({ autoOpen: false, resize: function( event, ui ) { $( this ).dialog( "option", "title", ui.size.height + " x " + ui.size.width ); } }); $( "#opener-6" ).click(function() { $( "#dialog-7" ).dialog( "open" ); }); }); </script> </head> <body> <div id = "dialog-7" title = "Dialog Title goes here..." >Resize this dialog to see the dialog co-ordinates in the title!</div> <button id = "opener-6">Open Dialog</button> </body> </html>
让我们将上面的代码保存在 HTML 文件dialogexample.htm中,并在支持 javascript 的标准浏览器中打开它,您还必须看到以下输出 -
扩展点
对话框小部件是使用小部件工厂构建的,并且可以扩展。要扩展小部件,我们可以覆盖或添加现有方法的Behave。以下方法提供了与对话框方法具有相同 API 稳定性的扩展点。列于上表。
先生。 | 方法及说明 |
---|---|
1 | _allowInteraction(事件)
此方法允许用户通过将不是对话框子级但允许用户使用的元素列入白名单来与给定目标元素进行交互。其中event的类型为Event。 |
jQuery UI Widget Factory 是一个可扩展的基础,所有 jQuery UI 的小部件都是在此基础上构建的。使用小部件工厂构建插件为状态管理提供了便利,并为常见任务(例如公开插件方法和实例化后更改选项)提供了约定。