jQuery UI Dialog 樣式由 ThemeRoller 生成的 CSS 控制,核心類名穩定。本文詳細拆解標題欄、內容區、按鈕區、關閉圖標、遮罩層等關鍵選擇器,提供覆蓋 CSS 範例,助你快速實現品牌化定製。
<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> <!-- 模態遮罩 -->
.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;
}
.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;
}
.ui-dialog .ui-dialog-content {
padding: 20px;
font-size: 14px;
line-height: 1.6;
overflow: auto; // 內容過長滾動
}
.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; }
.ui-widget-overlay {
background: rgba(0, 0, 0, 0.5); // 半透明黑
opacity: 1; // 覆蓋 jQuery UI 內部 opacity 動畫
z-index: 1000; // 確保在 dialog 之下
}
jQuery UI 使用 CSS Sprite:.ui-icon { background-image: url(images/ui-icons_XXXXXX_256x240.png); }。定製方案:
.ui-icon { background: none; } .ui-icon::before { font-family: 'Font Awesome'; content: '\f00d'; }$("#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 |
新項目建議考慮無依賴、體積更小的彈窗庫:
掌握核心類名與覆蓋技巧,即可將 jQuery UI Dialog 完美融入任意設計系統。