萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

jQuery UI Dialog 封裝實現:Alert/Confirm/Error/Warning 統一調用

基於 jQuery UI Dialog 封裝統一彈窗組件,支持 Alert(提示)、Confirm(確認)、Error(錯誤)、Warning(警告)四種類型,圖標區分、回調函數、模態顯示、自動清理重複實例。本文提供完整封裝代碼、調用示例、擴展建議。

核心封裝代碼


var Dialog = (function() {
    var ICONS = {
        alert:   'tipmsg_icoInfo',
        confirm: 'tipmsg_icoConfirm',
        error:   'tipmsg_icoError',
        warning: 'tipmsg_icoWarning'
    };

    function buildHtml(type, msg) {
        var icon = ICONS[type] || ICONS.alert;
        return "<div id='" + type + "Div' style='display:none'>" +
               "<p><span class='" + icon + "' style='float:left;margin:0 7px 50px 0;width:35px;height:35px'></span>" +
               msg + "</p></div>";
    }

    function openDialog(type, title, msg, buttons) {
        var selector = '#' + type + 'Div';
        $(selector).remove();                 // 清理舊實例
        $('body').append(buildHtml(type, msg)); // 插入新 DOM
        $(selector).dialog({
            modal: true,
            title: title,
            buttons: buttons,
            close: function() { $(this).dialog('destroy').remove(); } // 關閉銷毀
        });
    }

    return {
        alert: function(msg, okCb) {
            openDialog('alert', '提示', msg, {
                '確定': function() { if (okCb) okCb(); $(this).dialog('close'); }
            });
        },
        confirm: function(msg, okCb, cancelCb) {
            openDialog('confirm', '確認', msg, {
                '確定': function() { if (okCb) okCb(); $(this).dialog('close'); },
                '取消': function() { if (cancelCb) cancelCb(); $(this).dialog('close'); }
            });
        },
        error: function(msg, okCb) {
            openDialog('error', '錯誤', msg, {
                '確定': function() { if (okCb) okCb(); $(this).dialog('close'); }
            });
        },
        warning: function(msg, okCb) {
            openDialog('warning', '警告', msg, {
                '確定': function() { if (okCb) okCb(); $(this).dialog('close'); }
            });
        }
    };
})();

CSS 圖標類定義(需自行準備圖片或用 FontAwesome)


.tipmsg_icoInfo    { background: url(info.png) no-repeat center; }
.tipmsg_icoConfirm { background: url(question.png) no-repeat center; }
.tipmsg_icoError   { background: url(error.png) no-repeat center; }
.tipmsg_icoWarning { background: url(warning.png) no-repeat center; }
/* 或用 FontAwesome */
.tipmsg_icoInfo::before    { content: '\f05a'; font-family: FontAwesome; }
.tipmsg_icoConfirm::before { content: '\f128'; font-family: FontAwesome; }
.tipmsg_icoError::before   { content: '\f06a'; font-family: FontAwesome; }
.tipmsg_icoWarning::before { content: '\f071'; font-family: FontAwesome; }

調用示例


// 簡單提示
Dialog.alert('操作成功!');

// 帶回調確認
Dialog.confirm('確定刪除?', 
    function() { ajaxDelete(id); }, 
    function() { console.log('用戶取消'); }
);

// 錯誤提示
Dialog.error('網絡請求失敗,請重試。', function() { location.reload(); });

// 警告
Dialog.warning('數據未保存,離開將丟失。');

進階擴展建議

  1. Promise 化:返回 `Promise` 支持 `await Dialog.confirm(...)`
  2. 選項參數化:`Dialog.open({type, title, msg, buttons, width, height, ...})`
  3. 鍵盤支持:Enter 觸發確定,Esc 觸發取消/關閉
  4. 拖拽/調整大小:`draggable: true, resizable: true`
  5. 內容模板:支持 HTML 字符串、DOM 元素、AJAX 載入 URL
  6. 堆疊管理:多層彈窗 z-index 正確遞增
  7. 無障礙 (a11y):`role="dialog"`, `aria-modal="true"`, `aria-labelledby`

現代替代方案

  • SweetAlert2:零依賴、動畫豐富、Promise API、主題化、RTL、無障礙
  • Bootstrap Modal:若項目已用 Bootstrap,原生組件足夠
  • Element Plus / Ant Design Vue / MUI:組件庫內置 Dialog,風格統一
  • 原生 `` 元素:HTML5.2 標準,輕量無依賴,Polyfill 支持舊瀏覽器

總結

封裝統一 Dialog API 能大幅減少項目中重複的彈窗代碼,提升一致性與可維護性。核心要點:單例模式管理 DOM、圖標語義化、回調解耦、關閉時銷毀防洩漏。新項目推薦直接接入成熟組件庫或原生 `

`,避免維護 jQuery UI 依賴。

copyright © 萬盛學電腦網 all rights reserved