Modal彈窗,可以說是我們前端UI界面里的“標配”了。但這個組件,恰恰是團隊里代碼質量的“重災區(qū)”。
我見過太多用div手寫的彈窗了:z-index滿天飛、焦點管理一塌糊涂、背景頁面還能滾動、Esc鍵也關不掉……這些問題,每一個都是體驗上的硬傷。
所以,最近我們團隊的新項目,我立了一個規(guī)矩:只要是做模態(tài)對話框,一律優(yōu)先使用原生的<dialog>元素。
它不僅能解決上面所有問題,而且代碼量少得驚人。這篇文章,我就帶大家一步步地,用<dialog>來構建一個功能完善、可以直接拿到項目里用的Modal組件。
HTML骨架
我們不再需要一堆div來模擬結構。HTML的骨架非常簡單清晰。
<button class="open-button">打開彈窗</button>
<dialog class="my-modal">
<header class="modal-header">
<h2>我是彈窗標題</h2>
<button class="close-button">×</button>
</header>
<div class="modal-body">
<p>這里是彈窗的主體內容。</p>
<p>你可以試試按 Tab 鍵,焦點是不會跑到彈窗外面的。也可以按 Esc 鍵關閉。</p>
</div>
<footer class="modal-footer">
<button class="confirm-button">確認</button>
</footer>
</dialog>
這個結構里,header, body, footer只是為了樣式清晰,核心就是那個<dialog>標簽。
核心功能 - 用JS喚醒
我們需要一個簡單的腳本來控制dialog的開關。我們可以把它封裝成一個簡單的類,方便復用。
class Modal {
constructor(dialogEl) {
if (!dialogEl || dialogEl.tagName !== 'DIALOG') {
console.error('需要一個 <dialog> 元素');
return;
}
this.dialog = dialogEl;
this.closeButton = this.dialog.querySelector('.close-button');
this.handleBackdropClick = this.handleBackdropClick.bind(this);
this.init();
}
init() {
this.closeButton?.addEventListener('click', () => this.close());
this.dialog.addEventListener('click', this.handleBackdropClick);
}
open() {
this.dialog.showModal();
}
close() {
this.dialog.close();
}
handleBackdropClick(event) {
const rect = this.dialog.getBoundingClientRect();
const isInDialog = (
rect.top <= event.clientY && event.clientY <= rect.top + rect.height &&
rect.left <= event.clientX && event.clientX <= rect.left + rect.width
);
if (!isInDialog) {
this.close();
}
}
}
const dialogEl = document.querySelector('.my-modal');
const openBtn = document.querySelector('.open-button');
const modal = new Modal(dialogEl);
openBtn.addEventListener('click', () => modal.open());
代碼解析:
dialog.showModal() : 這是關鍵。調用它,瀏覽器會自動處理:
- 把
dialog放到頁面的最頂層(top layer),z-index再高也蓋不住它。 - 顯示一個默認的遮罩層。
- 自動管理焦點,并將頁面背景“惰性化”。
dialog.close() : 關閉彈窗。
點擊遮罩層關閉:這是原生<dialog>默認不帶的功能,但實現(xiàn)起來很簡單。我們監(jiān)聽dialog本身的點擊事件,判斷點擊坐標是否在dialog的矩形區(qū)域內,如果不在,就說明點的是遮罩層,此時調用close()方法即可。
美化外觀
現(xiàn)在彈窗能工作了,但樣子還很丑。我們需要給它和它的遮罩層加點樣式。
.my-modal {
width: min(90vw, 500px);
border: none;
border-radius: 8px;
box-shadow: 0 4px 20px rgba(0,0,0,0.2);
padding: 0;
}
.modal-header, .modal-body, .modal-footer {
padding: 1rem 1.5rem;
}
.modal-header {
display: flex;
justify-content: space-between;
align-items: center;
border-bottom: 1px solid #eee;
}
.close-button {
background: none;
border: none;
font-size: 1.5rem;
cursor: pointer;
}
.my-modal::backdrop {
background-color: rgba(0, 0, 0, 0.5);
backdrop-filter: blur(3px);
}
::backdrop 這個偽元素所有關于遮罩層的樣式,都應該寫在這里。
增加動畫 - 讓體驗更絲滑一些
默認的dialog是瞬間出現(xiàn)和消失的,體驗有點生硬。我們可以加點動畫。
.my-modal {
transition: opacity 0.3s, transform 0.3s;
}
.my-modal:not([open]) {
opacity: 0;
transform: translateY(30px);
}
.my-modal::backdrop {
transition: backdrop-filter 0.3s, background-color 0.3s;
}
.my-modal:not([open])::backdrop {
backdrop-filter: blur(0);
background-color: rgba(0, 0, 0, 0);
}
不過,你會發(fā)現(xiàn)關閉動畫不會生效,因為dialog.close()會立刻讓元素從DOM中消失。要實現(xiàn)完美的關閉動畫,需要一個小技巧:
close() {
this.dialog.classList.add('is-closing');
this.dialog.addEventListener('animationend', () => {
this.dialog.classList.remove('is-closing');
this.dialog.close();
}, { once: true });
}
@keyframes slide-out {
from { opacity: 1; transform: translateY(0); }
to { opacity: 0; transform: translateY(30px); }
}
.my-modal.is-closing {
animation: slide-out 0.3s ease-out forwards;
}
這個方法稍微復雜一點,但能實現(xiàn)完美的關閉動畫。對于大部分簡單場景,沒有關閉動畫也是可以接受的。
最后我們看看兼容性:

到目前位置,主流瀏覽器幾乎都支持原生dialog,但是值得注意的是 Safari, 它的支持度比起它瀏覽器稍晚,2022年后才開始支持,對于 Safari 瀏覽器 我更推薦大家使用等價的 polyfill 去解決。(推薦使用 Chrome 官方的 dialog-polyfill)
?
分享完畢,謝謝大家??
轉自https://juejin.cn/post/7532302427423817780
該文章在 2025/8/5 9:55:44 編輯過