第五章 · 进阶
现代 HTML 进阶:让浏览器替你写交互
过去需要一整个组件库才能完成的折叠、弹窗、浮层与自定义组件,如今大多写进了 HTML 规范。 这一章从 details 讲到 Web Components,把「原生优先」这四个字拆成可以上手的代码。 每一个例子都能直接运行,也能在没有框架的项目里落地。
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,
否则纸上只剩标题。
<details>
<summary>为什么要用原生折叠?</summary>
<p>因为键盘操作、焦点与屏幕阅读器播报,浏览器都已经处理好了。</p>
</details>
<details open>
<summary>默认展开的写法</summary>
<p>加上 open 布尔属性即可,不需要写 open="true"。</p>
</details>
点我展开:这一段没有任何脚本
用 Tab 键聚焦标题,再按空格或回车,展开与收起同样有效。
读屏软件会播报当前是「已展开」还是「已折叠」。
<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 起支持,更旧的版本需要降级成页内区块。
<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>
<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 的浏览器不会隐藏元素,内容会直接出现在页面上。 如果这段内容必须隐藏,要么用脚本检测后手动隐藏,要么把它写成「直接可见也不影响理解」的降级形态。
<button popovertarget="tip">查看提示</button>
<div id="tip" popover>
<p>这是一个 popover:点空白处或按 Esc 就会关闭。</p>
</div>
<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-*。另外,模板内容不参与页面渲染,也不会被屏幕阅读器读到,
用克隆之后记得给新节点补上必要的语义。
<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>
<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() 注册一个带连字符的标签名,浏览器从此认识它,并像内置元素一样解析、升级与派发生命周期回调。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 关键内容时不要全塞进影子树。
<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>
<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 顺序。
<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>
<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>
<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(空格分隔),
它不会自动计算,需要脚本把结果写进去。
<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>
<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 或提交给服务端,并在页面加载时回填控件。
<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,再考虑脚本」的原因。
<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>
<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,再指望搜索引擎与全局样式正常工作。
三个小练习
- 用
details与name做一个三条目的常见问题,再用 CSS 把默认箭头换成加号。 - 用
dialog与form method="dialog"做一个「删除确认」,分别处理保存与取消。 - 用
template与customElements.define把一张卡片封装成带插槽的组件。
原生交互讲完,接下来看另一个维度:图片、音视频、iframe 与嵌入内容——它们让页面真正有声有色,也带来性能与可访问性的新问题。