layer是一款近年来备受青睐的web弹层组件,是layui中的一个弹层模块。
因项目需要,翻了它的牌子,记录下
由于layer可以独立使用,也可以通过Layui模块化使用。所以请按照你的实际需求来选择。
使用场景 | 用前准备 | 调用方式 |
---|---|---|
作为独立组件使用 | 如果你只是单独想使用 layer,你可以去 layer 独立版本官网下载组件包。你需要在你的页面引入jQuery_1.8以上的任意版本,并引入layer.js。 | 通过script标签引入layer.js后,直接用即可。 |
layui 模块化使用 | 如果你使用的是 layui,那么你直接在官网下载 layui 框架即可,无需引入 jQuery 和 layer.js,但需要引入layui.css和layui.js | 通过_layui.use('layer', callback)_加载模块 |
作为独立组件使用 layer
1. 引入好layer.js后,直接用即可
2.
3.
在 layui 中使用 layer
1. layui.use('layer', function(){
2. var layer = layui.layer;
4. layer.msg('hello');
5. });
常用的示例如下
1. 询问层
//询问框
1. layer.confirm('您是如何看待前端开发?', {
2. btn: \['重要','奇葩'\] //按钮
3. }, function(){
4. layer.msg('的确很重要', {icon: 1});
5. }, function(){
6. layer.msg('也可以这样', {
7. time: 20000, //20s后自动关闭
8. btn: \['明白了', '知道了'\]
9. });
10. });
2. loading层
//loading层
1. var index = layer.load(1, {
2. shade: \[0.1,'#fff'\] //0.1透明度的白色背景
3. });
3. 提示层
//提示层
1. layer.msg('玩命提示中');
4. 页面层
//页面层
1. layer.open({
2. type: 1,
3. skin: 'layui-layer-rim', //加上边框
4. area: \['420px', '240px'\], //宽高
5. content: 'html内容'
6. });
5. tips层
//tips层
1. layer.tips('Hi,我是tips', '吸附元素选择器,如#id');
6. prompt层
//prompt层
1. layer.prompt({title: '输入任何口令,并确认', formType: 1}, function(pass, index){
2. layer.close(index);
3. layer.prompt({title: '随便写点啥,并确认', formType: 2}, function(text, index){
4. layer.close(index);
5. layer.msg('演示完毕!您的口令:'+ pass +'
您最后写下了:'+text);
6. });
7. });
6. 页面层-自定义
1. layer.open({
2. type: 1,
3. skin: 'layui-layer-demo', //样式类名
4. closeBtn: 0, //不显示关闭按钮
5. anim: 2,
6. shadeClose: true, //开启遮罩关闭
7. content: '内容'
8. });
等等还有很多,以上列出几个常用的,其他可根据需要去layer官方网站按需搬运。。。
接下来列一下layer的基础参数
type - 基本层类型
类型:Number,默认:0
layer提供了5种层类型。可传入的值有:0(信息框,默认)1(页面层)2(iframe层)3(加载层)4(tips层)。 若你采用layer.open({type: 1})方式调用,则type为必填项(信息框除外)
title - 标题
类型:String/Array/Boolean,默认:'信息'
title支持三种类型的值,若你传入的是普通的字符串,如title :'我是标题',那么只会改变标题文本;若你还需要自定义标题区域样式,那么你可以title: ['文本', 'font-size:18px;'],数组第二项可以写任意css样式;如果你不想显示标题栏,你可以title: false
content - 内容
类型:String/DOM/Array,默认:''
content可传入的值是灵活多变的,不仅可以传入普通的html内容,还可以指定DOM,更可以随着type的不同而不同。
skin - 样式类名
类型:String,默认:''
skin不仅允许你传入layer内置的样式class名,还可以传入您自定义的class名。这是一个很好的切入点,意味着你可以借助skin轻松完成不同的风格定制。目前layer内置的skin有:layui-layer-lan layui-layer-molv
area - 宽高
类型:String/Array,默认:'auto'
在默认状态下,layer是宽高都自适应的,但当你只想定义宽度时,你可以_area: '500px',高度仍然是自适应的。当你宽高都要定义时,你可以_area: ['500px', '300px']
icon - 图标。信息框和加载层的私有参数
类型:Number,默认:-1(信息框)/0(加载层)
信息框默认不显示图标。当你想显示图标时,默认皮肤可以传入_0-6_如果是加载层,可以传入0-2。
btn - 按钮
类型:String/Array,默认:'确认'
信息框模式时,btn默认是一个确认按钮,其它层类型则默认不显示,加载层和tips层则无效。当您只想自定义一个按钮时,你可以btn: '我知道了',当你要定义两个按钮时,你可以btn: ['yes', 'no']。当然,你也可以定义更多按钮,比如:btn: ['按钮1', '按钮2', '按钮3', …],按钮1的回调是yes,而从按钮2开始,则回调为btn2: function(){},以此类推。
btnAlign - 按钮排列
类型:String,默认:r
你可以快捷定义按钮的排列位置,btnAlign的默认值为r,即右对齐。
btnAlign: 'l' ; 按钮左对齐
btnAlign: 'c';按钮居中对齐
btnAlign: 'r';按钮右对齐。默认值,不用设置
closeBtn - 关闭按钮
类型:String/Boolean,默认:1
layer提供了两种风格的关闭按钮,可通过配置1和2来展示,如果不显示,则closeBtn: 0
shade - 遮罩
类型:String/Array/Boolean,默认:0.3
即弹层外区域。默认是0.3透明度的黑色背景('#000')。如果你想定义别的颜色,可以shade: [0.8, '#393D49'];如果你不想显示遮罩,可以_shade: 0
shadeClose - 是否点击遮罩关闭
类型:Boolean,默认:false
如果你的shade是存在的,那么你可以设定shadeClose来控制点击弹层外区域关闭。
time - 自动关闭所需毫秒
类型:Number,默认:0
默认不会自动关闭。当你想自动关闭时,可以time: 5000,即代表5秒后自动关闭,注意单位是毫秒(1秒=1000毫秒)
resize - 是否允许拉伸
类型:Boolean,默认:true
默认情况下,你可以在弹层右下角拖动来拉伸尺寸。如果对指定的弹层屏蔽该功能,设置 false即可。该参数对loading、tips层无效
move - 触发拖动的元素
类型:String/DOM/Boolean,默认:'.layui-layer-title'
默认是触发标题区域拖拽。如果你想单独定义,指向元素的选择器或者DOM即可。如move: '.mine-move'。你还配置设定move: false来禁止拖拽
success - 层弹出后的成功回调方法
类型:Function,默认:null
当你需要在层创建完毕时即执行一些语句,可以通过该回调。success会携带两个参数,分别是当前层DOM 当前层索引。
yes - 确定按钮回调方法
类型:Function,默认:null
该回调携带两个参数,分别为当前层索引、当前层DOM对象。
cancel - 右上角关闭按钮触发的回调
类型:Function,默认:null
该回调携带两个参数,分别为:当前层索引参数(index)、当前层的DOM对象(layero),默认会自动触发关闭。如果不想关闭,return false即可
end - 层销毁后触发的回调
类型:Function,默认:null
无论是确认还是取消,只要层被销毁了,end都会执行,不携带任何参数。
layer.close(index) - 关闭特定层
1. layer.close(index); //此时你只需要把获得的index,轻轻地赋予layer.close即可
2. //如果你想关闭最新弹出的层,直接获取layer.index即可
3. layer.close(layer.index); //它获取的始终是最新弹出的某个层,值是由layer内部动态递增计算的
layer.closeAll(type) - 关闭所有层
如果你很懒,你_不想去获取index_你只想关闭。那么closeAll真的可以帮上你。如果你不指向层类型的话,它会销毁掉当前页所有的layer层。当然,如果你只想关闭某个类型的层,那么你可以
1. layer.closeAll(); //疯狂模式,关闭所有层
2. layer.closeAll('dialog'); //关闭信息框
3. layer.closeAll('page'); //关闭所有页面层
4. layer.closeAll('iframe'); //关闭所有的iframe层
5. layer.closeAll('loading'); //关闭加载层
6. layer.closeAll('tips'); //关闭所有的tips层
好啦,暂时就涉及这么多啦,其他的再用到再继续码吧~!