BootStarp模态框Dailog使用说明
BootStarp模态框Dailog使用说明
BootStrip简介
Bootstrap，来自 Twitter，是目前很受欢迎的前端框架。
Bootstrap 是基于 HTML、CSS、JAVASCRIPT 的，它简洁灵活，使得 Web 开发更加快捷。 它由Twitter的设计师Mark Otto和Jacob Thornton合作开发，是一个CSS/HTML框架。
Bootstrap提供了优雅的HTML和CSS规范，它即是由动态CSS语言Less写成。Bootstrap一经推出后颇受欢迎，一直是GitHub上的热门开源项目，包括NASA的MSNBC（微软全国广播公司）的Breaking News都使用了该项目。 国内一些移动开发者较为熟悉的框架，如WeX5前端开源框架等，也是基于Bootstrap源码进行性能优化而来。
1.1. 帮助文档关键字
boostrap模态框oaoDailog
1.2. 使用场景
当网页上点击某个按钮需要给予用户提示确认，用户点击确认按钮才能继续执行，或者用户点击取消按钮则取消执行操作；
当网页上点击查看，展示的数据需要使用弹出框展示的情况下，可以使用oaoDailog
1.3. 原理图
基于boostrap3.0的modal，jquery1.9
1.4. 使用说明
为什么需要oaoDailog？
a.由于boostrap3.0提供的modal，必须要在页面上先定义一个modal的div隐藏代码，用户将需要展示的内容写到该div中，如果一个页面有多种模态框，则需要写多个隐藏的模态框div隐藏代码，无疑这是多余的。
b.由于默认的modal是没有确认和取消按钮的，当然我们可以写两个button在模态框的隐藏div中，但是我们同时需要写js去监控确认按钮点击后执行的操作，同时确认按钮执行的操作，跟弹出时用户点击的数据有关系，数据如何传递，bootstrap没有给我们提供。
c. oaoDailog1.0.0版本主要就是解决bootstrap的模态框使用不方便，代码冗余的问题。
效果图：
开始使用
1、 引入oaoDailog.js
Code:
<script type="text/javascript" src="${ctx}/static/jquery/jqueryApi/oaoDialog/oao.dialog.js" charset="UTF-8"></script>
2、 调用展示弹出框的代码
Code:
oao.dialog({
title:"删除提示框",
content:"请确认是否真的删除，删除后将无法恢复!",
ok:function(){
oao.dialog.close();
}
});
这就是一个基本也是使用最常见的确认弹出框的使用方法。
1.5. API
oao.dialog()：这个方法是生成弹出框的方法，传入的参数是一个json对象，当然你也可以什么都不传，那样会弹出一个空白的弹出框，这是没有问题的。下面分别介绍每个参数的意思以及默认值。
|
属性名 |
属性类型 |
说明 |
默认值 |
|
title |
String |
弹出框标题 |
提示 |
|
content |
String |
弹出框的主要内容，可以是文本和html代码 |
空 |
|
okVal |
String |
确认按钮的自定义文字 |
确认 |
|
ok |
Function/boolean |
点击确认执行的方法 |
关闭功能 |
|
cancelVal |
String |
取消按钮的自定义文字 |
取消 |
|
cancal |
Function/boolean |
点击取消执行的方法 |
关闭功能 |
•oao.dialog.close():关闭模态框
1.6. 待支持的功能 1.目前弹出框的内容只支持文字和静态html，不支持url请求
2.目前最多只能显示两个按钮，不支持自定义按钮，后续支持
3.目前弹出框的位置和大小不支持自定义
4.目前的弹出框一次只能弹出一个，不支持弹出框中再弹出一个模态框(bootstrap modal底层不支持)
敬请期待，下个版本见。
/*!
* oaoDialog 1.0.0
* author:xufei
* Date: 2015-7-9 1:32
* http://www.oaoera.com
* Copyright © 2014 www.oaoera.com Inc. All Rights Reserved. 沪ICP备13024515号-1 上海义信电子商务有限公司
*
* This is licensed under the GNU LGPL, version 2.1 or later.
* For details, see: http://creativecommons.org/licenses/LGPL/2.1/
*/
//oao命名空间
oao = {};
oao.init = function(settings){
var defaultSettings ={
title : "提示",
content:"",
okVal:"确认",
cancalVal:"取消",
ok:function(){
$("#oaoModal").modal('hide');
},
cancel:function(){
$("#oaoModal").modal('hide');
},
close:false
}
oao.settings = $.extend({}, defaultSettings, settings || {});
return oao.settings;
}
oao.initContent = function(){
var modelHtml =
"<div id=\"oaoModal\" class=\"modal fade delete_modal\" tabindex=\"-1\" role=\"dialog\" aria-labelledby=\"myModalLabel\" aria-hidden=\"true\" >"+
" <div class=\"modal-dialog\">"+
" <div class=\"modal-content\">"+
" <div class=\"modal-header\">"+
" <button type=\"button\" class=\"close\" data-dismiss=\"modal\" aria-label=\"Close\"><span aria-hidden=\"true\">×</span></button>"+
" <h4 class=\"modal-title\"></h4>"+
" </div>"+
" <div class=\"modal-body\" style=\"text-align:center;\">"+
" </div>"+
" <div class=\"modal-footer\">"+
" <button type=\"button\" class=\"btn btn-default modalCancel\"></button>"+
" <button type=\"button\" class=\"btn btn-primary modalOK\"></button>"+
" </div>"+
" </div>"+
" </div>"+
" </div>";
var $modelHtml = $(modelHtml);
$(".modalOK",$modelHtml).text(oao.settings.okVal);
$(".modalCancel",$modelHtml).text(oao.settings.cancalVal);
$(".modal-title",$modelHtml).text(oao.settings.title);
$(".modal-body",$modelHtml).html(oao.settings.content);
if(!oao.settings.ok){
$(".modalOK",$modelHtml).remove();
}
if(!oao.settings.cancel){
$(".modalCancel",$modelHtml).remove();
}
$("body").append($modelHtml);
}
//弹出对话框的方法
oao.dialog = function(settings){
settings = oao.init(settings);
oao.initContent();
//关闭的时候调用方法
$('#oaoModal').on('hidden.bs.modal', function (e) {
if(oao.settings.close){
oao.settings.close();
}
$("#oaoModal").remove();
})
if(oao.settings.ok){
$("#oaoModal .modalOK").click(settings.ok);
}
if(oao.settings.cancel){
$("#oaoModal .modalCancel").click(settings.cancel);
}
$("#oaoModal").modal('show')
.css({
"margin-top": function () {
return ($(this).height() / 2-200);
}
});;
}
//关闭对话框的方法
oao.dialog.close = function(){
$("#oaoModal").modal('hide');
}