Skip to content

xiaomingming/easyDialog

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

jquery弹层插件

这是一个基于jquery 1.8.2版本的弹层插件,目前支持的功能包括:

  • 宽高自适应(包括插入图片,异步插入内容)
  • 自定义浮层位置,默认居中
  • 支持异步回调
  • 支持浮层信息DOM片段定义
  • 遮罩显示/隐藏
  • 浮层底部显示/隐藏
  • 浮层固定,不随页面动
  • 浮层层叠值设置
  • 浮层自动关闭

兼容性

IE6+,其它高级浏览器。

使用文档

html

<div id="easy-dialog" class="easy-dialog"></div>

javascript 调用

请先引入jquery 1.8.2版本库脚本,然后基本调用如下:

$('#easy-dialog').easyDialog({
    height: 80,
    title: '测试标题',
    tmp: '<p>啦啦啦,这是一个浮层测试</p>' , 
    closeTxt: 'close',
    OK: function() {
        return true;
    }
});

参数说明

1.设置浮层内容区域宽度,高度,不包括浮层头部和底部操作区域。

$('#easy-dialog').easyDialog({
    height: 80,//高度
    width: 200//宽度
});

2.设置关闭文本内容

$('#easy-dialog').easyDialog({
    closeTxt: 'close'//设置为'close'
});

3.设置浮层信息DOM结构

字符串格式定义:

$('#easy-dialog').easyDialog({
    tmp: '<p>啦啦啦,这是一个浮层测试</p>' 
});

函数方式定义:

$('#easy-dialog').easyDialog({
    tmp: function(){
        return '<p>啦啦啦,这是一个浮层测试</p>' 
    }
});

4.设置浮层位置(插件实现:IE6为position:absolute的居中效果,其它支持fixed属性的浏览器使用position:fixed

在不设置的情况下,默认在页面中心位置。但如果设置的话,依据css定位,只允许如下几种设置:

  • left,top
  • left,bottom
  • right,top
  • right,bottom
  • 水平或者垂直方向的居中,请使用'center'
$('#easy-dialog').easyDialog({
    pLeft:'center',//水平x轴居中
    pTop:'center'//竖直Y轴居中
});
$('#easy-dialog').easyDialog({
    pLeft:'100px',//left:100px
    pTop:'50px'//top:50px
});
$('#easy-dialog').easyDialog({
    pRight:'0',//right:0
    pBottom:'0'//bottom:0
});
$('#easy-dialog').easyDialog({
    pLeft:'center',//left:50%;
    pBottom:'0'//bottom:0
});

5.确定按钮事件

默认点击确定,不关闭浮层。需要手动设置。

$('#easy-dialog').easyDialog({
    OK:function(){
        return true;//默认设置为“return false”
    }
});

弹层关闭后执行回调

$('#easy-dialog').easyDialog({
    OK:function(){
        //callback is here;
        return true;
    }
});

6.是否生成遮罩层

$('#easy-dialog').easyDialog({
    isShowFilter:false //不生成遮罩层
});

7.是否显示浮层底部

$('#easy-dialog').easyDialog({
    isShowFooter:false //不显示
});

8.是否显示前景图片

浮层需要等待前景图片下载完成后才能正确获取高度,大多数浮层不会用来展示图片。 若有此需求,请设置该参数为true

$('#easy-dialog').easyDialog({
    isShowImage:false //不显示
});

9.浮层层叠值设置

本来这种事情可以在css中去做,目前先提供这样的接口。

赞成使用很小的层叠值(不超过12),正常页面的层叠值不会有多高,而不是9999这样的脑残设置。

$('#easy-dialog').easyDialog({
    zIndex:11 //默认值为11
});

10.内容模板操作

常见的需求是,设置了浮层的内容,然后还要对内容区进行各种操作。目前这里提供了针对内容区的DOM接口以供操作。

$('#easy-dialog').easyDialog({
    tmp: function(cont){
        var tpl=['<div class="test">test</div>'].join('');
        $(cont).html(tpl);
        $(cont).find('.test').fadeIn();
        return cont;
    }
});

11.异步回调支持

异步回调包括 定时器,ajax操作。支持在内容层的异步操作。提供参数为内容层的jquery DOM 对象。 暴露了tmp函数的参数cont为浮层内容的jquery对象。

$('#easy-dialog').easyDialog({
    tmp: function(cont){
        return $.get('/').done(function(res){
            $(cont).html('<p>异步回调哦</p>');
        }).fail(function(res){
            $(cont).html('<p>异步回调失败咯</p>');
        });
    }
});

12.异步自适应

异步自适应高度,需要手动触发updateHeight函数。

$('#easy-dialog').easyDialog({
    tmp: function(cont){
        var _this=this;
        $(cont).html('<p>先等待3秒哦</p>');
        return setTimeout(function(){
            $(cont).html('<div><p>异步回调,我要填充,使劲儿填充,充满你的身体。</p><p>异步回调,我要填充,使劲儿填充,充满你的身体。</p><p>异步回调,我要填充,使劲儿填充,充满你的身体。</p></div>');
            _this.updateHeight();
        },3*1000);
    }
});

13.浮层自动关闭

自动关闭有显示的时间限制,以及对应的回调函数,目前采用了渐隐效果。

$('#easy-dialog').easyDialog({
    height: 300,
    tit:'浮层',
    isShowHeader:false,
    isShowFooter:false,
    isFade:true,//开启自动关闭
    fadeDelay:3000,//动画持续时间
    fadeCallback:function(){
        // 自动关闭后的回调
        // console.log('要关闭了!!!');
        // location.reload(true);
    },
    isDestroy:true,
    tmp: function() {
        return '<p>'+this.fadeDelay/1000+'秒后就消失了</p>'
    }
});

About

一个简单的jquery弹层插件

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages