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