DIV CSS 佈局教程網

基於 Bootstrap 的 oaoDialog 對話框元件封裝
編輯:關於JavaScript     

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 靈活得多。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved