移动端dialog组件

移动端dialog组件

dialogView是知足移动端下，用户自定义的dialog组件，API可扩展性强，使用便捷。现版本是基于jquery库编写的，在使用以前须要引入jquery库或者Zepto库，后续将会和其余组件整合成一个轻量级UI组件库中。

 

引用

页面引入dialog.min.js和dialog.min.css便可。

 

使用讲解

组件提供了一个全局dialogView接口，和一个open()主函数，使用的时候只须要dialogView.open()就能够了。

dialogView提供了经常使用的几种移动端dialog类型：alert，confirm，msg，footConfirm，footMsg。对前3种经常使用类型的dailog弹窗，暴露出了3个函数，便于使用，如dialogView.alert()，dialogView.confirm()和dialogView.msg()，三个函数拥有默认的类型值，因此使用这三个函数时不须要传入type值，固然也能够这样使用：dialogView.open({type:"alert"})，dialogView.open({type:"confirm"})，dialogView.open({type:"msg"})。

dialogView支持链式调用，如：dialogView.alert({message: "alert默认信息框"}).open({type:"footMsg",message: "我是提示类型框"})。

而且还暴露出了一个close()函数，用于关闭弹窗，使用以下：dialogView.close()，close()函数只支持传入一个参数，即须要关闭的弹窗的DOM元素，不传参时，将会默认关闭页面上全部的弹窗。

 

参数

message: 弹窗区域内容，参数类型能够是String类型，也能够是DOM对象。

type: 弹窗类型，参数类型为String类型，提供了5种默认的类型：alert，confirm，msg，footConfirm，footMsg，弹窗类型值可供用户自行扩展。

showTime: 弹窗显示时长，参数类型为Number类型。

className: 自定义class名，参数类型为String类型，会在弹窗的最外层元素上扩展class，通常用于特殊状况下使用。

skin: 弹窗区域自定义皮肤，参数类型为String类型，用于扩展弹窗区域的样式，其值会被扩充为弹框的class，好比你想给弹窗换掉默认背景色，换成本身定义的颜色，就能够先在样式文件中定义好一个class样式，而后skin值为定义的class值就能够了，用法以下：

1 dialogView.open({
2     type: "msg",
3     message: "我是提示类型框",
4     shade: false,
5     skin: "dialog-msg" //自定义的皮肤样式
6 })

项目的css文件下定义dialog-msg样式：

.mobile-dialogView .dialogView-m-main .dialog-msg{background-color:blue;}

效果以下：

 

styles: 弹窗区域添加自定义css样式,与skin值得做用一致，不一样的是skin参数值的自定义css样式是定义在样式文件中的，而styles值则是直接扩展到行内样式中，如：

1 dialogView.open({
2     type: "footmsg",
3     animate: "up",
4     message: $("#info").show() || document.getElementById("info"),
5     styles: "position: fixed;height: 100%;width: 100%;padding: 0;bottom: 0px;opacity: 1;", //自定义css样式，将直接扩展为行内样式
6     showTime: 3000
7 })

shade: 是否须要遮罩层，参数类型为Boolean值。

shadeClose: 点击弹窗之外的区域是否关闭弹窗，参数类型为Boolean值。

closeable: 点击button按钮是否关闭弹窗，参数类型为Boolean值，默认值是true，若有特殊状况点击按钮不须要关闭弹窗，将改值设置为false就可。

animate: 弹窗动画效果，定义了两种弹窗动画效果，值为“open”和"up"，第一种弹窗显示效果"open"，其对应的关闭效果是"close"，另外一种弹窗显示效果"up"，其对应的关闭效果是"down"，默认动画效果为“open”。

buttons: 弹窗按钮组，参数类型为Array值，当dialog类型是alert时，有且只容许添加一个按钮，当dailog类型值是confirm或者footConfirm时，有且只容许添加两个按钮，当dailog类型值是msg或者footMsg时，不会添加任何按钮，其余dailog类型，用户写了多少按钮，就往按钮组添加多少按钮。
按钮的参数类型为Object键值对类型，有如下几种参数：

• text: 按钮文字，参数类型能够是String类型
• skin: 自定义按钮皮肤，使用如上面所述
• callback: 回调函数，点击按钮时触发
• closeable：参数类型为Boolean值，用于断定按钮点击以后是否关闭弹窗，默认值为true。

使用以下：

dialogView.confirm({
    message: "要前往个人github吗？",
    buttons: [{
        skin: "yes",
        text: "能够",
        callback: function(){
            window.location.href="https://github.com/webproblem";
        }
    },{
        skin: "no",
        text: "不要"
    }]
})

注： 在弹窗里的DOM元素上添加closeable=true属性，点击该DOM元素时会触发事件关闭弹窗，好比在自定义的标题上添加一个关闭按钮图标，使其点击时触发关闭事件，能够这样使用：

dialogView.open({
    title: {
        content: "<span>我是自定义标题</span><i class='demo-title-close' closeable=true></i>"
    },
    message: "自定义风格标题,第一个参数为标题内容,第二个参数为自定义的样式,<br>关闭按钮是自定义加上去的哦！"
})

title: 自定义标题区域，参数类型为Object键值对类型，有三个参数，一个参数是content，对应的值为自定义标题内容，参数类型能够是String类型，也能够是DOM对象。另两个参数是styles和skin，都是为自定义标题添加的样式，两个参数的区别如上面所述的同样。用法以下：

dialogView.open({
    title: {
        content: "<span>我是自定义标题</span>"
    }
})

 

完整代码及示例见个人github，github地址: https://github.com/webproblem/hello-world/tree/master/dialogDemo
Demo示例效果预览地址: https://webproblem.github.io/hello-world/dialogDemo/dialog.html若是喜欢，请记得Star哈！若有不对之处，欢迎及时指出！