视觉相关
 
 
lock:开启锁屏
 
 
类型:Boolean默认:false说明:中断用户对话框之外的交互,用于显示非常重要的操作/消息,所以不建议频繁使用它,它会让操作变得繁琐
 
 
background:锁屏遮罩颜色
 
 
类型:String默认:'#FFF'说明:请注意这是一个会影响到全局的配置,后续出现的对话框的遮罩颜色都和此设置一样,再设置不再起作用
 
 
opacity:锁屏遮罩透明度
 
 
类型:Number默认:.5说明:请注意这是一个会影响到全局的配置,后续出现的对话框的遮罩透明度都和此设置一样,再设置不再起作用
 
 
icon:定义消息图标
 
 
类型:String默认:null说明:可定义“skins/icons/”目录下的图标名作为参数名(一定要包含后缀名)
 
 
padding:内容与边界填充边距(即css padding)
 
 
类型:String默认:'15px10px'说明:如果内容页为iframe方式加载的则在css里需要设置为0,要不在IE6中易出问题
 
 
skin:多皮肤共存时指定的皮肤样式
 
 
类型:String默认:''说明:指定窗口要使用的皮肤在加载的多皮肤共存的CSS文件中的相应主类名
 
 
交互相关
 
 
time:设置对话框显示时间
 
 
类型:Number默认:null说明:以秒为单位
 
 
resize:是否允许用户调节尺寸
 
 
类型:Boolean默认:true
 
 
drag:是否允许用户拖动位置
 
 
类型:Boolean默认:true
 
 
esc:是否允许用户按Esc键关闭对话框
 
 
类型:Boolean默认:true说明:只有窗口获得焦点后才能使用此功能
 
 
cache:是否缓存iframe方式加载的窗口内容页
 
 
类型:Boolean默认:true说明:只有使用iframe方式加载的单独页面的内容时此参数才有效
 
 
extendDrag:是否开启增强拖拽体验
 
 
类型:Boolean默认:true说明:1.此属性为全局性设置,不能在窗口调用的参数里设置,只能使用lhgdialog.setting.extendDrag来设置
     2.防止鼠标落入iframe导致不流畅,对超大对话框拖动优化 
 
高级相关
 
 
id:设定对话框唯一标识
 
 
类型:String|Number默认:null说明:1.防止重复弹出
     2.定义id后可以使用this.get(youID)和lhgdialog.list[youID]获取扩展方法 
 
zIndex:重置全局zIndex初始值
 
 
类型:Number默认:1976说明:用来改变对话框叠加高度,请注意这是一个会影响到全局的配置,后续出现的对话框叠加高度将重新按此累加。
 
 
init:对话框弹出后执行的函数
 
 
类型:Function默认:null说明:如果是以iframe方式加载的内容页此函数会在内容页加载完成后执行
 
 
close:对话框关闭前执行的函数
 
 
类型:Function默认:null说明:函数如果返回false将阻止对话框关闭。请注意这不是关闭按钮的回调函数,无论何种方式关闭对话框,close都将执行。
 
 
parent:打开子窗口的父窗口对象
 
 
类型:Object默认:null说明:此参数只用在打开多层窗口都使用遮罩层时才会用到此参数,注意多层窗口锁屏时一定要加此参数
 
 
扩展方法
 
 
窗口实例对象内部方法
 
 
close():关闭对话框
 
 
参数:无说明:在需要关闭窗口时可调用此方法
 
 
reload(win,url):刷新或跳转指定的页面
 
 
参数1:指定的要刷新或跳转的页面的window对象参数2:要跳转到的页面地址
 
 
show():显示对话框
 
 
参数:无
 
 
hide():隐藏对话框
 
 
参数:无
 
 
title(value):写入标题
 
 
参数1:标题的文本说明:无参数则返回创建的窗口对象实例
 
 
content(value,add,isFrm):向窗口中写入内容
 
 
参数1:value -- 窗口中的内容参数2:add -- 是否窗口中为后增加的内容参数3:isFrm -- 是否使用iframe方式加载窗口说明:如果参数1的前3个字符为'url:'则说明您使用iframe方式加载单独的内容页,这时第三个参数要为true,无参数则返回创建的窗口对象实例
 
 
button(arguments):插入一个自定义按钮
 
 
参数1:name -- 按钮名称参数2:callback -- 按下后执行的函数参数3:focus -- 是否聚焦点参数4:disabled -- 是否标记按钮为不可用状态(后续可使用扩展方法让其恢复可用状态)说明:此参数为多个对象示例:
 button({
    name: '登录',
    focus: true,
    callback: function(){}},{
    name: '取消'}); 
 
position(left,top):重新定位对话框
 
 
参数1:X轴的坐标参数2:Y轴的坐标说明:参数可以为数字或带单位的字符如:'200px'或使用'0%' ~ '100%'作为相对坐标
 
 
size(width,height):重新设定对话框大小
 
 
参数1:窗口的宽度参数2:窗口的高度说明:参数可以为数字或带单位的字符如:200或'200px'
 
 
max():最大化窗口
 
 
参数:无
 
 
min():最小化窗口
 
 
参数:无
 
 
lock():锁屏
 
 
参数:无
 
 
unlock():解锁
 
 
参数:无
 
 
time(val,callback):定时关闭(单位秒)
 
 
参数1:数值,以秒为单位参数2:回调函数说明:参数2为窗口关闭前执行的函数
 
 
focus() :自动设置窗口中焦点元素
 
 
参数:无
 
 
zindex() :置顶窗口
 
 
参数:无
 
 
get(id,object) :根据指定id获取相应的对象
 
 
参数1:窗口的id参数2:是否返回的是窗口实例对象说明:参数2的值只有为数字1时才返回指定id的窗口的实例对象
 
 
api:内容页中调用窗口实例对象接口
 
 
说明:此对象属性是附加在iframe元素的一个属性,在iframe方式加载的内容页中通过调用此函数来获取窗口的实例对象,示例:var api =frameElement.api; 注:此句代码是加在iframe方式加载的内容页中的,一定要注意
 
 
opener:加载窗口组件页面的window对象
 
 
说明:此属性主要用在iframe方式加载的内容页中,示例:var api = frameElement.api, W = api.opener; 此时的W即为加载窗口组件页面的window对象
 
 
iframe:iframe方式加载内容的iframe对象
 
 
说明:此属性主要用于在窗口组件调用页面操作窗口中的iframe对象
 
 
iwin:iframe方式加载内容页的window对象
 
 
说明:此属性主要用于在窗口组件调用页面操作窗口中的window对象,示例:var dg = $.dialog({'url:content.html',init:function(){ if( this.iwin.document.body) alert('窗口内容页加载完成'); });
 
 
窗口外部方法
 
 
$.dialog.focus:获取焦点的窗口实例对象
 
 
说明:可以使用此属性获取儿得焦点的窗口的对象,示例:var dg = $.dialog.focus;此时的dg就是当前焦点窗口的对象实例
 
 
$.dialog.list:所有窗口对象实例的集合
 
 
说明:通过此属性可获取所有打开的窗口对象,示例:关闭页面所有对话框var list =$.dialog.list;for( var i in list ){
    list[i].close();} 
 
$.dialog.data(name,value):跨框架数据共享写入接口
 
 
参数1:存储的数据名参数2:将要存储的任意数据(无此项则返回被查询的数据,如果此值为false就删除指定名称的数据)说明:框架与框架之间以及与主页面之间进行数据交换是非常头疼的事情,常规情况下你必须知道框架的名称才能进行数据交换,如果是在复杂的多层框架下操作简直就是噩梦。而data方法就是为了解决这个问题,你完全不用管框架层级问题,它可以写入任何类型的数据,而做到各个页面之间数据共享。
 
 
扩展的一些提示性的窗口
 
 
$.dialog.alert(content,callback,parent):警告消息
 
 
参数1:内容参数2:窗口关闭时执行的回调函数参数3:警告窗口的父窗口对象
 
 
$.dialog.confirm(content,yes,no,parent):确认
 
 
参数1:内容参数2:确定按钮回调函数参数3:取消按钮回调函数参数4:确认窗口的父窗口对象
 
 
$.dialog.prompt(content,yes,value,parent):提问
 
 
参数1:内容参数2:确定按钮回调函数参数3:文本框默认值参数4:提问窗口的父窗口对象
 
 
$.dialog.tips(content,time,icon,callback):短暂提示
 
 
参数1:内容参数2:显示时间参数3:提示图标参数4:提示关闭时执行的函数