layer.open属性详解

使用案例：

layer.open({
    type: 1,
    title: '查看',
    closeBtn: 1,
    anim: 2,
    shadeClose: true,
    area: ['400px', '500px'],
    content: $('#layer_demo'),
    btn: ['确定', '取消'],
    yes: function (index, layero) {
        layer.close(index);
    },
    cancel: function (index, layero) {
        layer.close(index);
    }
});

属性详解

type -- 基本层类型

类型：Number，默认：0

0（信息框，默认）1（页面层）2（iframe层）3（加载层）4（tips层）；

title -- 标题

类型：String/Array/Boolean，默认：'信息'

title支持三种类型的值：

1、普通字符串，title :'标题'；

2、自定义标题区域样式，title: ['标题文本', 'font-size:18px;']，数组第二项可写任意css样式；

3、不显示标题栏，title: false；

skin -- 样式类名

类型：String，默认：''

skin允许传入layer内置的样式class名、自定义的class名，可以借助skin轻松完成不同的风格定制

目前layer内置的skin有：layui-layer-lanlayui-layer-molv

推荐定义：（如下）

//单个使用
layer.open({
  skin: 'demo-class'
});
//全局使用。即所有弹出层都默认采用，但是单个配置skin的优先级更高
layer.config({
  skin: 'demo-class'
})

//CSS 
body .demo-class .layui-layer-title{background:#c00; color:#fff; border: none;}
body .demo-class .layui-layer-btn{border-top:1px solid #E9E7E7}
body .demo-class .layui-layer-btn a{background:#333;}
body .demo-class .layui-layer-btn .layui-layer-btn1{background:#999;}

content -- 内容

类型：String/DOM/Array，默认：''

// 页面层
layer.open({
    type: 1,
    content: '传入任意的文本或html'
});
layer.open({
    type: 1,
    content: $('#id') // 注意：最好该元素要存放在body最外层，否则可能被其它的相对元素所影响
});
// Ajax获取
$.post('url', {}, function (str) {
    layer.open({
        type: 1,
        content: str // 注意，如果str是object，那么需要字符拼接。
    });
});
// iframe层
layer.open({
    type: 2,
    content: 'http://sentsin.com' //这里content是一个URL
    // content: ['http://sentsin.com', 'no'] // iframe不出现滚动条
});
// tips层
layer.open({
    type: 4,
    content: ['内容', '#id'] //数组第二项即吸附元素选择器或者DOM
});

area -- 宽高

类型：String/Array，默认：'auto'

在默认状态下，layer是宽高都自适应的

若要定义宽度：area: '500px'，高度仍然是自适应的

若要定义宽高：area: ['500px', '300px']

btn -- 按钮

类型：String/Array，默认：'确认'

信息框模式时，btn默认是一个确认按钮，其它层类型则默认不显示，加载层和tips层则无效。

自定义单个按钮，btn: "确认按钮1"

自定义两个按钮，btn: ['确认按钮1', '确认按钮2']

自定义多个按钮，btn: ['按钮1', '按钮2', '按钮3', …]

例子：

//自定义1       
layer.confirm('test', {
    btn: ['按钮一', '按钮二', '按钮三'] //可以无限个按钮
    , btn3: function (index, layero) {
        //按钮【按钮三】的回调
    }
}, function (index, layero) {
    //按钮【按钮一】的回调
}, function (index) {
    //按钮【按钮二】的回调
});

//自定义2
layer.open({
    content: 'test'
    , btn: ['按钮一', '按钮二', '按钮三']
    , yes: function (index, layero) {
        //按钮【按钮一】的回调
    }
    , btn2: function (index, layero) {
        //按钮【按钮二】的回调
        //return false 开启该代码可禁止点击该按钮关闭
    }
    , btn3: function (index, layero) {
        //按钮【按钮三】的回调
        //return false 开启该代码可禁止点击该按钮关闭
    }
    , cancel: function () {
        //右上角关闭回调
        //return false 开启该代码可禁止点击该按钮关闭
    }
});

offset -- 坐标

类型：String/Array，默认：垂直水平居中

offset默认情况下不用设置。但如果你不想垂直水平居中，你还可以进行以下赋值：

值	备注
offset: 'auto'	默认坐标，即垂直水平居中
offset: '100px'	只定义top坐标，水平保持居中
offset: ['100px', '50px']	同时定义top、left坐标
offset: 't'	快捷设置顶部坐标
offset: 'r'	快捷设置右边缘坐标
offset: 'b'	快捷设置底部坐标
offset: 'l'	快捷设置左边缘坐标
offset: 'lt'	快捷设置左上角
offset: 'lb'	快捷设置左下角
offset: 'rt'	快捷设置右上角
offset: 'rb'	快捷设置右下角

icon -- 图标

信息框和加载层的私有参数

类型：Number，默认：-1（信息框）0（加载层）

信息框默认不显示图标

若需显示图标时，默认皮肤可以传入0-6

若是加载层，可以传入0-2

//eg1
layer.alert('酷毙了', {icon: 1});
//eg2
layer.msg('不开心。。', {icon: 5});
//eg3
layer.load(1); //风格1的加载

btnAlign -- 按钮排列

类型：String，默认：r

该参数可支持的赋值：

值	备注
btnAlign: 'l'	按钮左对齐
btnAlign: 'c'	按钮居中对齐
btnAlign: 'r'	按钮右对齐。默认值，不用设置

closeBtn -- 关闭按钮

类型：String/Boolean，默认：1

layer提供了两种风格的关闭按钮，可通过配置1和2来展示

若不显示，则closeBtn: 0

shade -- 遮罩

类型：String/Array/Boolean，默认：0.3（'#000'）

自定义颜色shade: [0.8, '#393D49']

不显示遮罩shade: 0

shadeClose -- 是否点击遮罩关闭

类型：Boolean，默认：false

如果你的shade是存在的，那么你可以设定shadeClose来控制点击弹层外区域关闭。

time -- 自动关闭所需毫秒

类型：Number，默认：0

默认不会自动关闭。

若需自动关闭时，可以time: 5000，即代表5秒后自动关闭，注意单位是毫秒（1秒=1000毫秒）

success -- 层弹出后的成功回调方法

类型：Function，默认：null

success会携带两个参数，分别为：当前层索引参数（index）、当前层的DOM对象（layero）

layer.open({
    content: '测试回调',
    success: function(layero, index){
        console.log(layero, index);
    }
});

yes -- 确定按钮回调方法

类型：Function，默认：null

该回调携带两个参数，分别为：当前层索引参数（index）、当前层的DOM对象（layero）

layer.open({
    content: '确定回调测试',
    yes: function(index, layero){
        //do something
        layer.close(index); //如果设定了yes回调，需进行手工关闭
    }
});

cancel -- 右上角关闭按钮触发的回调

类型：Function，默认：null

该回调携带两个参数，分别为：当前层索引参数（index）、当前层的DOM对象（layero）

默认会自动触发关闭，如果不想关闭，return false即可

cancel: function(index, layero){
    if(confirm('确定关闭吗')){ //只有当点击confirm框的确定时，该层才会关闭
        layer.close(index)
    }
    return false;
}

end -- 层销毁后触发的回调

类型：Function，默认：null

无论是确认还是取消，只要层被销毁了，end都会执行，不携带任何参数。

full/min/restore -- 分别代表最大化、最小化、还原 后触发的回调

类型：Function，默认：null

携带两个参数，分别为：当前层索引参数（index）、当前层的DOM对象（layero）

min: function(layero, index){ 
    //index 参数为 layui 2.6.6 或独立版 layer 3.5.0 开始新增
    //当层最小化时触发
 
    //自定义操作，并阻止默认最小化
    //layer.min(index); //单独执行最小化
    //return false;     //阻止默认最小化
}

id -- 用于控制弹层唯一标识

类型：String，默认：空字符

设置该值后，不管是什么类型的层，都只允许同时弹出一个。一般用于页面层和iframe层模式