4.1 <dialog> 元素
HTML5 還引入了 <dialog> 元素,用來在網頁上建立對話方塊和模態視窗。有了這個元素,就能輕鬆且符合語意地建立各種用途的彈出視窗,例如通知、確認、輸入表單等等。下面我們來看看如何使用 <dialog>、它的屬性和方法,以及一些使用範例。
<dialog> 元素代表一個對話方塊或其他互動式視窗。它可以是模態的,也可以是非模態的。<dialog> 元素內可以放入任何 HTML 內容,例如文字、表單、按鈕等。
語法:
<dialog>
<!-- 對話方塊的內容 -->
</dialog>
<div style="min-height: 200px;">
<dialog id="favSuperHeroDialog">
<form method="dialog">
<div>
<label for="favSuperHero">最喜歡的超級英雄:</label>
<select id="favSuperHero" name="favSuperHero">
<option></option>
<option>美國隊長</option>
<option>鋼鐵人</option>
<option>浩克</option>
</select>
</div>
<div>
<button type="reset" id="cancel">重設</button>
<button type="submit">送出</button>
</div>
</form>
</dialog>
<button id="updateDetails">開啟對話方塊</button>
</div>
<dialog id="favSuperHeroDialog">
<form method="dialog">
<div>
<label for="favSuperHero">最喜歡的超級英雄:</label>
<select id="favSuperHero" name="favSuperHero">
<option></option>
<option>美國隊長</option>
<option>鋼鐵人</option>
<option>浩克</option>
</select>
</div>
<div>
<button type="reset" id="cancel">重設</button>
<button type="submit">送出</button>
</div>
</form>
</dialog>
<button id="updateDetails">開啟對話方塊</button>
// 從 DOM 取得按鈕和對話方塊
const updateButton = document.getElementById("updateDetails");
const cancelButton = document.getElementById("cancel");
const dialog = document.getElementById("favSuperHeroDialog");
// 檢查對話方塊狀態(開啟/關閉)的函式
function openCheck(dialog) {
if (dialog.open) {
console.log("對話方塊已開啟");
} else {
console.log("對話方塊已關閉");
}
}
// 點擊 Update 按鈕時開啟對話方塊
updateButton.addEventListener("click", () => {
dialog.showModal();
openCheck(dialog);
});
// 點擊 Cancel 按鈕時關閉對話方塊
cancelButton.addEventListener("click", () => {
dialog.close();
openCheck(dialog);
});
4.2 <dialog> 的屬性和方法
open 屬性決定對話方塊是否處於開啟狀態。只要有這個屬性,對話方塊就會顯示在頁面上。
open 屬性的使用範例:
<dialog open>
<p>這是一個開啟的對話方塊。</p>
</dialog>
透過 open 屬性顯示的視窗一定是非模態的。模態視窗要用 showModal() 方法開啟(下文會說明)。
returnValue 屬性儲存一個結果字串:視窗是以什麼值關閉的。它是對話方塊 JavaScript 物件的屬性(property),而不是 HTML 屬性(attribute),所以不會寫在標記裡。這個值由 close('值') 方法設定,或由 method="dialog" 表單中的按鈕設定——這時 returnValue 裡存放的是被按下按鈕的 value。如果用 Esc 鍵關閉視窗,returnValue 不會改變。
dialog.close('confirm');
console.log(dialog.returnValue); // "confirm"
show() 方法:
以非模態方式開啟對話方塊。
dialog.show();
showModal() 方法:
以模態方式開啟對話方塊,並阻止使用者與頁面其他部分互動。
dialog.showModal();
close() 方法:
關閉對話方塊。
dialog.close();
如何把方法「綁定」到按鈕上:最少量的 JavaScript
open 屬性會在頁面載入時立刻顯示視窗。為了讓視窗透過按鈕開啟和關閉,本課我們從 JavaScript 呼叫 show()、showModal() 和 close() 方法——作業裡需要的正是它們。這門語言之後會詳細介紹,現在用下面這個範本就夠了:
<button id="btn-open">顯示提示</button>
<dialog id="info-dialog">
<p>視窗文字</p>
<button id="btn-close">知道了</button>
</dialog>
<script>
// 1. 透過 id 找到頁面元素
const openBtn = document.getElementById('btn-open');
const closeBtn = document.getElementById('btn-close');
const infoDialog = document.getElementById('info-dialog');
// 2. 「按鈕被點擊時,執行大括號裡的程式碼」
openBtn.addEventListener('click', () => {
infoDialog.showModal(); // 以模態方式開啟
});
closeBtn.addEventListener('click', () => {
infoDialog.close(); // 關閉
});
</script>
<script>放在<body>的結尾:瀏覽器一讀到腳本就會立刻執行它,而這時腳本下方的元素還不存在——getElementById會回傳null。document.getElementById('…')——「給我一個有這個 id 的元素」。element.addEventListener('click', () => { … })——「當元素被點擊時,執行括號裡的程式碼」。() => { … }這種寫法是一個簡短的函式:稍後點擊時才會執行的程式碼。- 如果需要非模態視窗,請呼叫
show()而不是showModal()。
4.3 <dialog> 的事件
close 事件:
對話方塊關閉時觸發的事件。
<div style="min-height: 200px">
<dialog id="myDialog">
<form method="dialog">
<p>按下「取消」或「確定」按鈕來回傳值</p>
<div class="dialog-buttons">
<button value="cancel">取消</button>
<button value="confirm">確定</button>
</div>
</form>
</dialog>
<button id="showDialog">顯示對話方塊</button>
</div>
<dialog id="myDialog">
<form method="dialog">
<p>按下「取消」或「確定」按鈕來回傳值</p>
<div class="dialog-buttons">
<button value="cancel">取消</button>
<button value="confirm">確定</button>
</div>
</form>
</dialog>
<button id="showDialog">顯示對話方塊</button>
// 取得 DOM 元素
const dialog = document.getElementById('myDialog');
const showDialogButton = document.getElementById('showDialog');
// 開啟模態視窗
showDialogButton.addEventListener('click', () => {
dialog.showModal();
});
// 關閉時顯示 returnValue
dialog.addEventListener('close', () => {
alert(`對話方塊已關閉,回傳值:${dialog.returnValue}`);
});
cancel 事件:
取消對話方塊時觸發的事件(例如按下 Esc 鍵時)。
<div style="min-height: 200px">
<dialog id="myDialog">
<form method="dialog">
<p>按下「Esc」鍵查看結果</p>
</form>
</dialog>
<button id="showDialog">開啟對話方塊</button>
</div>
<dialog id="myDialog">
<form method="dialog">
<p>按下「Esc」鍵查看結果</p>
</form>
</dialog>
<button id="showDialog">開啟對話方塊</button>
// 取得 DOM 元素
const dialog = document.getElementById('myDialog');
const showDialogButton = document.getElementById('showDialog');
// 開啟對話方塊
showDialogButton.addEventListener("click", () => {
dialog.showModal();
});
// 處理對話方塊的取消(Esc 鍵)
dialog.addEventListener('cancel', () => {
alert('Dialog was cancelled');
});
GO TO FULL VERSION