layer API之键值(仅在需要时配置,未配置的会用默认) | ||
---|---|---|
键值对 | 描述 | 备注 |
skin : 0 | 层的皮肤编号,值为整数型。 | 目前默认只提供一种皮肤,当你按照样式规则新增皮肤时,你需配置该参数。 |
shade : [0.5 , '#000' , true] | 控制遮罩。0.5:遮罩透明度,'#000':遮罩颜色,true:是否遮罩(否:false) | |
shadeClose : false | 用来控制点击遮罩区域是否关闭层。(是:true) | 实用 |
fix : true, | 层是否固定。否:false | 实用 |
move : ['.xubox_title' , true] | 控制层拖拽。'.xubox_title':拖拽绑定事件所在元素选择器(默认为标题栏),true:是否允许拖拽(否:false) | |
type : 0, | 层的类型。0:信息框(默认),1:页面层,2:iframe层,3:加载层,4:小tips层 | 重要参数,在调用不同层类型时必须设置 |
title : ['信息' , true] | 控制标题栏。'信息':标题栏文字,true:是否显示标题栏(否:false) | |
offset : ['220px' , '50%'] | 控制层坐标。'220px':纵坐标,'50%':横坐标 | 较重要参数 |
area : ['310px' , 'auto'] | 控制层宽高。'310px':宽,'auto':高 | 重要参数 |
closeBtn : [0 , true] | 控制层右上角关闭按钮。0:关闭按钮风格(1:风格2),true:是否显示关闭按钮(否:false) | |
time : 0 | 自动关闭等待秒数,整数值 | 实用 |
border : [10 , 0.3 , '#000', true] | 10:边框大小,0.3:边框透明度,'#000':边框颜色,true:是否显示边框(否:false) | 通过它您可以任意配置边框,如果你觉得她碍眼,你完全可以不输出她。 |
zIndex : 19891014 | 控制层堆叠顺序(z-index)。整数值,默认是贤心的生日。 | 合理设置它,可以避免与其它插件的z-index冲突 |
maxWidth : 400 | 最大宽度。整数值。 | 当宽度设为auto时才有用。 |
fadeIn : [300 , false] | 控制层的渐显。300:渐显频率,false:是否开启渐显(默认不开启,true:开启) | 这效果,有人爱、有人厌。 |
dialog : { btns : 1, btn : ['确定','取消'], type : 3, msg : '', yes : function(index){ }, no : function(index){ } } | 信息框层模式私有参数。 btns : 按钮的个数。提供了0-2的选择 btn : [按钮一的值 , 按钮二的值] type : 图标类型,提供了0-10的选择,可以试一试每一个图标,有你喜欢的吗? msg : 信息框内容,重要参数 yes :按钮一的回调 no :按钮二的回调 | 很常用 |
page : {dom : '#xulayer'} | 页面层模式私有参数。dom:需要弹出的html片段所对应的选择器(class 或 id,推荐用id,确保唯一。) | 当你设置了type:1时,dom是必须要设置的,否则无法捕获元素。很常用。 |
iframe : {src : 'http://xu.sentsin.com'} | iframe层模式私有参数。src:要打开的网址 | 使用率非常高,尤其是对于喜欢用iframe的同学。 |
loading : {type : 0} | 加载层私有属性。type:loading图标类型(提供了0-3的选择,试试吧,看看有无你喜欢的) | 配合ajax,在执行之前使用,ajax请求成功后,必须用加载层私有方法将其关闭:LAYER.loadClose(); |
tips : { msg : '', follow : '' } | tips小提示层私有属性。msg:提示内容,follow:触发事件对应的选择器 | tips的界面似乎戳了点,不过将就着用吧,实在不行就去layer.css改一下。 |
success : function(layer){} | 层弹出成功后的回调函数 | 层展现后,你想必需要做一些其它的事件处理吧,那么,写在这里面 |
close : function(index){} | 层右上角关闭按钮的回调函数。 | 想一下,有时点击关闭你是否需要做别的行为处理,那么,你应该写在这里面 |
end : function(){} | 层被彻底关闭后执行的回调函数。 | 你认为她跟close回调相似?那你错了,close绑定的是关闭按钮的click事件,而end,只是单纯的一个回调,当设置了自动关闭时,它可能会派上用场不是? |
layer API之内置方法 | ||
---|---|---|
方法名 | 描述 | 备注 |
layer.alert() | layer对象下的方法,对单个按钮信息框层的重新封装,layer.alert(alertMsg , alertType, alertTit , alertYes),四个参数,alertMsg:信息内容(文本),alertType:提示图标(整数,0-10的选择),alertTit:标题(文本),alertYes:按钮的回调函数 | 如:layer.alert('前端攻城师贤心') |
layer.confirm() | layer对象下的方法,对询问框的重新封装,layer.confirm(conMsg , conYes , conTit , conNo),四个参数,conMsg:信息内容(文本),conYes:按钮一回调,conTit:标题(文本),conNo:按钮二的回调 | 如: layer.confirm('确定删除',function(){ layer.msg('删除成功!') }); |
layer.msg() | layer对象下的方法,对无标题栏信息框层的重新封装,layer.msg(msgText , msgTime , msgType , maxWidth),四个参数,msgText:信息内容(文本),msgTime:自动关闭所需等待秒数(默认2秒),msgType:提示图标(整数,0-10的选择),maxWidth:最大宽度 | 如:layer.msg('嗨,伙计,我是layer') |
layer.tips() | layer对象下的方法,对tips层的重新封装,layer.tips(html , follow , time , maxWidth),四个参数,html:信息内容(文本),follow:触发事件对应的选择器,time:自动关闭所需等待秒数,maxWidth:最大宽度 | 如: $('.demo').click(function(){ layer.tips('这是小提示',this); }); |
layer.load() | layer对象下的方法,对加载层的重新封装,layer.load(loadTime , loadgif , loadShade),三个参数,loadTime:自动关闭所需等待秒数,loadgif:加载图标(整数,0-3的选择),loadShade:是否遮罩(true 或 false) | 如:layer.load(3); |
LAYER.getIndex(index) | LAYER对象下的方法,开启页面层模式(type:1时)后才有用,用于获取layer的当前索引,从而协助通过非layer元素触发事件所执行的关闭方法 | 如: success : function(){ $('#test').click(function(){ var index = LAYER.getIndex(this); LAYER.close(index); }); } |
LAYER.getChildFrame(selector) | LAYER对象下的方法,获取子iframe中的DOM | 非常实用,父窗口操作iframe中内容时可以大显神威。如:LAYER.getChildFrame('body').html() //得到iframe的body的全部html元素 |
LAYER.getFrameIndex() | LAYER对象下的方法,得到iframe层的索引,子iframe操作父窗口时使用 | $('#a').click(function(){ var index = parent.LAYER.getFrameIndex(); parent.LAYER.close(index); }); |
LAYER.close(index) | LAYER对象下的方法,用于在执行回调后关闭层 | 如: yes : function(index){ LAYER.close(index); layer.msg('已删除'); } |
LAYER.loadClose() | LAYER对象下的方法,用于关闭加载层,仅loading私有 | |
LAYER.shift(type , rate) | layer弹出时内置动画,type:动画类型,供四种中选择,左上:'left-top',右上:'right-top',左下:'left-bottom',右下:'right-bottom' 。 rate:动画频率,毫秒 | 如: success : function(){ LAYER.shift('right-bottom' , 400); } |
LAYER.loadClose() | LAYER对象下的方法,用于关闭加载层,仅loading私有 | |
LAYER.autoArea(index) | 用来处理在层中宽高改变时,重新自适应层宽高。 | 如: success : function(){ $('#test').click(function(){ $(this).append('</div>新增的元素</div>'); var index = LAYER.getIndex(this); LAYER.autoArea(index); }); } |
URL:http://xu.sentsin.com/jquery/layer/