js-artDialog文档说明

artDialog是一个基于javascript编写的对话框组件，它拥有精致的界面与友好的接口 l  自适应内容 artDialog的特殊UI框架能够适应内容变化，甚至连外部程序动态插入的内容它仍然能自适应，因此你不必去考虑消息内容尺寸使用它。它的消息容器甚至能够根据宽度让文本居中或居左对齐——这一切全是XHTML+CSS原生实现。
l  完善的接口 它的接口完善，可以轻易与外部程序配合使用。如异步写入消息、控制位置、尺寸、显示与隐藏、关闭等。
l  细致的体验 如果不是在输入状态，它支持Esc快捷键关闭；可指定在元素附近弹出，让操作更便捷；智能给按钮添加焦点；黄金比例垂直居中；超大响应区域特别为ipad等触屏设备优化；预先缓存皮肤图片更快响应……
l  跨平台兼容 兼容：IE6+、Firefox、Chrome、Safari、Opera以及iPad等移动设备。并且IE6下也能支持现代浏览器的静止定位(fixed)、、alpha通道png背景。 下载地址：http://code.google.com/p/artdialog/downloads/list
  快速入门 一、使用传统的参数 art.dialog(content, ok, cancel) 示例： art.dialog(‘简单愉悦的接口，强大的表现力，优雅的内部实现‘, function(){alert(‘yes‘);}); art.dialog(“简单愉悦的接口，强大的表现力，优雅的内部实现”);
二、使用字面量传参 art.dialog(options) 示例     var dialog = art.dialog({     title: ‘欢迎‘,     content: ‘欢迎使用artDialog对话框组件！‘,     icon: ‘succeed‘,     follow: document.getElementById(‘btn2‘),     ok: function(){         this.title(‘警告‘).content(‘请注意artDialog两秒后将关闭！‘).lock().time(2);         return false;     } });
三、扩展方法 需要对弹出后的对话框操作？artDialog简单实用的扩展方法可以使这一切变得简单。 如在ajax异步操作中，我们可以先定义一个变量引用对话框返回的扩展方法：
var myDialog = art.dialog();// 初始化一个带有loading图标的空对话框 jQuery.ajax({     url: ‘http://web5.qq.com/content?id=1‘,     success: function (data) {         myDialog.content(data);// 填充对话框内容     } });
如果需要使用程序控制关闭，可以使用"close"方法关闭对话框： myDialog.close();
插件：框架应用工具 artDialog针对CMS类的框架应用提供了专属插件，如穿越框架、iframe、AJAX、跨框架传值操作等。 例： 使用open方法嵌入页面，并使用data方法在各个iframe间传递数据：
var val = document.getElementById(‘demoInput04-3‘).value; art.dialog.data(‘test‘, val); art.dialog.data(‘homeDemoPath‘, ‘./_doc/‘); // 此时iframeA.html 页面可以使用art.dialog.data(‘test‘) 获取到数据，如： // document.getElementById(‘aInput‘).value = art.dialog.data(‘test‘); art.dialog.open(‘./_doc/iframeA.html‘);
jQuery + artDialog artDialog提供了一个jQuery版本，功能与标准版一致，调用只需要把art前缀改成jQuery的命名空间。 // 普通调用 $.dialog({content:‘hello world!‘}); // 使用选择器方式，此时自动使用绑定了live click事件，同时启用follow模式 $(‘#main .test‘).dialog({content: ‘hello world‘}); (最低兼容jquery1.3.2，但框架应用插件需要jquery1.4+运行[?])
配置参数

扩展方法

配置参数演示 内容[content] 1. 传入字符串

art.dialog({     content: ‘我支持HTML‘ });

2. 传入HTMLElement 备注：1、元素不是复制而是完整移动到对话框中，所以原有的事件与属性都将会保留2、如果隐藏元素被传入到对话框，会设置display:block属性显示该元素3、对话框关闭的时候元素将恢复到原来在页面的位置，style display属性也将恢复

art.dialog({     content: document.getElementById(‘demoCode_content_DOM‘),     id: ‘EF893L‘ });

标题[title]

art.dialog({     title: ‘hello world!‘ });

确定取消按钮[ok & cancel] 备注：回调函数this指向扩展接口，如果返回false将阻止对话框关闭

art.dialog({     content: ‘如果定义了回调函数才会出现相应的按钮‘,     ok: function() {         this.title(‘3秒后自动关闭‘).time(3);         returnfalse;     },     cancelVal: ‘关闭‘,     cancel: true//为true等价于function(){} });

自定义按钮[button] 备注：回调函数this指向扩展接口，如果返回false将阻止对话框关闭；button参数对应的扩展方法名称也是"button"

art.dialog({     id: ‘testID‘,     content: ‘hello world!‘,     button: [         {             name: ‘同意‘,             callback: function() {                 this.content(‘你同意了‘).time(2);                 returnfalse;             },             focus: true         },         {             name: ‘不同意‘,             callback: function() {                 alert(‘你不同意‘)             }         },         {             name: ‘无效按钮‘,             disabled: true         },         {             name: ‘关闭我‘         }     ] });

定时关闭的消息[time]

art.dialog({     time: 2,     content: ‘两秒后关闭‘ });

防止重复弹出[id]

art.dialog({     id: ‘testID2‘,     content: ‘再次点击运行看看‘ }); art.dialog({id: ‘testID2‘}).title(‘3秒后关闭‘).time(3);

定义消息图标[icon] 请查看skin/icons目录下的图标

art.dialog({     icon: ‘succeed‘,     content: ‘我可以定义消息图标哦‘ });

内容与边界填充边距[padding] 有时候并不需要默认的内容填充边距，如展示图片与视频

art.dialog({     padding: 0,     title: ‘照片‘,     content: ‘<img src="./images/photo.jpg" _cke_saved_src="./images/photo.jpg" width="379" height="500" />‘,     lock: true });

锁屏[lock & background & opacity] 

art.dialog({     lock: true,     background: ‘#600‘, // 背景色     opacity: 0.87,     // 透明度     content: ‘中断用户在对话框以外的交互，展示重要操作与消息‘,     icon: ‘error‘,     ok: function() {         art.dialog({content: ‘再来一个锁屏‘, lock: true});         returnfalse;     },     cancel: true });

跟随元素[follw] 1、标准形式

art.dialog({     follow: document.getElementById(‘followTestBtn‘),     content: ‘让对话框跟着某个元素，一个元素同时只能出现一个对话框‘ });

2、使用简写形式 （已经绑定onclick事件，注意此返回值不再是对话框扩展方法）

art(‘#demoCode_follow_a‘).dialog({     content: ‘让对话框跟着某个元素，一个元素同时只能出现一个对话框‘ });

自定义坐标[left & top]

art.dialog({     left: 100,     top: ‘60%‘,     content: ‘我改变坐标了‘ });

创建一个右下角浮动的消息窗口

art.dialog({     id: ‘msg‘,     title: ‘公告‘,     content: ‘hello world!‘,     width: 320,     height: 240,     left: ‘100%‘,     top: ‘100%‘,     fixed: true,     drag: false,     resize: false })

设置大小[width & height]

art.dialog({     width: ‘20em‘,     height: 55,     content: ‘尺寸可以带单位‘ });

创建一个全屏对话框

art.dialog({     width: ‘100%‘,     height: ‘100%‘,     left: ‘0%‘,     top: ‘0%‘,     fixed: true,     resize: false,     drag: false })

静止定位[fixed]

art.dialog({     fixed: true,     content: ‘请拖动滚动条查看‘ });

不许拖拽[drag & resize] 

art.dialog({     drag: false,     resize: false,     content: ‘禁止拖拽‘ });

扩展方法演示 特别说明：扩展方法支持链式操作 获取扩展方法一：直接引用返回 var dialog = art.dialog({     title: ‘我是对话框‘,     content: ‘我是初始化的内容‘ });       dialog.content(‘对话框内容被扩展方法改变了‘).title(‘提示‘);       获取扩展方法二：通过对话框ID art.dialog({     id: ‘KDf435‘,     title: ‘警告‘,     content: ‘我是初始化的内容‘ });       art.dialog.list[‘KDf435‘].content(‘对话框内容被扩展方法改变了‘);       获取扩展方法三：回调函数中this art.dialog({     title: ‘警告‘,     content: ‘我是初始化的内容‘,     ok: function () {         this.content(‘你点了确定按钮‘).lock();         return false;     },     init: function () {         this.content(‘对话框内容被扩展方法改变了‘);     } });       关闭页面所有对话框 var list = art.dialog.list; for (var i in list) {     list[i].close(); };

按钮接口演示 备注：回调函数如果返回false将阻止对话框关闭 var dialog = art.dialog({     title: ‘警告‘,     content: ‘点击管理按钮将让删除按钮可用‘,     width: ‘20em‘,     button: [{         name: ‘管理‘,         callback: function () {             this             .content(‘我更改了删除按钮‘)             .button({                 name: ‘删除‘,                 disabled: false             })             .lock();             return false;         },         focus: true     }] });   dialog.button(     {         name: ‘删除‘,         callback: function () {             alert(‘delect‘)         },         disabled: true     } )

标题倒计时 var timer; art.dialog({     content: ‘时间越来越少，越来越少..‘,     init: function () {         var that = this, i = 5;         var fn = function () {             that.title(i + ‘秒后关闭‘);             !i && that.close();             i --;         };         timer = setInterval(fn, 1000);         fn();     },     close: function () {         clearInterval(timer);     } }).show(); 关闭不删除内容 art.dialog({     id: ‘show-hide‘,     content: ‘关闭后阻止对话框被删除，只隐藏对话框‘,     close: function () {         this.hide();         return false;     } }).show(); AJAX高级应用：执行HTML片段中特殊script标签 HTML片段中的<script type="text/dialog"></script>标签包裹的javascript将会在artDialog内部执行，其this指向对话框扩展方法，这样可以进一步实现消息内容模块化。 (本例子使用了AJAX，需要在服务器上运行。可打开 ./ajaxContent/login.html 查看源码中的自定义脚本) var dialog = art.dialog({id: ‘N3690‘,title: false});   // jQuery ajax   $.ajax({     url: ‘./ajaxContent/login.html‘,     success: function (data) {         dialog.content(data);     },     cache: false }); 应用到你的项目 在页面head引入artDialog，其中skin参数表示对话框使用的风格文件(如果项目采用jQuery作为框架，则引用jQuery artDialog版本)。 <script src="artDialog/artDialog.js?skin=default" _cke_saved_src="artDialog/artDialog.js?skin=default"></script> 如果需要在iframe应用下提供 更好的支持 ，可加载插件： <script src="artDialog/plugins/iframeTools.js" _cke_saved_src="artDialog/plugins/iframeTools.js"></script> 配置全局默认参数(可选): (function (config) {     config[‘lock‘] = true;     config[‘fixed‘] = true;     config[‘okVal‘] = ‘Ok‘;     config[‘cancelVal‘] = ‘Cancel‘;     // [more..] })(art.dialog.defaults);

来源:http://www.91quanzi.com/article17/