拾光 HTML从头到尾,读懂标记语言

第五章 · 进阶

现代 HTML 进阶:让浏览器替你写交互

过去需要一整个组件库才能完成的折叠、弹窗、浮层与自定义组件,如今大多写进了 HTML 规范。 这一章从 details 讲到 Web Components,把「原生优先」这四个字拆成可以上手的代码。 每一个例子都能直接运行,也能在没有框架的项目里落地。

阅读约 32 分钟 18 个示例 进阶难度 含实时预览

details 与 summary:原生的折叠面板

<details> 是浏览器自带的折叠面板。<summary> 是始终可见的标题行, 其余子节点构成折叠内容。它默认收起,点击标题、按 Enter 或空格都能展开; 屏幕阅读器会朗读「已折叠 / 已展开」,不需要我们写一行 JavaScript,也不需要手写 aria-expanded。这类由浏览器直接实现语义的控件,是「原生优先」最典型的收益。

open 是布尔属性:写在标签里表示默认展开,去掉即收起。脚本里可以用 el.open = true 或 el.toggleAttribute('open') 控制, 但大多数时候根本不需要脚本介入。

较新的浏览器给 details 增加了 name 属性:若干 details 共用同一个 name 时,它们组成互斥组,打开一个,另一个自动收起。 过去要靠监听 toggle 事件、手动关闭兄弟节点才能实现的手风琴, 现在一行属性就够了。2023 年末起 Chromium 与 Safari 支持,Firefox 在 2024 年跟进; 旧浏览器会把它当成各自独立的面板,功能依旧可用,属于优雅降级。

几个容易踩的坑:summary 必须是 details 的第一个子元素, 且只能有一个,否则浏览器会自己补一个;默认箭头由浏览器绘制,想换成加号需要先把 list-style 设为 none,再处理 WebKit 遗留的 ::-webkit-details-marker;折叠只是不显示,内容仍然会被下载和解析, 所以不要用它藏敏感信息;打印样式里记得让 details 带上 open, 否则纸上只剩标题。

html 最简折叠:零 JavaScript
<details>
  <summary>为什么要用原生折叠?</summary>
  <p>因为键盘操作、焦点与屏幕阅读器播报,浏览器都已经处理好了。</p>
</details>

<details open>
  <summary>默认展开的写法</summary>
  <p>加上 open 布尔属性即可,不需要写 open="true"。</p>
</details>
原生效果
点我展开:这一段没有任何脚本

用 Tab 键聚焦标题,再按空格或回车,展开与收起同样有效。

读屏软件会播报当前是「已展开」还是「已折叠」。

html name 互斥手风琴 + 定制标记
<style>
  .faq { border: 1px solid #e7dece; border-radius: 10px; background: #fffdf9; overflow: hidden; }
  .faq details + details { border-top: 1px solid #e7dece; }
  .faq summary {
    display: flex; align-items: center; justify-content: space-between;
    padding: 12px 16px; font-weight: 600; cursor: pointer; list-style: none;
  }
  .faq summary::-webkit-details-marker { display: none; }
  .faq summary::after { content: "+"; color: #a97862; font-weight: 400; }
  .faq details[open] summary::after { content: "-"; }
  .faq p { margin: 0; padding: 0 16px 14px; color: #6b6459; font-size: 14px; }
</style>

<div class="faq">
  <details name="faq" open>
    <summary>第一章讲什么</summary>
    <p>从 DOCTYPE 开始,认识元素、属性与文本语义。</p>
  </details>
  <details name="faq">
    <summary>需要 JavaScript 吗</summary>
    <p>不需要。打开一个,另一个会自动收起。</p>
  </details>
  <details name="faq">
    <summary>旧浏览器怎么办</summary>
    <p>退化成可以同时展开的独立面板,内容照样读得到。</p>
  </details>
</div>
设计建议

折叠适合「次要但有用」的内容:常见问题、补充说明、高级选项。把用户必须看到的关键信息藏在折叠里,是一种不友好的省略。

dialog:原生的模态与非模态对话框

<dialog> 默认是 display: none,必须通过脚本打开。 showModal() 打开的是模态对话框:元素被放进 top layer,覆盖在所有内容之上, 浏览器自动生成 ::backdrop 遮罩;焦点被限制在对话框内,Tab 不会跑到页面其他部分;按 Esc 会触发 cancel 事件并关闭; 关闭后焦点回到打开它的那个按钮。 show() 则只是把元素显示出来,不进入模态状态,没有遮罩,也不限制焦点。

dialog 与表单的配合尤其漂亮:给 <form> 加上 method="dialog",提交时浏览器不会发请求,而是关闭对话框, 并把被点击按钮的 value 写进 dialog.returnValue。 于是「保存 / 取消」这样的分支,只需要比较返回值即可,不必为每个按钮单独绑定事件。

坑也不少:不要用 CSS 的 display: block 强行显示 dialog, 那样会失去模态能力与遮罩;自定义关闭动画时,要等 animationend 之后再调用 close();不要同时打开两个模态对话框,用户会失去方向; returnValue 只在 method="dialog" 提交或 close(value) 时才被设置,直接点遮罩关闭并不会自动给你想要的值。 移动端 Safari 从 15.4 起支持,更旧的版本需要降级成页内区块。

html showModal + method="dialog" 完整示例
<style>
  dialog { border: 1px solid #e7dece; border-radius: 12px; padding: 22px; max-width: 340px; font-family: system-ui, sans-serif; }
  dialog::backdrop { background: rgba(44, 51, 46, .45); }
  dialog h3 { margin: 0 0 8px; font-size: 17px; }
  dialog menu { display: flex; gap: 8px; justify-content: flex-end; padding: 0; margin: 18px 0 0; }
</style>

<button id="open">打开阅读设置</button>

<dialog id="prefs">
  <h3>阅读偏好</h3>
  <p>选择字号,然后保存。</p>
  <form method="dialog">
    <label><input type="radio" name="size" value="small"> 小</label>
    <label><input type="radio" name="size" value="large" checked> 大</label>
    <menu>
      <button value="cancel">取消</button>
      <button value="save">保存</button>
    </menu>
  </form>
</dialog>

<p id="echo"></p>

<script>
  var dlg = document.getElementById('prefs');
  document.getElementById('open').addEventListener('click', function () {
    dlg.showModal();
  });
  dlg.addEventListener('close', function () {
    document.getElementById('echo').textContent = '返回值:' + dlg.returnValue;
  });
</script>
html Esc、cancel 与脚本关闭
<dialog id="note">
  <form method="dialog">
    <p>确定要删除这条笔记吗?</p>
    <button value="no">再想想</button>
    <button value="yes">删除</button>
  </form>
</dialog>

<script>
  var note = document.getElementById('note');
  note.showModal();

  // Esc 会先触发 cancel,可以在这里拦截
  note.addEventListener('cancel', function (event) {
    event.preventDefault();          // 阻止这次关闭
    note.close('canceled');          // 也可以换成自己的逻辑
  });

  // 脚本关闭并携带返回值
  // note.close('dismiss');
</script>
焦点要交给浏览器

模态对话框的焦点陷阱、返回焦点、Esc 关闭都是原生行为,不要再手写一遍。你只需要在对话框里给第一个输入框加 autofocus,并确保打开前元素已经在 DOM 中。

Popover API:声明式的轻量浮层

popover 属性把一个元素声明为浮层。它默认隐藏,被打开时进入 top layer, 不受父元素的 overflow、z-index 与 transform 影响—— 这正是过去做 tooltip 与下拉菜单时最难处理的地方。声明式写法只需要两个属性: 按钮上写 popovertarget="id",浮层上写 popover。 点击按钮即可切换显示;点页面空白处或按 Esc 会关闭,这叫 light dismiss。

popovertargetaction 可以指定 show、hide 或 toggle,让同一个按钮承担打开、关闭两种职责。默认的 popover="auto" 同一时间只允许一个自动浮层打开,打开新的会自动关掉旧的; popover="manual" 则完全手动,不会因为点外部或 Esc 而关闭, 适合需要用户明确确认的浮层。脚本里对应 showPopover()、 hidePopover()、togglePopover(), CSS 里用 :popover-open 匹配打开状态。

与 dialog 的区别要记清:popover 不阻塞页面、不锁焦点、没有遮罩, 也不适合承载必须完成的任务;它更像「补充信息」与「快捷操作」。 反过来,需要用户做出决定时,用 dialog。 定位上,浏览器给 popover 的默认样式是固定在视口中央,要做贴着按钮的气泡, 目前常用 CSS 锚点定位(anchor-name 与 position-anchor), 支持度还不一致,生产环境常配合少量 JavaScript 计算位置。

还有一个隐蔽的坑:不支持 popover 的浏览器不会隐藏元素,内容会直接出现在页面上。 如果这段内容必须隐藏,要么用脚本检测后手动隐藏,要么把它写成「直接可见也不影响理解」的降级形态。

html 按钮 + popover:最少的声明
<button popovertarget="tip">查看提示</button>

<div id="tip" popover>
  <p>这是一个 popover:点空白处或按 Esc 就会关闭。</p>
</div>
html manual 浮层与操作按钮
<button popovertarget="menu" popovertargetaction="toggle">切换菜单</button>

<div id="menu" popover="manual">
  <p>手动浮层,不会因为点击外部而消失。</p>
  <button popovertarget="menu" popovertargetaction="hide">关闭</button>
</div>

<script>
  var menu = document.getElementById('menu');
  // 脚本控制:menu.showPopover() / hidePopover() / togglePopover()
  menu.addEventListener('toggle', function (event) {
    console.log(event.newState); // "open" 或 "closed"
  });
</script>
合适的内容

帮助说明、快捷菜单、颜色选择器、通知气泡,都是 popover 的好场景。不要让 popover 里出现「必须完成才能继续」的表单——那属于 dialog。

template:不会自己渲染的模板

<template> 是一段「惰性」的 HTML:写在页面里,却不会被渲染, 也不会产生任何副作用——里面的图片不会请求,媒体不会加载,脚本不会执行, 表单控件也不会参与提交。浏览器把它解析进一个独立的、惰性的文档片段, 保存在 template.content 里;主文档树中,template 的 childNodes.length 是 0。

需要使用时,克隆 content 再插入 DOM: tpl.content.cloneNode(true),true 表示深克隆。 插入之后它才成为真正的节点,图片开始加载,脚本(如果克隆进来)才会执行。 它适合存放「稍后重复使用」的结构:列表行、卡片、表格行、对话框骨架, 以及 Web Component 的初始模板。

三个坑:用 innerHTML 读 template,得到的是源码字符串而不是节点; 直接 appendChild(tpl.content) 会把片段里的节点搬走,第二次就空了,所以要先克隆; 模板里如果写了 id,克隆多次会造成重复 id,改用 class 或 data-*。另外,模板内容不参与页面渲染,也不会被屏幕阅读器读到, 用克隆之后记得给新节点补上必要的语义。

html 克隆模板生成卡片
<style>
  .card { border: 1px solid #e7dece; border-radius: 10px; padding: 12px 14px; margin-bottom: 10px; background: #fffdf9; }
  .card h3 { margin: 0 0 4px; font-size: 15px; color: #3a3631; }
  .card p { margin: 0; font-size: 13px; color: #6b6459; }
</style>

<template id="card-tpl">
  <article class="card">
    <h3></h3>
    <p></p>
  </article>
</template>

<div id="list"></div>
<button id="add">再来一张</button>

<script>
  var tpl = document.getElementById('card-tpl');
  var list = document.getElementById('list');
  var count = 0;

  function add() {
    count++;
    var node = tpl.content.cloneNode(true);
    node.querySelector('h3').textContent = '卡片 ' + count;
    node.querySelector('p').textContent = '克隆出来的节点,才是真正的 DOM。';
    list.appendChild(node);
  }

  document.getElementById('add').addEventListener('click', add);
  add();
  add();
</script>
html content 才是真正的容器
<template id="row">
  <tr><td>山间笔记</td><td>林晚</td></tr>
</template>

<table>
  <tbody id="rows"></tbody>
</table>

<script>
  var tpl = document.getElementById('row');
  console.log(tpl.childNodes.length);        // 0
  console.log(tpl.content.childNodes.length); // 1

  // 先克隆,再插入;否则节点会被搬走
  document.getElementById('rows')
    .appendChild(tpl.content.cloneNode(true));
</script>

Web Components 入门:自己造一个标签

Web Components 不是单个 API,而是三块拼图:自定义元素(customElements.define)、 影子 DOM(attachShadow)与模板/插槽(template、slot)。 它们让浏览器原生支持「封装一个组件」,不需要框架。

自定义元素 用 customElements.define() 注册一个带连字符的标签名,浏览器从此认识它,并像内置元素一样解析、升级与派发生命周期回调。
影子 DOM attachShadow() 在元素内部挂一棵独立的树,样式互不干扰,适合封装不希望被外部改写的结构与外观。
模板与插槽 template 存放不立即渲染的骨架,slot 留出由使用者填充的位置,两者一起把「结构」与「内容」分开。

customElements.define('user-card', UserCard) 把一个类注册为标签。 标签名必须包含连字符,这是规范用来区分「自定义」与「未来内置元素」的约定, 也避免与现有标签冲突。类继承 HTMLElement,构造函数里可以挂影子根, 但不应该读写属性或子节点——那时元素还没有插入文档。

生命周期有四个:constructor 建立内部结构;connectedCallback 在元素插入文档时调用,适合读取属性、发起请求、添加监听;disconnectedCallback 在移出文档时调用,适合清理定时器与监听;attributeChangedCallback 配合 static observedAttributes 监听指定属性。理解这四个钩子, 就理解了一半的组件行为。

attachShadow({ mode: 'open' }) 创建影子根,内部样式只作用于内部, 外部样式也进不来;mode: 'closed' 会让 shadowRoot 对外为 null,一般不必要。样式可以用 :host 选中宿主, 用 :host([theme="dark"]) 按属性变化,用 ::slotted(p) 选中插进来的内容(只能选一层)。CSS 自定义属性可以穿透影子边界,是主题化的推荐方式。

<slot> 是内容的入口:组件内部写 <slot></slot>, 使用时标签内部的内容就会被放进这个位置;具名插槽用 slot="title" 对应 <slot name="title">。没有对应插槽的内容不会显示; <slot> 内部写的后备内容,在没有插入内容时显示。

坑:同一个标签名只能注册一次,重复 define 会抛错; 「升级」发生在元素进入文档时,之前设置的属性会在升级后通过 attributeChangedCallback 补发;影子 DOM 内的内容对全局样式不可见, 做 SEO 关键内容时不要全塞进影子树。

html 一个带插槽与样式隔离的 user-card
<user-card name="林晚" role="前端工程师">
  <p>喜欢把复杂的东西,写得简单一点。</p>
</user-card>

<script>
  class UserCard extends HTMLElement {
    constructor() {
      super();
      var shadow = this.attachShadow({ mode: 'open' });
      shadow.innerHTML = `
        <style>
          :host {
            display: block;
            border: 1px solid #e7dece;
            border-radius: 12px;
            padding: 16px;
            background: #fffdf9;
            font-family: system-ui, sans-serif;
          }
          h3 { margin: 0 0 4px; font-size: 16px; color: #3a3631; }
          .role { margin: 0 0 10px; font-size: 12px; color: #978d7f; }
          ::slotted(p) { margin: 0; font-size: 14px; color: #6b6459; }
        </style>
        <h3></h3>
        <p class="role"></p>
        <slot></slot>
      `;
    }

    connectedCallback() {
      this.shadowRoot.querySelector('h3').textContent =
        this.getAttribute('name') || '未命名';
      this.shadowRoot.querySelector('.role').textContent =
        this.getAttribute('role') || '';
    }
  }

  customElements.define('user-card', UserCard);
</script>
html 响应属性变化
<count-badge count="3"></count-badge>

<script>
  class CountBadge extends HTMLElement {
    static get observedAttributes() {
      return ['count'];
    }

    attributeChangedCallback(name, oldValue, newValue) {
      if (name === 'count' && oldValue !== newValue) {
        this.textContent = newValue;
      }
    }
  }

  customElements.define('count-badge', CountBadge);
</script>
不要把一切都塞进组件

一个页面只有三五处复用的结构,用模板与普通元素更省事。Web Components 的价值在于跨项目复用与样式隔离,不在于把每个按钮都包一层。

全局属性进阶:不改变元素,改变行为

全局属性可以写在任何元素上。它们不改变元素「是什么」,却改变元素「怎么被对待」。 这一节挑几个最常被忽略、又最实用的属性。

属性作用注意
data-*挂载自定义数据,JS 用 dataset 读取值永远是字符串,连字符转驼峰
hidden隐藏,且告知辅助技术「当前不相关」相当于 display: none,不可与 CSS 强制显示混用
hidden="until-found"隐藏但可被页内查找命中并展开支持有限,不支持时退化为普通 hidden
inert整块不可点击、不可聚焦、不进无障碍树模态背景隔离的首选
contenteditable让内容可编辑plaintext-only 更安全,但支持较晚
draggable开启原生拖放Firefox 需要 setData 才能拖动
tabindex控制聚焦顺序0 进入顺序,-1 仅脚本聚焦;避免正数
translate / spellcheck / lang翻译、拼写检查、语言覆盖lang 可以就地覆盖,利于读屏发音

data-* 的值永远是字符串,数字要自己转换;它适合存「与这个节点绑定的小状态」, 不适合存大段 JSON——那更适合放进 <script type="application/json">。 dataset 会把 data-user-id 映射成 dataset.userId, 事件委托时可以靠它一次性识别成百上千个列表项。

inert 值得单独强调:打开抽屉或模态时,与其写一套焦点陷阱, 不如把背景容器设为 inert,它在可访问性树里会整块消失, 点击与 Tab 都无法进入。关闭时移除属性即可,几乎不会出错。 tabindex="-1" 则常用于对话框标题或页内跳转的目标,让脚本可以聚焦,但不打扰 Tab 顺序。

html data-*、hidden、inert
<style>
  .zone { border: 1px dashed #d8ae9f; border-radius: 8px; padding: 10px 12px; margin: 8px 0; font-size: 14px; }
</style>

<button class="fav" data-id="42" data-kind="note">收藏这条笔记</button>

<script>
  var btn = document.querySelector('.fav');
  btn.addEventListener('click', function () {
    // data-id 变成 dataset.id,data-kind 变成 dataset.kind
    console.log(btn.dataset.id, btn.dataset.kind);
  });
</script>

<p hidden>这一段被 hidden 隐藏,屏幕阅读器也不会读。</p>

<div hidden="until-found">
  <p>页内查找「山间」可以定位到这里,并自动展开。</p>
</div>

<div class="zone" inert>
  <p>整块 inert:按钮点不动,Tab 也进不来。</p>
  <button>按不到的按钮</button>
</div>
html 可编辑、聚焦与语言覆盖
<p contenteditable="true">这段文字可以直接编辑,试试看。</p>
<p contenteditable="plaintext-only">这一行只接受纯文本。</p>

<div tabindex="0">可以用 Tab 聚焦的盒子</div>
<div tabindex="-1">只能被脚本聚焦的盒子</div>

<p translate="no">拾光 HTML</p>

<p lang="en">A paragraph in English, read with English pronunciation.</p>
html 原生拖放的最小闭环
<div id="chip" draggable="true">拖动我</div>
<div id="zone">放到这里</div>

<script>
  var chip = document.getElementById('chip');
  var zone = document.getElementById('zone');

  chip.addEventListener('dragstart', function (event) {
    // Firefox 必须写入数据,拖动才会开始
    event.dataTransfer.setData('text/plain', 'chip');
  });

  zone.addEventListener('dragover', function (event) {
    event.preventDefault(); // 允许放置
  });

  zone.addEventListener('drop', function (event) {
    event.preventDefault();
    zone.appendChild(chip);
  });
</script>

语义化数据元素:time、data、meter、progress、output

HTML 里有一组专门描述「数据」的元素,它们不负责排版,却能让人和机器都更准确地理解数值。 time 表示时间,datetime 提供机器可读的格式; data 把机器值与人类可读的文本配对;meter 表示一个已知范围内的标量测量; progress 表示任务的完成进度;output 表示计算或用户操作的结果。

元素表示什么关键属性
<time>一个时间点或时间段datetime
<data>机器值与显示值配对value
<meter>已知范围内的测量,如磁盘占用、评分min max low high optimum value
<progress>任务进度,省略 value 表示不确定value max
<output>计算或用户操作的结果for name

meter 与 progress 常被混用。meter 是「测量」,有 min / max / low / high / optimum,浏览器会据此把刻度染成不同颜色,适合展示「现在处于什么水平」; progress 是「进度」,表示向目标推进的过程,省略 value 时显示为不确定的滚动条纹。 用错不会报错,但语义就丢了,辅助技术也无法区分「完成了 60%」与「占用率 60%」。

time 的 datetime 支持多种格式:完整的日期时间带时区、只有日期、 只有月份、只有时间,以及持续时间(PT2H30M 表示两小时三十分钟)。 写清楚时区能避免跨时区显示错误,也方便搜索引擎与日历工具解析。 output 的 for 属性列出参与计算的控件 id(空格分隔), 它不会自动计算,需要脚本把结果写进去。

html 时间、测量、进度与计算结果
<p>发布于 <time datetime="2026-11-16T09:30:00+08:00">2026 年 11 月 16 日</time></p>

<p>当前版本 <data value="3.2.1">拾光 3.2</data></p>

<p>存储空间:
  <meter min="0" max="10" low="3" high="8" optimum="2" value="8.6">8.6 / 10</meter>
</p>

<p>上传进度:
  <progress max="100" value="65">65%</progress>
</p>

<p>等待中:
  <progress></progress>
</p>

<form onsubmit="return false">
  <label>单价 <input id="price" type="number" value="12"></label>
  <label>数量 <input id="qty" type="number" value="3"></label>
  <p>合计:<output name="total" for="price qty">36</output></p>
</form>

<script>
  var price = document.getElementById('price');
  var qty = document.getElementById('qty');
  var total = document.querySelector('output');

  function sum() {
    total.value = Number(price.value) * Number(qty.value);
  }
  price.addEventListener('input', sum);
  qty.addEventListener('input', sum);
  sum();
</script>
html datetime 的常见写法
<time datetime="2026-11-16">11 月 16 日</time>
<time datetime="2026-11">2026 年 11 月</time>
<time datetime="09:30">早上九点半</time>
<time datetime="PT2H30M">两个半小时</time>
<time datetime="2026-11-16T09:30:00+08:00">北京时间十一点</time>
给机器一条准确的路

只要页面里出现日期、价格、评分、进度,就值得用对应的语义元素。它们不会让页面更漂亮,却能让搜索结果、读屏软件与未来的你,都少猜一次。

组合实战:一个不用框架的设置面板

把前面几件原生工具放在一起,可以搭出一个像样的设置面板: dialog 提供模态与返回值,form method="dialog" 提供「保存 / 取消」的语义, details 把选项分组折叠,popover 承担「这个选项是什么意思」的轻量解释。 JavaScript 只做两件事:打开对话框,以及读取返回值。

这种写法的好处是每一层都有原生语义:键盘、焦点、Esc、遮罩、返回焦点都由浏览器负责; 代码里没有手写的焦点陷阱,也没有 z-index 战争。表单数据在关闭时用 FormData 一次性读取,不必为每个控件绑定 change, 代码量常常只有框架方案的三分之一。

要留意的是「状态的归属」:dialog.returnValue 只表达「用户按了哪个按钮」, 真正的偏好仍然要自己保存。示例里只是把结果显示出来,真实项目里应该写入 localStorage 或提交给服务端,并在页面加载时回填控件。

html dialog + form + details + popover
<style>
  dialog { border: 1px solid #e7dece; border-radius: 12px; padding: 20px; max-width: 360px; font-family: system-ui, sans-serif; }
  dialog::backdrop { background: rgba(44, 51, 46, .45); }
  dialog h3 { margin: 0 0 12px; font-size: 16px; }
  details { border-top: 1px dashed #e7dece; padding: 8px 0; }
  summary { cursor: pointer; font-size: 14px; color: #3a3631; }
  dialog menu { display: flex; gap: 8px; justify-content: flex-end; padding: 0; margin: 16px 0 0; }
</style>

<button id="open-settings">打开设置</button>

<dialog id="settings">
  <form method="dialog">
    <h3>阅读设置</h3>

    <details open>
      <summary>外观</summary>
      <label><input type="radio" name="theme" value="light" checked> 浅色</label>
      <label><input type="radio" name="theme" value="dark"> 深色</label>
    </details>

    <details>
      <summary>字号</summary>
      <label><input type="range" name="size" min="14" max="22" value="16"></label>
    </details>

    <p>
      <button type="button" popovertarget="help">这些设置有什么用?</button>
      <span id="help" popover>偏好只保存在本机浏览器中,随时可以更改。</span>
    </p>

    <menu>
      <button value="cancel">取消</button>
      <button value="save">保存</button>
    </menu>
  </form>
</dialog>

<p id="result"></p>

<script>
  var dlg = document.getElementById('settings');
  var result = document.getElementById('result');

  document.getElementById('open-settings').addEventListener('click', function () {
    dlg.showModal();
  });

  dlg.addEventListener('close', function () {
    if (dlg.returnValue === 'save') {
      var data = new FormData(dlg.querySelector('form'));
      result.textContent = '已保存:' + data.get('theme') + ' / ' + data.get('size') + 'px';
    } else {
      result.textContent = '已取消';
    }
  });
</script>
拆开看

dialog 管「何时遮住页面」,form 管「提交什么」,details 管「怎样分组」,popover 管「解释放在哪」。四件事各归其位,组合起来就成了一套声明式交互。

渐进增强与浏览器支持

新特性令人愉快,但用户手里的浏览器并不会同步更新。渐进增强的思路是: 先保证核心内容与功能在任何环境都可用,再为支持的环境叠加更好的体验。 它不是「放弃新特性」,而是「让新特性成为加分项,而不是及格线」。

特性检测的对象是「能力」而不是「浏览器」: 'showModal' in HTMLDialogElement.prototype 比判断 UA 可靠得多; CSS.supports('selector(:popover-open)') 与 @supports 可以在样式层做分支;customElements.get('user-card') 能知道你关心的组件是否已注册。 检测结果应该用于「选择实现」,而不是「拒绝用户」。

一个实用的判断表:details、template、自定义元素已经非常稳; dialog 从 2022 年起进入 Baseline,可以放心用,只需给旧浏览器一个 「直接显示内容」的降级;popover 2024 年才进入 Baseline,建议把它当增强; details 的 name 互斥、hidden="until-found"、 CSS 锚点定位这些更年轻的特性,必须准备降级方案。

原生优先不代表拒绝 JavaScript。原生负责结构与交互语义,脚本负责业务与兜底; 当原生能力缺失时,用一小段脚本补上同样的行为,而不是引入一整个组件库。 这也是本站在所有示例里坚持「先写 HTML,再考虑脚本」的原因。

javascript 检测能力,而不是检测浏览器
<script>
  var hasModal = 'showModal' in HTMLDialogElement.prototype;
  var hasPopover = 'popover' in HTMLElement.prototype;

  function openPanel(el) {
    if (hasModal && typeof el.showModal === 'function') {
      el.showModal();
      return;
    }
    // 降级:当作普通区块显示,并补上对话框语义
    el.setAttribute('open', '');
    el.setAttribute('role', 'dialog');
    el.setAttribute('aria-modal', 'false');
  }

  // 组件是否已注册,也可以在需要时再加载
  customElements.whenDefined('user-card').then(function () {
    document.body.classList.add('has-user-card');
  });
</script>
css 用 @supports 给样式分层
<style>
  /* 基础样式:所有浏览器都能用 */
  .menu {
    display: block;
    border: 1px solid #e7dece;
    border-radius: 10px;
    padding: 10px 12px;
    background: #fffdf9;
  }

  /* 支持 popover 时,才让它成为浮层 */
  @supports selector(:popover-open) {
    .menu {
      margin: 0;
      border: 1px solid #d8ae9f;
    }
    .menu:popover-open { display: block; }
  }
</style>
降级不是隐藏

用 JavaScript 补样式时,如果脚本本身加载失败,内容就会消失。所以默认样式必须是「可见且可读」的,增强脚本只负责把体验往上加一层。

进阶清单与小结

这一章的关键词是「原生」。浏览器已经把折叠、模态、浮层、模板与组件封装好, 我们要做的是理解它们各自的语义边界,然后在合适的场景使用合适的元素。

  • summary 是 details 的第一个子元素,且只写一个。
  • 折叠面板优先用 details,互斥展开优先用 name,而不是手写脚本。
  • 模态用 showModal(),关闭后读取 returnValue,不要用 CSS 强行显示。
  • 轻量浮层用 popover,必须完成的任务留给 dialog。
  • 模板先 cloneNode(true) 再插入,不直接搬 content。
  • 自定义元素名带连字符,构造函数里只建结构,数据在生命周期回调里处理。
  • data-* 只存字符串;tabindex 不用正数;模态背景用 inert。
  • 时间、测量、进度、计算结果各自使用对应元素,别让 div 包办一切。
  • 新特性都准备降级形态,并在真实浏览器里用键盘走一遍。
  • 用 details 隐藏敏感信息——它只是不显示,源码里仍然存在。
  • 给 dialog 写 display: block 当弹窗——模态能力会消失。
  • 用 popover 承载注册、支付这类必须完成的流程。
  • 在 template 里期待脚本自动执行——克隆并插入之后才会执行。
  • 把页面主要内容全部塞进 Shadow DOM,再指望搜索引擎与全局样式正常工作。

三个小练习

  1. 用 details 与 name 做一个三条目的常见问题,再用 CSS 把默认箭头换成加号。
  2. 用 dialog 与 form method="dialog" 做一个「删除确认」,分别处理保存与取消。
  3. 用 template 与 customElements.define 把一张卡片封装成带插槽的组件。
下一步

原生交互讲完,接下来看另一个维度:图片、音视频、iframe 与嵌入内容——它们让页面真正有声有色,也带来性能与可访问性的新问题。