插件官方地址:http://xu.sentsin.com/jquery/layer/
| 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);
});
}
|
下面是一些示例:
自己写的一段可用的代码:
$("#btnId").click(function(){//btnId为触发弹出层的按钮ID
$.layer({
type : 1,
title : [\'新增图片内容\' , true],
offset : [\'30px\' , \'50%\'],
area : [\'855px\',\'350px\'],
page : {dom : \'#tt\'},
success : function(layer){
//加载层成功,绑定确定和关闭按钮
$(\'#div2Sure\').unbind(\'click\').bind(\'click\',function(){
var index = LAYER.getIndex(this);
LAYER.close(index);
});
$(\'#div2Close\').unbind(\'click\').bind(\'click\',function(){
var index = LAYER.getIndex(this);
LAYER.close(index);
});
}
});
});
官网上的示例:
//信息框一
$.layer({
area : [\'auto\',\'auto\'],
dialog : {msg:\'白菜级别前端攻城师贤心\',type : 8}
});
//信息框二
$.layer({
shade : [\'\',false],
area : [\'auto\',\'auto\'],
title : [\'\',false],
dialog : {msg:\'前端攻城师贤心\'}
});
//询问框
$.layer({
shade : [\'\',false],
area : [\'auto\',\'auto\'],
dialog : {
msg:\'您是如何看待前端开发?\',
btns : 2,
type : 4,
btn : [\'重要\',\'奇葩\'],
yes : function(){
layer.msg(\'您选择了重要。\',2,1);
},
no : function(){
layer.msg(\'奇葩!!!\',2,4);
}
}
});
//页面层一
$.layer({
shade : [\'\',false],
type : 1,
area : [\'auto\',\'auto\'],
offset : [\'300px\',\'\'],
border : [10 , 0.5 , \'#628C1C\', true],
page : {dom : \'.layer_notice\'},
close : function(index){
LAYER.close(index);
$(\'.layer_notice\').show();
}
});
//页面层二
$.layer({
type : 1,
title : [\'\',false],
fix : false,
offset:[\'50px\' , \'\'],
area : [\'auto\',\'auto\'],
shadeClose : true,
page : {dom : \'#tong\'}
});
$(\'#tong\').live(\'click\',function(){
var index = LAYER.getIndex(this);
LAYER.close(index);
});
//iframe层
$.layer({
type : 2,
closeBtn : [0,false],
time : 5,
iframe : {
src : \'http://player.youku.com/player.php/sid/XMjY3MzgzODg0/v.swf\'
},
title : [\'\' , false],
area : [\'500px\',\'300px\'],
success : function(){ //层加载成功后进行的回调
LAYER.shift(\'right-bottom\',1000); //浏览器右下角弹出
},
end : function(){ //层彻底关闭后执行的回调
$.layer({
type : 2,
offset : [\'100px\' , \'\'],
iframe : {
src : \'http://xu.sentsin.com/about/\'
},
area : [\'960px\',\'500px\']
})
}
});
//加载层
$.layer({
type : 3,
time : 2
});
//小tips层
$(\'.class\').click(function(){
layer.tips(\'我爱你,你爱我吗?\' , this , 3);
});
信息框一:
layer.alert(\'一个很普通的信息框\');
信息框二:
$.layer({
area : [\'auto\',\'auto\'],
title : [\'\',false],
dialog:{msg:\'信息框演示二\'}
});
信息框三:
layer.confirm(\'信息框演示三\',function(index){
LAYER.close(index);
layer.msg(\'信息框演示三\');
});
信息框四:
$.layer({
fix : false,
move : [\'\',false],
shade : [\'\' , \'\' , false],
area : [\'auto\',\'auto\'],
dialog:{msg:\'这是一个既不能固定,又不能拖拽的层\'}
});
信息框之变脸:
var i = 0;
$.layer({
dialog:{type:0,msg:\'<a href="javascript:;" id="setface">点击我,试试变脸</a>\'},
success : function(layer){
$(\'#setface\').unbind(\'click\').bind(\'click\',function(){
var index = LAYER.getIndex(this);
i++;
layer.find(\'.xubox_msgico\').removeClass(\'xubox_msgtype\'+(i-1)).addClass(\'xubox_msgtype\'+i);
i > 10 && LAYER.close(index);
});
},
end : function(){
i = 0;
}
});
信息框六:
layer.msg(\'2秒后自动关闭\');
一:页面层之仿百度登录:
$.layer({
type : 1,
title : [\'\',false],
closeBtn : [\'\',false],
border : [\'\',\'\',\'\',false],
area : [\'455px\',\'371px\'],
page : {dom : \'#baidu\'}
});
$(\'#baidu\').live(\'click\',function(){
var index = LAYER.getIndex(this);
LAYER.close(index);
});
二、页面层之图片:
$.layer({
type : 1,
title : [\'\',false],
fix : false,
offset:[\'50px\' , \'\'],
area : [\'515px\',\'615px\'],
page : {dom : \'#tong\'}
});
$(\'#tong\').live(\'click\',function(){
var index = LAYER.getIndex(this);
LAYER.close(index);
});
三、页面层之淘宝:
$.layer({
type : 1,
title : [\'\',false],
offset:[\'150px\' , \'\'],
border : [\'\',\'\',\'\',false],
area : [\'503px\',\'395px\'],
page : {dom : \'#taobao\'}
});
$(\'#taobao\').live(\'click\',function(){
var index = LAYER.getIndex(this);
LAYER.close(index);
});
一:iframe层之从左下角弹出
$.layer({
type : 2,
title : [\'\',false],
iframe : {src : \'http://pic10.nipic.com/20101023/145234_134017065776_2.gif\'},
area : [\'350px\' , \'466px\'],
success : function(){
LAYER.shift(\'left-bottom\',400);
}
});
二:iframe层之正中央
$.layer({
type : 2,
title : [\'天之痕三个人的时光-半抱琵琶版\',true],
iframe : {src : \'http://www.tudou.com/v/Rvy0IbYmBrQ/&resourceId=0_04_05_99/v.swf\'},
area : [\'750px\' , \'466px\'],
offset : [\'100px\',\'\']
});
三:iframe层之子父操作
$.layer({
type : 2,
title : [\'iframe子父操作测试\',true],
iframe : {src : \'iframe.html\'},
area : [\'200px\' , \'206px\'],
offset : [\'150px\',\'\'],
close : function(index){
alert(\'您得到了子窗口的所有文本:\' + LAYER.getChildFrame(\'body\').text());
LAYER.close(index);
}
});
子窗口操作父窗口:
$(\'#a\').click(function(){
var index = parent.LAYER.getFrameIndex();
parent.LAYER.close(index);
});
加载层一:
$.layer({
type : 3,
time : 2
}); 或:layer.load(3,2);
加载层二:
$.layer({
type : 3,
time : 2,
shade : [\'\',\'\',\'\',false],
border : [0,\'\',\'\',\'\',false],
loading : {type : 3}
});
一:tips小提示层
layer.tips(\'嗨,朋友,更多效果你自己慢慢发现吧。\',this);
二:渐显弹出layer
$.layer({
area : [\'\',\'auto\'],
fadeIn : [500,true],
dialog : {msg : \'嗨,朋友,更多效果你自己慢慢发现吧。\'}
});