DIV CSS 佈局教程網

封裝 Bootstrap 模態對話框:mzDialog 插件設計筆記
編輯:關於JavaScript     

用 Bootstrap 模態對話框時,每個要彈的視窗都得在頁面裡先寫一段 HTML。若一個頁面有十幾處需要彈窗,就得寫十幾份幾乎一樣的結構,維護起來相當煩人。個人不太適應這種寫法,於是做了一層簡單封裝與擴充,加上自訂標題、寬高,並依寬高自動水平垂直居中。

可設定屬性

 id: "modal",      // 彈窗 id
title: "dialog",   // 彈窗標題
width: "600",      // 彈窗寬度,暫不支援百分比
height: "500",     // 彈窗高度,不支援百分比
backdrop: true,    // 是否顯示遮罩,與原生 Bootstrap 模態框一致
keyboard: true,    // 是否啟用 Esc 鍵關閉,與原生一致
remote: "",        // 載入遠端 URL,與原生一致
openEvent: null,   // 彈窗打開後的回呼函式
closeEvent: null,  // 彈窗關閉後的回呼函式
okEvent: null      // 點擊確定按鈕的回呼函式

使用方式

方式一:透過 HTML data-* 屬性宣告

 <a class="mzDialog" href="#"
   data-remote="test.html"
   data-mtitle="modal1"
   data-id="m1"
   data-width="600"
   data-okEvent="ok()">彈窗 demo</a>

方式二:以 JS 初始化

 $(".mzDialog").mzDialog();

插件主體

 /* ------------------------------------------------------
 * 封裝的 dialog 插件,基於 bootstrap 模態視窗的簡單擴充
 * ------------------------------------------------------ */
(function ($) {
  var defaults = {
    id: "modal",
    title: "dialog",
    width: "600",
    height: "500",
    backdrop: true,
    keyboard: true,
    remote: "",
    openEvent: null,
    closeEvent: null,
    okEvent: null
  };

  function mzDialog(element, options) {
    this.$element = $(element);
    this.options = $.extend({}, defaults, this.$element.data(), options);
    this.init();
  }

  mzDialog.prototype = {
    init: function () {
      var opt = this.options;

      // 若頁面上還沒有對應的模態框,就動態組一份骨架出來
      if ($("#" + opt.id).length === 0) {
        var html = ''
          + '<div class="modal fade" id="' + opt.id + '" tabindex="-1" role="dialog">'
          + '  <div class="modal-dialog" style="width:' + opt.width + 'px;">'
          + '    <div class="modal-content">'
          + '      <div class="modal-header">'
          + '        <button type="button" class="close" data-dismiss="modal">×</button>'
          + '        <h4 class="modal-title">' + opt.title + '</h4>'
          + '      </div>'
          + '      <div class="modal-body"></div>'
          + '      <div class="modal-footer">'
          + '        <button type="button" class="btn btn-default" data-dismiss="modal">取消</button>'
          + '        <button type="button" class="btn btn-primary btn-ok">確定</button>'
          + '      </div>'
          + '    </div>'
          + '  </div>'
          + '</div>';
        $("body").append(html);
      }

      this.$modal = $("#" + opt.id);
      this.bind();
    },

    bind: function () {
      var that = this;
      this.$modal.on('show.bs.modal', function () {
        // 依視窗尺寸計算居中偏移
        var $dialog = $(this).find('.modal-dialog');
        $dialog.css({
          'margin-top': ($(window).height() - $dialog.outerHeight()) / 2
        });
        if ($.isFunction(that.options.openEvent)) {
          that.options.openEvent.call(that);
        }
      });
      this.$modal.on('hide.bs.modal', function () {
        if ($.isFunction(that.options.closeEvent)) {
          that.options.closeEvent.call(that);
        }
      });
      this.$modal.find('.btn-ok').on('click', function () {
        if ($.isFunction(that.options.okEvent)) {
          that.options.okEvent.call(that);
        }
      });
    },

    open: function () {
      if (this.options.remote) {
        this.$modal.find('.modal-body').load(this.options.remote);
      }
      this.$modal.modal({
        backdrop: this.options.backdrop,
        keyboard: this.options.keyboard
      });
    }
  };

  $.fn.mzDialog = function (option) {
    return this.each(function () {
      var $this = $(this),
          data = $this.data('mzDialog');
      if (!data) {
        $this.data('mzDialog', (data = new mzDialog(this, option)));
      }
      if (typeof option === 'string') {
        data[option]();
      }
    });
  };

  $.fn.mzDialog.Constructor = mzDialog;
})(window.jQuery);

目前還待改進的地方

  1. 彈窗只有「取消」與「確定」兩個按鈕,尚不支援自訂按鈕,需要可自行改原始碼擴充;
  2. 回呼函式目前必須以字串形式傳入,例如 okEvent: "ok()",其中的 ok 是你自己定義的函式,且務必帶上括號;上面範例已改為直接傳函式參照,更直觀也更好除錯;
  3. 寬高建議使用像素而非百分比,因為居中計算依賴 outerHeight/outerWidth 的實際數值;
  4. 更進一步的話,可以加上 $.fn.mzDialog.defaults 讓全域預設值可集中調整,並在關閉後從 DOM 中移除節點,避免多次開關累積事件綁定。

以上僅供參考,歡迎自行修改補齊。

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