模块加载名称:layer,layer独立组件官网:layer.layui.co
转载自:https://www.w3cschool.cn/layui/c86d1r32.html
1.type-基本层类型
类型:Number,默认:0
layer提供了5种层类型。可传入的值有:0
(信息框,默认)1
(页面层)2
(iframe层)3
(加载层)4
(tips层)
2.title-标题
类型:String/Array/Boolean,默认:'信息'
title支持三种类型的值,若你传入的是普通的字符串,如title :'我是标题'
,那么只会改变标题文本;若你还需要自定义标题区域样式,那么你可以title: ['文本', 'font-size:18px;']
,数组第二项可以写任意css样式;如果你不想显示标题栏,你可以title: false
3.content-内容
类型:String/DOM/Array,默认:''
content可传入的值是灵活多变的,不仅可以传入普通的html内容,还可以指定DOM,更可以随着type的不同而不同。
/!* 如果是页面层 */layer.open({ type: 1, content: '传入任意的文本或html' //这里content是一个普通的String});layer.open({ type: 1, content: $('#id') //这里content是一个DOM}); //Ajax获取$.post('url', {}, function(str){ layer.open({ type: 1, content: str //注意,如果str是object,那么需要字符拼接。 });});/!* 如果是iframe层 */layer.open({ type: 2, content: 'http://sentsin.com' //这里content是一个URL,如果你不想让iframe出现滚动条,你还可以content: ['http://sentsin.com', 'no']
}); /!* 如果是用layer.open执行tips层 */layer.open({ type: 4, content: ['内容', '#id'] //数组第二项即吸附元素选择器或者DOM});
4.skin_样式
类型:String,默认:''
skin不仅允许你传入layer内置的样式class名,还可以传入您自定义的class名。这是一个很好的切入点,意味着你可以借助skin轻松完成不同的风格定制。目前layer内置的skin有:layui-layer-lan
layui-layer-molv
,未来我们还会选择性地内置更多,但更推荐您自己来定义。以下是一个自定义风格的简单例子
- 5.area-宽高
-
类型:String/Array,默认:'auto'
在默认状态下,layer是宽高都自适应的,但当你只想定义宽度时,你可以
area: '500px'
,高度仍然是自适应的。当你宽高都要定义时,你可以area: ['500px', '300px']
类型:String/Array,默认:'auto'
默认垂直水平居中。但当你只想定义top时,你可以offset: '100px'
。当您top、left都要定义时,你可以offset: ['100px', '200px']
。除此之外,你还可以定义offset: 'rb'
,表示右下角。其它的特殊坐标,你可以自己计算赋值。
类型:Number,默认:-1(信息框)/0(加载层)
信息框默认不显示图标。当你想显示图标时,默认皮肤可以传入0-6
如果是加载层,可以传入0-2
。如:
8.btn-按钮
类型:String/Array,默认:'确认'
信息框模式时,btn默认是一个确认按钮,其它层类型则默认不显示,加载层和tips层则无效。当您只想自定义一个按钮时,你可以btn: '我知道了'
,当你要定义两个按钮时,你可以btn: ['yes', 'no']
。当然,你也可以定义更多按钮,比如:btn: ['按钮1', '按钮2', '按钮3', …]
,按钮1和按钮2的回调分别是yes和cancel,而从按钮3开始,则回调为btn3: function(){},以此类推。如:
9.closeBtn-关闭按钮
-
类型:String/Boolean,默认:1
layer提供了两种风格的关闭按钮,可通过配置
1
和2
来展示,如果不显示,则closeBtn: 0
10.fix-固定
-
类型:Boolean,默认:true
即鼠标滚动时,层是否固定在可视区域。如果不想,设置
fix: false
即可
11.moveOut-是否允许拖拽到窗口外
类型:Boolean,默认:false
默认只能在窗口内拖拽,如果你想让拖到窗外,那么设定moveOut: true
即可
12.layer.alert(content,options,yes)-普通提示框
-
它的弹出似乎显得有些高调,一般用于对用户造成比较强烈的关注,类似系统alert,但却比alert更灵便。它的参数是自动向左补齐的。通过第二个参数,可以设定各种你所需要的基础参数,但如果你不需要的话,直接写回调即可。如
codelayui.code
- //eg1
- layer.alert('只想简单的提示');
- //eg2
- layer.alert('加了个图标', {icon: 1}); //这时如果你也还想执行yes回调,可以放在第三个参数中。
- //eg3
- layer.alert('有了回调', function(index){
- //do something
- layer.close(index);
- });
13.layer.confirm(content,options,yes,cancel)-询问框
-
类似系统confirm,但却远胜confirm,另外它
不是和系统的confirm一样阻塞
你需要把交互的语句放在回调体中。同样的,它的参数也是自动补齐的。codelayui.code
- //eg1
- layer.confirm('is not?', {icon: 3, title:'提示'}, function(index){
- //do something
- layer.close(index);
- });
- //eg2
- layer.confirm('is not?', function(index){
- //do something
- layer.close(index);
- });
14.layer.msg(content,options,end)-提示框
我在源码中有了相对较大的篇幅来定制了这个msg,目的是想将其打造成露脸率最高的提示框。而事实上我的确也在大量地使用它。因为它简单,而且足够得自觉,它不仅占据很少的面积,而且默认还会3秒后自动消失
所有这一切都决定了我对msg的爱。因此我赋予了她许多可能
在外形方面,它坚持简陋的变化,在作用方面,他坚持零用户操作。而且它的参数也是机会自动补齐的。
codelayui.code
- //eg1
- layer.msg('只想弱弱提示');
- //eg2
- layer.msg('有表情地提示', {icon: 6});
- //eg3
- layer.msg('关闭后想做些什么', function(){
- //do something
- });
- //eg
- layer.msg('同上', {
- icon: 1,
- time: 2000 //2秒关闭(如果不配置,默认是3秒)
- }, function(){
- //do something
- });
15.layer.load(icon,options)-加载层
type:3的深度定制。load并不需要你传太多的参数,但如果你不喜欢默认的加载风格,你还有选择空间。icon支持传入0-2
如果是0,无需传。另外特别注意一点:load默认是不会自动关闭的
,因为你一般会在ajax回调体中关闭它。
codelayui.code
- //eg1
- var index = layer.load();
- //eg2
- var index = layer.load(1); //换了种风格
- //eg3
- var index = layer.load(2, {time: 10*1000}); //又换了种风格,并且设定最长等待10秒
- //关闭
- layer.close(index);
16.layer.tips(content,follow,options)-tips层
-
type:4的深度定制。也是我本人比较喜欢的一个层类型,因为它拥有和msg一样的低调和自觉,而且会
智能定位
,即灵活地判断它应该出现在哪边。默认是在元素右边弹出codelayui.code
- //eg1
- layer.tips('只想提示地精准些', '#id');
- //eg 2
- $('#id').on('click', function(){
- var that = this;
- layer.tips('只想提示地精准些', that); //在元素的事件回调体中,follow直接赋予this即可
- });
- //eg 3
- layer.tips('在上面', '#id', {
- tips: 1
- });
关于它似乎没有太多介绍的必要,唯一让你疑惑的,可能就是这个index
了吧
codelayui.code
- //当你想关闭当前页的某个层时
- var index = layer.open();
- var index = layer.alert();
- var index = layer.load();
- var index = layer.tips();
- //正如你看到的,每一种弹层调用方式,都会返回一个index
- layer.close(index); //此时你只需要把获得的index,轻轻地赋予layer.close即可
- //当你在iframe页面关闭自身时
- var index = parent.layer.getFrameIndex(window.name); //先得到当前iframe层的索引
- parent.layer.close(index); //再执行关闭
18.layer.closeAll(type)-关闭所有层
如果你很懒,你不想去获取index
你只想关闭。那么closeAll真的可以帮上你。如果你不指向层类型的话,它会销毁掉当前页所有的layer层。当然,如果你只想关闭某个类型的层,那么你可以
codelayui.code
- layer.closeAll(); //疯狂模式,关闭所有层
- layer.closeAll('dialog'); //关闭信息框
- layer.closeAll('page'); //关闭所有页面层
- layer.closeAll('iframe'); //关闭所有的iframe层
- layer.closeAll('loading'); //关闭加载层
- layer.closeAll('tips'); //关闭所有的tips层