瀏覽器原生的 alert 和 confirm 樣式醜、無法定制,還會阻塞線程。jDialog 是一個國產的輕量彈出框插件,API 設計簡潔、兼容性不錯,覆蓋了常見的幾類對話場景。
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 風險,若內容來源於用戶輸入,應先做轉義處理。