dialog.close() 本身不能直接传参数，正确做法是先设置 dialog.returnValue，再执行 close()；form[method="dialog"] 也不会自动携带表单值，需要手动拦截 submit 并写入 returnValue；读取关闭结果时，最稳妥、最可靠的时机就是监听 close 事件；至于弹窗是通过按钮、Esc 还是遮罩关闭，HTML dialog 并没有内置 closedby 这类属性，必须自行标记关闭来源。
dialog.close() 不接受参数，dialog 传值关闭必须依赖 returnValue
如果直接写 dialog.close('confirm')，实际上是无效的，因为 close() 方法签名并不支持传参。也就是说，在 HTML 的 弹窗中，所有“关闭返回值”都必须提前通过 dialog.returnValue 来设置。这个属性是字符串类型，只有在调用 close() 之后才会作为最终关闭结果生效，而 close() 本身只是负责让对话框进入关闭状态并触发 close 事件。
开发中最常见的错误包括：
- 误以为
close('ok')可以像函数传参一样带值关闭，结果returnValue一直是空字符串 - 先执行
close()，再去设置returnValue，导致事件回调里拿到的是旧值或者空值 - 在非模态模式（
show()）下使用，虽然同样会触发close事件，但由于缺少明确的用户交互语境，returnValue的语义更容易混淆
正确顺序只有这一种：
dialog.returnValue = 'confirm'; dialog.close();
form[method="dialog"] 不能自动获取表单值
form[method="dialog"] 的能力其实很有限：它在表单提交时只会自动触发 dialog.close()，并不会帮你读取输入字段、序列化表单数据、设置 returnValue，也不会替你完成提交结果处理。想实现 dialog 带值关闭，就必须自己拦截提交逻辑并手动处理数据。
实际操作要点如下：
- 给
绑定submit事件，并在回调中执行event.preventDefault() - 通过
new FormData(form)或form.elements手动采集表单数据 - 把结构化数据转换成字符串，例如
JSON.stringify({name: 'a', ok: true})，再赋值给dialog.returnValue - 最后再调用
dialog.close()完成关闭
示例关键片段：
form.addEventListener('submit', (e) => {
e.preventDefault();
const data = Object.fromEntries(new FormData(form));
dialog.returnValue = JSON.stringify(data);
dialog.close();
});
监听 close 事件，才能安全读取 dialog.returnValue
close 事件是读取关闭结果最可靠的时机——它会在 close() 调用之后、对话框完成隐藏时触发，这时 dialog.returnValue 已经最终确定，同时 dialog.open 属性也会变为 false（注意：dialog.open 是只读属性，永远返回 true，判断 dialog 是否关闭更稳妥的方式是使用 dialog.hasAttribute('open') 或直接监听事件）。
这里常见的坑有：
- 在执行
close()后立刻读取returnValue，但这时事件尚未触发，拿到的可能仍是上一次的值 - 使用事件委托去监听
close，但这个事件不会冒泡，所以必须直接绑定到dialog元素本身 - 在
showModal()调用之前没有提前绑定监听器，导致第一次关闭时错过事件回调
推荐写法：
dialog.addEventListener('close', () => {
const result = dialog.returnValue;
console.log('关闭原因/数据:', result);
// 此处做清理：重置表单、清空动态内容、恢复焦点
});
想区分 dialog 的关闭来源，只能手动标记，没有 closedby 属性
标准里并不存在 closedby、close-trigger 这类可直接识别关闭来源的属性。也就是说，无论是点击遮罩关闭、按 Esc 键关闭，还是点击确认按钮关闭，都需要你在不同的交互路径中手动设置不同的 returnValue，这样后续才能准确判断 dialog 是怎么关闭的。
典型做法如下：
- 确认按钮：
button.onclick = () => { dialog.returnValue = 'confirm'; dialog.close(); } - 取消按钮：
button.onclick = () => { dialog.returnValue = 'cancel'; dialog.close(); } - 遮罩点击：
dialog.addEventListener('click', e => { if (e.target === dialog) { dialog.returnValue = 'overlay'; dialog.close(); } }); - Esc 键：
document.addEventListener('keydown', e => { if (e.key === 'Escape') { dialog.returnValue = 'escape'; dialog.close(); } });
最容易忽略的一点是：当用户按下 Esc 或点击遮罩时，returnValue 默认通常就是空字符串，除非你事先主动赋值。不要期待浏览器会自动帮你填入 “escape” 或 “backdrop” 这样的关闭标识。
