DIV CSS 佈局教程網

jQuery 彈出框組件 jDialog 的使用說明
編輯:JavaScript綜合知識     

瀏覽器原生的 alert 和 confirm 樣式醜、無法定制,還會阻塞線程。jDialog 是一個國產的輕量彈出框插件,API 設計簡潔、兼容性不錯,覆蓋了常見的幾類對話場景。

支持的彈出框模式

  • alert:普通提示(警告)對話框
  • confirm:詢問(確認)對話框
  • message:簡單消息提示,無標題、無按鈕
  • iframe:在對話框中嵌入一個 iframe
  • tip:帶小三角指向的氣泡提示
  • dialog:最基礎的自定義對話框

源碼解析

var jDialogId = [];

(function ($) {
  $.jDialog = function (options) {

    // 生成不重複的隨機 ID,作為多彈窗並存的標識
    var id = parseInt(Math.floor(Math.random() * 1000 + 1));
    while ($.inArray(id, jDialogId) != -1) {
      id = parseInt(Math.floor(Math.random() * 1000 + 1));
    }
    jDialogId.push(id);

    var defaults = {
      title: "",
      content: "這是一個 JasUI-Dialog 插件",
      width: 350,
      height: 0,
      timer: 0,               // 大於 0 時自動關閉
      showbuttons: false,
      buttons: [],
      okval: "確認",
      ok: function () { return false; },
      cancelval: "取消",
      cancel: function () { return false; },
      showclose: true,
      close: function () { },
      theme: ""
    };

    var options = $.extend(defaults, options);

    // 拼接彈窗 HTML
    var _objdiv = "<div id='j-dialog-" + id + "' class='j-dialog ";
    if (options.theme != "") {
      _objdiv = _objdiv + "j-dialog-" + options.theme + "'>";
    } else {
      _objdiv = _objdiv + "'>";
    }

    _objdiv += "<div class='j-dialog-header'>";
    if (options.showclose) {
      _objdiv += "<a href='javascript:void(0)' class='j-close j-dialog-close'></a>";
    }
    if (options.title != "") {
      _objdiv += "<h5 class='j-dialog-title'>" + options.title + "</h5>";
    }
    _objdiv += "</div>";
    _objdiv += "<p class='j-dialog-content'>" + options.content + "</p>";

    if (options.showbuttons) {
      _objdiv += "<div class='j-dialog-footer'>";
      $.each(options.buttons, function (i, value) {
        _objdiv += "<a class='j-button' data-id='" + i + "'>" + value.title + "</a>";
      });
      _objdiv += "<a class='j-button j-button-primary j-dialog-ok'>" + options.okval + "</a>";
      _objdiv += "<a class='j-button j-dialog-cancel'>" + options.cancelval + "</a>";
      _objdiv += "</div>";
    }

    _objdiv += "</div>";
    $("body").append(_objdiv);

    // 居中定位:用負的 margin 抵消一半尺寸
    var _obj = $('#j-dialog-' + id);
    if (options.height > 0) { _obj.css("height", options.height); }
    _obj.css("width", options.width);
    _obj.css("margin-top", '-' + (options.height / 2) + 'px');
    _obj.css("margin-left", '-' + (options.width / 2) + 'px');
    _obj.animate({ top: '30%', opacity: 1 }, 0);

    // 綁定關閉、確認、取消事件
    if (options.showclose) {
      _obj.find('.j-dialog-close').on('click', function () {
        $.jDialogRemove(id, options.close);
      });
      _obj.find('.j-dialog-ok').on('click', function () {
        if (!options.ok()) { $.jDialogRemove(id, options.close); }
      });
      _obj.find('.j-dialog-cancel').on('click', function () {
        if (!options.cancel()) { $.jDialogRemove(id, options.close); }
      });
    }

    // 自定義按鈕
    if (options.showbuttons) {
      $.each(options.buttons, function (i, value) {
        _obj.find("[data-id=" + i + "]").on('click', function () {
          if (!value.callback()) { $.jDialogRemove(id, options.close); }
        });
      });
    }

    // 定時自動關閉
    if (options.timer > 0) {
      setTimeout(function () { $.jDialogRemove(id, options.close); }, options.timer);
    }

    return id;
  };

  // 移除彈窗,帶淡出動畫
  $.jDialogRemove = function (id, callback) {
    if ($.inArray(id, jDialogId) != -1) {
      jDialogId.splice($.inArray(id, jDialogId), 1);
      $('#j-dialog-' + id).animate({ top: '0', opacity: 0 }, 500, function () {
        $('#j-dialog-' + id).remove();
        if (callback) { callback(); }
      });
    }
  };

  // 氣泡提示
  $.jTip = function (options) {
    var defaults = {
      content: "這是一個 JasUI-Dialog 插件",
      width: 200,
      timer: 0,
      showclose: false,
      close: function () { },
      theme: ""
    };
    var options = $.extend(defaults, options);
    $.jDialog(options);
  };

  // 浮動文字動畫
  $.jFloatText = function (txt, color, posX, posY) {
    var $i = $("<b>").text(txt);
    var x = posX || '50%',
        y = posY || '40%';

    $i.css({ top: 200, left: x, position: "absolute", color: color || "#E94F06" });
    $("body").append($i);
    $i.animate({ top: 20, opacity: 0 }, 1500, function () { $i.remove(); });
  };

})(jQuery);

設計上值得學習的幾點

回調返回值的約定。ok 與 cancel 返回真表示「阻止關閉」,返回假才關閉。這樣把「校驗未通過則保持彈窗」的邏輯交給業務決定,約定簡潔。

用 ID 數組管理多實例。每個彈窗分配唯一 ID,移除時從數組中摘除,避免多個彈窗同時存在時互相干擾。

居中用負 margin 而非 transform。這是舊時代的兼容做法,現代項目用 flex 布局或 transform: translate(-50%, -50%) 會乾淨很多。

需要提醒的是,把 options.content 直接拼進 HTML 字符串存在 XSS 風險,若內容來源於用戶輸入,應先做轉義處理。

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