科技行业

如何使用 HTML、CSS 和 JavaScript 创建可访问的模态对话框

How to Create Accessible Modal Dialogs with HTML, CSS, and JavaScript

使用原生 HTML dialog 元素构建可访问的模态对话框。学习如何打开和关闭弹窗,管理键盘焦点,样式化背景遮罩,并在不使用 JavaScript 库的情况下创建确认对话框。

如何使用 HTML、CSS 和 JavaScript 创建可访问的弹窗对话框

一位访客在您的网站上点击一个按钮。一个包含表单、确认消息或附加信息的弹出窗口会出现。

创建视觉上的弹出窗口很容易。但让它与键盘、屏幕阅读器和移动浏览器正确配合,则是另一回事。

许多自定义弹窗实现依赖大量 JavaScript 来管理焦点、阻止与页面的交互,并处理 Escape 键。

现代 HTML 提供了更简单的方法:原生 <dialog> 元素。

它在浏览器中直接提供了弹窗对话框所期望的许多行为。您可以使用少量 HTML、CSS 和 JavaScript 创建功能性的弹出窗口,而无需安装框架或插件。

在本教程中,我们将构建一个可重用的弹窗,对其进行样式设置,添加一个确认对话框,并探索在真实网站中重要的无障碍细节。

1. 弹窗对话框有什么不同于普通弹出窗口?

一个弹窗对话框会暂时要求访客与界面中的某个特定部分进行交互,然后再返回主页面。

常见示例包括:

  • 确认删除某个项目。
  • 显示联系表单。
  • 在离开页面前请求确认。
  • 显示额外的产品信息。
  • 编辑应用程序设置。

一个妥善实现的弹窗应使其目的清晰,提供明确的关闭方式,并适当管理键盘焦点。

原生 <dialog> 元素支持弹窗和非弹窗两种行为。

方法 行为
showModal() 打开弹窗并使文档其余部分变为惰性状态
show() 打开非弹窗对话框
close() 关闭对话框
method="dialog" 允许表单按钮关闭对话框

弹窗行为包括浏览器提供的焦点管理和键盘交互。

2. 创建你的第一个 HTML 弹窗

让我们从一个简单的例子开始:一个打开包含标题、一些文本和关闭按钮的对话框的按钮。

<button type="button" id="openDialog">
    View delivery information
</button>

<dialog id="deliveryDialog"
        aria-labelledby="deliveryTitle">

    <h2 id="deliveryTitle">
        Delivery information
    </h2>

    <p>
        Orders are prepared within two business days.
        You will receive a tracking link by email.
    </p>

    <form method="dialog">
        <button type="submit" autofocus>
            Close
        </button>
    </form>

</dialog>

<script>
const openButton = document.getElementById('openDialog');
const dialog = document.getElementById('deliveryDialog');

openButton.addEventListener('click', () => {
    dialog.showModal();
});
</script>

这就足够创建一个可工作的弹窗对话框。

当访客点击按钮时,showModal() 会打开对话框,并在页面内容之上打开。

浏览器会自动处理若干重要行为:

  • 对话框进入顶层,位于普通页面内容之上。
  • 文档其余部分变为惰性状态。
  • 键盘焦点移动到对话框中。
  • 按下 Escape 通常会关闭它。
  • 对话框关闭时,焦点通常会返回到打开按钮。

关闭按钮使用 method="dialog",因此不需要 JavaScript 事件处理程序。

3. 使用 CSS 样式化对话框

默认对话框有效,但外观很基本。

我们可以为其添加圆角、舒适的间距、响应式宽度和背景。

dialog {
    width: min(90vw, 520px);
    max-height: 85vh;
    box-sizing: border-box;
    padding: 2rem;
    border: 0;
    border-radius: 14px;
    background: #fff;
    color: #20242b;
    box-shadow: 0 20px 70px rgba(0, 0, 0, .2);
    overflow: auto;
}

dialog::backdrop {
    background: rgba(15, 23, 42, .65);
    backdrop-filter: blur(3px);
}

dialog h2 {
    margin-top: 0;
    font-size: 1.5rem;
}

dialog p {
    line-height: 1.6;
}

dialog button {
    padding: .75rem 1.25rem;
    border: 0;
    border-radius: 8px;
    background: #2458d3;
    color: #fff;
    font: inherit;
    cursor: pointer;
}

dialog button:focus-visible {
    outline: 3px solid #f59e0b;
    outline-offset: 3px;
}

::backdrop 伪元素用于样式化弹窗对话框后面的层级。

它仅在对话框以模式化方式显示时出现,例如通过 showModal()。

使用 show() 打开的对话框不会自动获得相同的弹窗背景行为。

为什么使用顶层?

传统的自定义弹出窗口通常依赖越来越大的 z-index 值。

使用 showModal() 打开的弹窗进入浏览器的顶层,这可以避免许多堆叠上下文问题。

这在包含粘性标题、浮动小部件和复杂页面构建器的网站上特别有用。

4. 理解键盘无障碍

弹窗必须在没有鼠标的情况下工作。

想象一位访客使用 Tab 键浏览您的网站。当弹窗打开时,他们应该能够与其控件交互,而不会意外进入后面的页面。

原生弹窗对话框有助于实现这种行为。

W3C 将 HTML dialog 元素描述为创建无障碍弹窗对话框的一种技术,包括焦点包含和对话框关闭时焦点的返回。

为对话框提供无障碍名称

使用可见标题,并通过 aria-labelledby 进行引用:

<dialog aria-labelledby="settingsTitle">
    <h2 id="settingsTitle">Account settings</h2>
    ...
</dialog>

这为辅助技术为对话框提供了有意义的名称。

仔细选择初始焦点

autofocus 属性可以标识弹窗打开时应接收焦点的控件。

对于信息对话框,聚焦关闭按钮可能是合适的。

Illustration of the article's main concept

对于表单,聚焦第一个输入可能更有意义。

对于破坏性确认,聚焦更安全的选项,如 Cancel,通常更可取。

避免将 tabindex 直接放在 <dialog> 元素上;HTML 规范禁止该属性应用于元素本身。

始终提供可见的关闭按钮

尽管 Escape 通常可以关闭弹窗对话框,但可见的关闭控件仍然至关重要。

移动访客可能没有物理键盘,而且一些用户可能不知道 Escape 可以关闭弹出窗口。

5. 创建一个包含两个按钮的确认对话框

现在让我们构建一个更有用的例子:确认删除已保存的项目。

访客应该能够选择 Cancel 或 Delete。

HTML 通过 method="dialog" 和对话框的 returnValue 属性提供了一种便捷机制。

<button type="button" id="deleteItem">
    Delete item
</button>

<dialog id="confirmDialog"
        aria-labelledby="confirmTitle">

    <h2 id="confirmTitle">
        Delete this item?
    </h2>

    <p>
        This action cannot be undone.
    </p>

    <form method="dialog">
        <button value="cancel" autofocus>
            Cancel
        </button>

        <button value="confirm">
            Delete
        </button>
    </form>

</dialog>

<script>
const deleteButton = document.getElementById('deleteItem');
const confirmDialog = document.getElementById('confirmDialog');

deleteButton.addEventListener('click', () => {
    confirmDialog.returnValue = 'cancel';
    confirmDialog.showModal();
});

confirmDialog.addEventListener('close', () => {
    if (confirmDialog.returnValue === 'confirm') {
        // Call your application deletion logic here.
        console.log('Deletion confirmed');
    }
});
</script>

重要细节是:在 method="dialog" 表单内点击按钮会关闭对话框并设置其 returnValue。

我们的代码会检查用户是否选择了 confirm。

在打开前重置该值,可以防止用户通过 Escape 关闭对话框时,把之前的确认误当作新的确认。

这个例子刻意没有删除任何内容。在真实应用中,确认后的操作会调用您自己的 PHP 端点或应用程序控制器,并包含必要的授权和 CSRF 防护。

6. 测试确认工作流

一个有用的演示是已保存项目列表,每个项目都有 Delete 按钮。点击 Delete 应打开确认对话框。Cancel 应保持项目不变;Confirm 应仅删除选定项目。

这在不改变真实网站数据的情况下说明了确认流程。

7. 在对话框中添加联系表单

联系表单是另一个常见用例。

但关闭对话框和将数据提交到服务器之间存在重要区别。

带有 method="dialog" 的表单会关闭弹出窗口。它不会向您的 PHP 后端发送常规 HTTP 请求。

对于真实的联系表单,请使用常规表单提交或 AJAX 请求。

例如:

<dialog id="contactDialog"
        aria-labelledby="contactTitle">

    <h2 id="contactTitle">
        Contact us
    </h2>

    <form action="/contact-handler.php" method="post">
        <label for="contactEmail">
            Your email
        </label>

        <input
            type="email"
            id="contactEmail"
            name="email"
            required
            autocomplete="email"
            autofocus
        >

        <label for="contactMessage">
            Your message
        </label>

        <textarea
            id="contactMessage"
            name="message"
            required
        ></textarea>

        <button type="submit">
            Send message
        </button>

        <button type="button" id="closeContact">
            Cancel
        </button>
    </form>
</dialog>

Send 按钮会正常提交表单。

Cancel 按钮应在不提交的情况下关闭对话框:

document.getElementById('closeContact')
    .addEventListener('click', () => {
        document.getElementById('contactDialog').close();
    });

您的 PHP 处理程序仍需要验证提交的数据、实现反垃圾邮件保护,并返回有意义的成功或错误响应。

弹窗对话框改进了界面;它不会取代服务器端表单安全。

8. 用户能否通过点击外部关闭对话框?

许多网站允许访客通过点击其背景关闭弹出窗口。

这种行为通常称为 light dismiss。

现代 HTML 包含 closedby 属性,它可以指定是否可以通过外部交互、平台关闭请求或显式控件来关闭对话框。

例如:

<dialog id="infoDialog" closedby="any">
    <h2>More information</h2>
    <p>Additional details appear here.</p>

    <form method="dialog">
        <button>Close</button>
    </form>
</dialog>

closedby="any" 值允许在支持它的浏览器中启用轻关闭行为。

但是,应针对目标浏览器检查对更新版对话框功能的支持情况。基本的 showModal() 和 close() API 更为广泛地得到支持。

对于关键确认对话框,意外的外部关闭可能不可接受。

在所有情况下,请保留可见的关闭或取消控件。

9. 避免这些常见实现错误

Technical workflow illustration

通过添加 open 属性打开弹窗

这段代码:

dialog.setAttribute('open', '');

不能提供与以下相同的行为:

dialog.showModal();

open 属性会以非弹窗模式显示对话框。它不会自动使文档其余部分变为惰性状态。

当需要真正弹窗时,请使用 showModal()。

移除 open 属性以关闭弹窗

避免手动从活动弹窗中移除 open 属性。

请使用:

dialog.close();

这遵循预期生命周期,并确保适当的关闭行为。

使用链接代替按钮

用于打开界面操作的控件通常应为按钮:

<button type="button">Open settings</button>

对于导航到其他资源的链接,请使用链接。

忘记焦点可见性

使用键盘导航的用户需要可见的活动控件指示。

请保留清晰的 :focus-visible 样式,而不是在没有替代的情况下移除浏览器焦点轮廓。

将对话框放在隐藏容器中

如果父容器被隐藏,或者 CMS 动态替换周围标记,对话框可能行为异常。

对于页面构建器集成,请优先使用稳定容器,并确保 JavaScript 在对话框插入文档后运行。

10. 将对话框集成到 WordPress 或 Joomla 中

你不需要创建一个扩展就能使用原生对话框元素。

对于简单网站,集成由三部分组成:

部分 位置
HTML 标记 自定义 HTML 块、模块、模板或页面构建器元素
CSS 主题或模板自定义 CSS
JavaScript 主题/模板自定义 JavaScript 或受支持的代码注入功能

WordPress

在 WordPress 中,您可以将 HTML 放在自定义 HTML 块中,前提是您的账户和编辑器配置允许必要的标记。

通过主题支持的自定义 CSS 机制添加样式。

对于 JavaScript,请使用受支持主题的脚本区域、子主题,或一个正确处理 JavaScript 的可靠代码插入扩展。

某些编辑器和安全配置会过滤 <script> 元素。请不要假设直接粘贴到内容块中的 JavaScript 会执行。

Joomla

在 Joomla 中,自定义模块或允许合适 HTML 标记的编辑器可以在其中包含对话框。

将 CSS 添加到您模板的自定义样式表中,例如在基于 Cassiopeia 的网站中为 user.css。

将 JavaScript 放在模板支持的自定义脚本位置,或通过合适的扩展。

根据配置的编辑器和文本过滤器,Joomla 在保存内容时可能会删除某些元素或属性。

如果您的标记消失了,请检查编辑器和过滤配置,而不是反复粘贴相同代码。

页面构建器

对视觉页面构建器也适用相同的原则:使用其 HTML、CSS 和 JavaScript 集成能力。

对于动态加载的内容,请仅在相关元素存在后初始化事件监听器。

如果页面包含多个对话框,请为每个对话框提供唯一 ID。

11. 在发布前测试您的弹窗

一个在桌面端看起来正确的对话框仍可能存在可用性问题。

请使用鼠标、键盘和移动设备进行测试。

测试 预期结果
点击打开按钮 对话框出现
按下 Tab 焦点保持在弹窗控件内
按下 Shift + Tab 反向键盘导航有效
按下 Escape 在允许时关闭对话框
点击 Close 或 Cancel 对话框关闭
关闭对话框 焦点适当返回
在移动端打开 内容保持可读且可滚动
提交无效表单 验证反馈可见
提交有效表单 应用正确处理数据
使用屏幕阅读器 对话框有可理解的名称

W3C 的 WCAG 技术 H102 为验证原生弹窗行为提供了有用的指导。

12. 何时应该使用对话框,而不是插件?

原生对话框特别适合小型、聚焦的交互:确认、信息面板和简单表单。

对于更复杂的需求,例如多步骤向导、高级画廊或与 CMS 工作流深度集成的对话框,专用组件或扩展可能仍然是更易维护的选项。

原生方法的优势在于,它提供稳固的浏览器支持基础,而不会引入另一个 JavaScript 依赖。

它还减少了您需要自己实现的自定义焦点和键盘管理量。

结论:从浏览器内置功能开始

弹窗对话框不需要依赖大型 JavaScript 库。

原生 HTML <dialog> 元素为无障碍弹出窗口、确认消息和表单提供了有效的基础。

借助 showModal()、close()、method="dialog" 和少量 CSS 规则,您可以创建一个在现代浏览器中正常工作的界面,同时受益于内置的焦点和键盘行为。

对于 WordPress、Joomla 和自定义 PHP 网站,这可以成为为相对简单的交互安装另一个插件的有效替代方案。

关键是正确使用原生行为、提供清晰控件,并使用真实的键盘和移动交互进行测试。

官方和技术参考