Bootstrap 簡介
Bootstrap 來自 Twitter,由設計師 Mark Otto 與 Jacob Thornton 合作開發,是一套以 HTML、CSS 為核心、並以動態 CSS 語言 Less 撰寫的前端框架。它提供的不只是樣式,更是一整套優雅的 HTML 與 CSS 規範。自推出以來一直是 GitHub 上的熱門開源專案,就連 NASA 與 MSNBC 的 Breaking News 也曾採用;國內如 WeX5 等前端框架,同樣是在 Bootstrap 原始碼上做效能優化而來。
1.1 關鍵字
bootstrap 模態框、oaoDailog
1.2 適用場景
· 點擊某個按鈕需要向使用者確認,按下確認才繼續,按下取消則中止;
· 點擊「查看」時,需要用彈出層承載要展示的內容。
1.3 技術基礎
基於 Bootstrap 3.0 的 modal 與 jQuery 1.9。
1.4 為什麼要再封裝一層
a. Bootstrap 3.0 原生的 modal,必須先在頁面裡預埋一段隱藏的 modal div,並把要顯示的內容寫死在其中。若一個頁面有多種彈窗,就得寫多份隱藏 div,顯然是冗餘的。
b. 原生 modal 沒有內建的確認/取消按鈕。就算自己補上兩個 button,還得額外寫 JS 去監聽點擊;更麻煩的是,確認後要做的事往往取決於使用者當初點的是哪一筆資料,而「如何把這筆資料傳進彈窗」Bootstrap 並沒有給出方案。
c. oaoDialog 1.0.0 正是為了解掉這兩個痛點:使用不便與程式碼冗餘。
效果圖:

開始使用
1、引入 oaoDialog.js:
<script type="text/javascript" src="${ctx}/static/jquery/jqueryApi/oaoDialog/oao.dialog.js" charset="UTF-8"></script>
2、呼叫彈出框:
oao.dialog({
title: "刪除提示框",
content: "請確認是否真的刪除,刪除後將無法恢復!",
ok: function () {
oao.dialog.close();
}
});
這就是最常見的確認型彈窗寫法:標題、內容、確認時要做的事,一次說完,不必再預埋任何 HTML。
1.5 API
oao.dialog() 是產生彈出框的方法,參數為一個 JSON 物件;即使什麼都不傳也不會報錯,只是會得到一個空白彈窗。各參數說明與預設值如下:
· title(String):彈窗標題,預設「提示」。
· content(String):彈窗主要內容,可為文字或 HTML 程式碼,預設空。
· okVal(String):確認按鈕的自訂文字,預設「確認」。
· ok(Function/boolean):點擊確認要執行的方法,預設為關閉功能。
· cancelVal(String):取消按鈕的自訂文字,預設「取消」。
· cancel(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
* https://www.oaoera.com
* Copyright (c) 2014 www.oaoera.com Inc. All Rights Reserved.
* This is licensed under the GNU LGPL, version 2.1 or later.
*/
// 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');
};
整體設計思路很清楚:用 $.extend 合併預設值與傳入設定,按需動態組出 modal 的 DOM 並插入 body,掛上 hidden.bs.modal 事件在關閉後移除節點(避免 DOM 越堆越多),最後用 margin-top 微調垂直位置。這套「即時產生、用完即丟」的模式,比預埋隱藏 div 靈活得多。