插件官方地址: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 : '嗨,朋友,更多效果你自己慢慢发现吧。'}
});
