Custombox是一款带CSS3过渡效果的js模态窗口插件。该插件使用原生js制作,但它也可以和jQuery完美结合,作为jQuery插件来使用。插件中带有20中不同CSS3过渡效果的模态窗口,除了传统的淡入淡出、翻转、旋转等效果,该插件还增加了开门、推拉、角部放大的那个六种效果。

该js模态窗口插件可以工作在 IE 8-11, Firefox, Chrome, Safari 和 Opera等浏览器上。

使用方法

首先要在页面中引入custombox.min.js 和 custombox.min.css文件,为了兼容老的浏览器,还要引入 legacy.js 文件。

<link rel="stylesheet" href="custombox.min.css">
<script src="custombox.min.js"></script>
<script src="legacy.min.js"></script>
                
使用原生js调用

该模态窗口插件可以使用纯js来调用。

<script>
    document.addEventListener('DOMContentLoaded', function () {
        document.getElementById('element').addEventListener('click', function ( e ) {
            Custombox.open({
                target: '#modal',
                effect: 'fadein'
            });
            e.preventDefault();
        });
    });
</script>
                
作为jQuery插件调用

该模态窗口插件也可以作为jQuery插件来调用。

<script>
    $(function () {
        $('#element').on('click', function ( e ) {
            Custombox.open({
                target: '#modal',
                effect: 'fadein'
            });
            e.preventDefault();
        });
    });
</script>
                

配置参数

参数名 类型 参数值 描述
target string null 设置URL, ID 或 Class。
id string | number null 设置模态窗口的id。
cache boolean false 如果设置为false,当发送AJAX请求时它会强制请求页面不被浏览器缓存。
escKey boolean true 是否运算用户使用ESC键退出模态窗口。
zIndex string | number auto 覆盖 z-index: Auto 或 number。
overlay boolean true 是否显示遮罩层。
overlayColor string #000 遮罩层的颜色。
overlayOpacity number 0.8 遮罩层的透明度。范围: 0 to 1。
overlayClose boolean true 是飞运行用户点击遮罩层关闭模态窗口。
overlaySpeed number 300 设置遮罩层的速度。单位:毫秒。
overlayEffect string auto 结合任何遮罩层效果。
width number | null null 设置一个固定的总宽度。
effect string fadein fadein | slide | newspaper | fall | sidefall | blur | flip | sign | superscaled | slit | rotate | letmein | makeway | slip | corner | slidetogether | scale | door | push | contentscale.
position string center, center 设置模态窗口的位置。 First position 'x': left, center and right. Second position 'y': top, center, bottom.
animation string | null null Only with effects: slide or rotate (top, right, bottom, left and center) and flip (vertical or horizontal). Output position separated by commas.
speed number 600 设置过渡效果的速度,单位:毫秒。

事件

事件类型 描述
open Callback that fires right before begins to open.
complete Callback that fires right after loaded content is displayed.
close Callback that fires once is closed.

方法

方法名称 方法类型 Property 描述
open - - 打开模态窗口。
close string | number last 关闭模态窗口
custombox.open - - 调用打开模态窗口的方法。
custombox.complete - - 调用完成模态窗口的方法。
custombox.close - - 调用关闭模态窗口的方法。

小技巧

- 可以无限连续打开模态窗口,查看DEMO中的示例: example.