萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery UI Dialog 樣式深度定製:標題欄、遮罩、圖標、主題覆蓋完整指南

jQuery UI Dialog 樣式由 ThemeRoller 生成的 CSS 控制,核心類名穩定。本文詳細拆解標題欄、內容區、按鈕區、關閉圖標、遮罩層等關鍵選擇器,提供覆蓋 CSS 範例,助你快速實現品牌化定製。

核心 DOM 結構與類名

<div class="ui-dialog ui-widget ui-widget-content ui-corner-all ui-front">
  <div class="ui-dialog-titlebar ui-widget-header ui-corner-all ui-helper-clearfix">
    <span id="ui-dialog-title-xxx" class="ui-dialog-title">標題</span>
    <button class="ui-button ui-widget ui-state-default ui-corner-all ui-button-icon-only ui-dialog-titlebar-close">
      <span class="ui-button-icon-primary ui-icon ui-icon-closethick"></span>
      <span class="ui-button-text">close</span>
    </button>
  </div>
  <div class="ui-dialog-content ui-widget-content">內容</div>
  <div class="ui-dialog-buttonpane ui-widget-content ui-helper-clearfix">
    <div class="ui-dialog-buttonset"><button class="ui-button...">確定</button></div>
  </div>
</div>
<div class="ui-widget-overlay ui-front"></div> <!-- 模態遮罩 -->

關鍵選擇器與覆蓋示例

1. 標題欄

.ui-dialog .ui-dialog-titlebar {
    background: #2c3e50;          // 背景色
    border: none;
    border-radius: 4px 4px 0 0;   // 頂部圓角
}
.ui-dialog .ui-dialog-title {
    color: #ecf0f1;
    font: 600 14px/1.5 "Microsoft YaHei", sans-serif;
    float: none; display: block;  // 取消浮動,居中
    text-align: center;
    margin: 0; padding: 12px 0;
}

2. 關閉按鈕圖標

.ui-dialog .ui-dialog-titlebar-close {
    right: 12px; top: 50%; transform: translateY(-50%);
    background: transparent; border: none;
}
.ui-dialog .ui-icon-closethick {
    background-image: url('custom-close.svg'); // 自定義 SVG
    width: 20px; height: 20px;
}

3. 內容區

.ui-dialog .ui-dialog-content {
    padding: 20px;
    font-size: 14px;
    line-height: 1.6;
    overflow: auto; // 內容過長滾動
}

4. 按鈕區

.ui-dialog .ui-dialog-buttonpane {
    border-top: 1px solid #ddd;
    padding: 12px 20px;
    text-align: right;
}
.ui-dialog .ui-button {
    margin-left: 8px;
    padding: 6px 16px;
    border-radius: 4px;
    font-size: 13px;
}
.ui-dialog .ui-button:first-child { margin-left: 0; }

5. 模態遮罩層

.ui-widget-overlay {
    background: rgba(0, 0, 0, 0.5); // 半透明黑
    opacity: 1; // 覆蓋 jQuery UI 內部 opacity 動畫
    z-index: 1000; // 確保在 dialog 之下
}

6. 圖標體系(.ui-icon)

jQuery UI 使用 CSS Sprite:.ui-icon { background-image: url(images/ui-icons_XXXXXX_256x240.png); }。定製方案:

  1. 下載 ThemeRoller 生成的圖標 Sprite,替換顏色後覆蓋。
  2. 或改用 Font Awesome / SVG:.ui-icon { background: none; } .ui-icon::before { font-family: 'Font Awesome'; content: '\f00d'; }

動態修改單個 Dialog 樣式

$("#myDialog").dialog({
    dialogClass: "my-custom-dialog", // 給外層容器加類
    // ...
});

// CSS 針對性覆蓋
.my-custom-dialog .ui-dialog-titlebar { background: #e74c3c; }
.my-custom-dialog .ui-dialog-title { color: #fff; }

常見問題修復

問題原因修復
標題欄高度異常line-height / padding 衝突重置 .ui-dialog-title line-height, padding, float
遮罩層不顯示 / 層級錯亂z-index 衝突設置 .ui-widget-overlay z-index 低於 .ui-dialog
圖標不顯示 / 顯示亂碼Sprite 圖片路徑錯誤 / 字體未載入檢查 images/ 路徑或改用 Font Awesome
內容區滾動條樣式難看原生滾動條自定義 ::-webkit-scrollbar 或引入 perfect-scrollbar

現代替代方案

新項目建議考慮無依賴、體積更小的彈窗庫:

  • SweetAlert2 — 精美、Promise API、動畫豐富
  • Modal (Bootstrap 5) — 若已用 Bootstrap
  • Tingle.js — 純 ES6、無依賴、~7KB
  • 原生 <dialog> 元素 — Chrome/Edge/Firefox/Safari 15.4+ 支持,Polyfill 兼容舊瀏覽器

掌握核心類名與覆蓋技巧,即可將 jQuery UI Dialog 完美融入任意設計系統。

copyright © 萬盛學電腦網 all rights reserved