HTML5折叠标签使用教程:details和summary详解
HTML5的``标签无需JavaScript即可轻松实现网页内容的折叠与展开效果,极大地简化了开发流程,提升用户体验。本文深入解析了这两个标签的核心用法,包括`
`定义标题,以及`open`属性控制默认展开状态。同时,探讨了其在FAQ列表、高级设置、法律条款收纳等多种应用场景下的实用价值。此外,文章还介绍了如何通过CSS自定义样式,例如移除默认箭头、添加图标动画等,以及利用JavaScript监听`toggle`事件实现更复杂的交互。最后,着重强调了`
`标签的浏览器兼容性、无障碍支持和SEO友好性,为开发者提供全面的使用指南,助力构建更简洁、更易用的网页界面。
HTML5的标签能实现原生折叠内容功能。1. 核心用法是将隐藏内容包裹在
里;2. 应用场景包括FAQ列表、高级设置折叠、法律条款收纳、教程补充说明等;3. 可通过CSS自定义样式,如移除默认箭头、添加图标及动画,并用JavaScript监听toggle事件实现复杂交互;4. 兼容主流浏览器,但需注意老旧浏览器支持问题,同时它们具备良好无障碍支持和SEO友好性。

HTML5的和标签,它们就像是网页上的一个“小抽屉”,你点击一下,内容就展开了;再点一下,内容就收起来了。它们是原生的可折叠内容组件,不需要JavaScript就能实现基本的交互效果,非常方便。

解决方案
要实现折叠内容,核心就是将你需要隐藏或显示的内容包裹在标签里,而作为“抽屉把手”的标题则放在标签里,必须是的第一个子元素。
一个最简单的例子是这样的:

<details>
<summary>点我查看更多信息</summary>
<p>这里是隐藏起来的内容,只有点击了上面的标题才会显示出来。你可以放文字、图片,甚至其他HTML元素。</p>
<ul>
<li>列表项1</li>
<li>列表项2</li>
</ul>
</details>
<details open>
<summary>这个抽屉默认是打开的</summary>
<p>通过在`details`标签上添加`open`属性,可以控制它在页面加载时就是展开状态。</p>
</details>你看,就这么几行代码,一个可交互的折叠区域就出来了。浏览器会很聪明地给前面加一个小箭头或三角形,指示它是一个可点击的开关。我觉得这真的是HTML5带来的一个很实用的进步,省去了我们写一堆JS来模拟这种效果的麻烦。
在实际开发中,和标签有哪些应用场景?
在我看来,和标签的用武之地非常广,而且很多时候它们能大大简化我们的开发工作。最直观的,就是FAQ(常见问题解答)列表。你不需要为每个问题单独写JS来控制展开收起,直接用这套标签,结构清晰,维护起来也方便。用户点击问题,答案就出来了,再点就收回去,体验非常流畅。

再比如,在一些表单里,需要显示一些不常用的高级选项或者说明。你可以把这些内容放在里,标题写成“高级设置”或者“详细说明”,这样既不占用页面空间,又能让需要这些信息的用户轻松找到。我之前做过一个复杂的配置页面,用这个就让界面清爽了不少。
还有,一些冗长的法律条款、隐私政策或者用户协议,如果全部铺开会显得页面很长很压抑。用把不那么核心的条款折叠起来,只展示标题,用户可以根据需要展开阅读,这无疑提升了用户的阅读体验,也让页面布局更合理。甚至在文章或者教程中,对一些补充说明、代码示例或者引用内容,也可以考虑用它来组织,让主线内容更聚焦,细节部分按需展开。
它也为无障碍性提供了很好的原生支持,屏幕阅读器能够很好地识别和朗读这些折叠内容的状态,我觉得这比我们自己写JS实现的折叠组件在无障碍方面要省心得多。
如何自定义和的样式和行为?
虽然和提供了原生的交互,但默认的样式可能不符合你的设计需求。这时候,CSS就派上用场了。
要自定义样式,最常见的就是那个小箭头。默认的箭头样式在不同浏览器里可能有些差异,而且很多时候我们想用自己的图标。你可以通过设置summary元素的list-style: none;来移除默认的箭头,然后利用::before或::after伪元素来添加自定义的图标或者动画效果。
details summary {
list-style: none; /* 移除默认的箭头 */
cursor: pointer;
padding: 10px;
background-color: #f0f0f0;
border-bottom: 1px solid #ccc;
position: relative; /* 为伪元素定位 */
}
details summary::before {
content: '+'; /* 默认显示加号 */
position: absolute;
right: 10px;
font-size: 1.2em;
transition: transform 0.3s ease;
}
details[open] summary::before {
content: '-'; /* 打开时显示减号 */
transform: rotate(0deg); /* 也可以是旋转效果 */
}
/* 当details打开时,可以给summary或者内部内容添加样式 */
details[open] summary {
background-color: #e0e0e0;
}
details[open] p {
padding: 10px;
border: 1px solid #eee;
border-top: none;
}通过details[open]这个属性选择器,你可以针对内容展开时的状态进行样式调整,比如改变背景色,或者让展开的内容有一个特定的边框。
至于行为,虽然它们原生支持折叠,但如果你需要更复杂的联动,比如点击一个,其他的自动关闭,或者在展开/收起时触发其他动画,那就需要引入JavaScript了。你可以监听details元素的toggle事件,这个事件在内容展开或收起时都会触发。
document.querySelectorAll('details').forEach(detail => {
detail.addEventListener('toggle', () => {
if (detail.open) {
console.log('这个details现在是打开的!');
// 可以在这里添加动画类名,或者关闭其他details
} else {
console.log('这个details现在是关闭的!');
}
});
});我觉得,这种原生与JS结合的方式,既利用了HTML的语义化和原生能力,又保留了我们对复杂交互的控制力,是一个很不错的平衡点。
使用和时需要注意哪些兼容性或无障碍性问题?
在使用和时,有一些点是值得我们留意的,这关乎用户体验和网站的健壮性。
首先是浏览器兼容性。目前主流的现代浏览器对这两个标签的支持都非常好,包括Chrome、Firefox、Safari、Edge等。所以,在大多数情况下,你不用太担心它们无法工作。但如果你需要支持一些非常老的浏览器版本(比如IE11或更早),那它们可能就无法正常显示了,需要提供Polyfill或者使用JS/CSS的替代方案。不过,现在这种情况越来越少了,通常我们能放心地使用它们。
其次是无障碍性(Accessibility)。这是我觉得这两个标签最棒的地方之一。它们天生就具有良好的语义,并且浏览器会自动处理键盘导航(Tab键聚焦,空格或回车键切换状态)和屏幕阅读器的支持。屏幕阅读器会正确地告知用户这是一个可展开/折叠的区域,以及它的当前状态。这意味着,我们不需要额外添加ARIA属性来增强其无障碍性,这大大减轻了开发者的负担。当然,前提是你的内容要足够清晰,让用户知道点击它会看到什么。
关于SEO,内容被包裹在标签里,并不会影响搜索引擎对内容的抓取和索引。搜索引擎仍然能够“看到”并理解折叠起来的内容。不过,有观点认为,折叠起来的内容在搜索引擎的权重上可能会略低于直接展示的内容,但这通常不是一个大问题,尤其对于非核心信息而言。
一个小的使用陷阱可能是嵌套。虽然你可以嵌套,但如果层级过多,可能会让用户感到困惑。另外,如果你用JS去完全覆盖了它们的默认行为,比如阻止了toggle事件的默认动作,那么你可能就需要自己去处理键盘交互和无障碍性,这会抵消它们原生带来的便利性。所以在加JS的时候,我通常会倾向于在不破坏原生行为的基础上进行增强,而不是完全重写。
总的来说,和是一对非常实用的HTML5标签,它们提供了一种简单、语义化且无障碍的折叠内容解决方案。在日常开发中,只要合理运用,就能让我们的页面更整洁,用户体验更佳。
好了,本文到此结束,带大家了解了《HTML5折叠标签使用教程:details和summary详解》,希望本文对你有所帮助!关注golang学习网公众号,给大家分享更多文章知识!
span标签是什么意思?详解其作用与用法
- 上一篇
- span标签是什么意思?详解其作用与用法
- 下一篇
- GitMCP开源,GitHub变实时文档中心
-
- 文章 · 前端 | 1分钟前 |
- JavaScript模块依赖分析:export与import作用详解
- 205浏览 收藏
-
- 文章 · 前端 | 3分钟前 |
- jQuery批量打开链接新标签页教程
- 369浏览 收藏
-
- 文章 · 前端 | 8分钟前 | CSS 隐藏 :empty 空元素 :only-child
- CSS空元素隐藏技巧:empty与only-child组合应用
- 176浏览 收藏
-
- 文章 · 前端 | 12分钟前 |
- CSS文件过多怎么优化?合并策略详解
- 349浏览 收藏
-
- 文章 · 前端 | 21分钟前 |
- 纯HTML代码怎么运行【教程】
- 230浏览 收藏
-
- 文章 · 前端 | 25分钟前 |
- HTML代码部署步骤详解
- 193浏览 收藏
-
- 文章 · 前端 | 33分钟前 | html JavaScript 浏览器 页面渲染 DOM树
- HTML运行原理揭秘|网页加载全过程解析
- 232浏览 收藏
-
- 文章 · 前端 | 37分钟前 |
- 前端组件文档搭建指南
- 415浏览 收藏
-
- 文章 · 前端 | 39分钟前 |
- JavaScriptTemporalAPI详解与使用教程
- 282浏览 收藏
-
- 文章 · 前端 | 40分钟前 |
- 前端自动化部署流程全解析
- 208浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- ChatExcel酷表
- ChatExcel酷表是由北京大学团队打造的Excel聊天机器人,用自然语言操控表格,简化数据处理,告别繁琐操作,提升工作效率!适用于学生、上班族及政府人员。
- 3179次使用
-
- Any绘本
- 探索Any绘本(anypicturebook.com/zh),一款开源免费的AI绘本创作工具,基于Google Gemini与Flux AI模型,让您轻松创作个性化绘本。适用于家庭、教育、创作等多种场景,零门槛,高自由度,技术透明,本地可控。
- 3390次使用
-
- 可赞AI
- 可赞AI,AI驱动的办公可视化智能工具,助您轻松实现文本与可视化元素高效转化。无论是智能文档生成、多格式文本解析,还是一键生成专业图表、脑图、知识卡片,可赞AI都能让信息处理更清晰高效。覆盖数据汇报、会议纪要、内容营销等全场景,大幅提升办公效率,降低专业门槛,是您提升工作效率的得力助手。
- 3418次使用
-
- 星月写作
- 星月写作是国内首款聚焦中文网络小说创作的AI辅助工具,解决网文作者从构思到变现的全流程痛点。AI扫榜、专属模板、全链路适配,助力新人快速上手,资深作者效率倍增。
- 4525次使用
-
- MagicLight
- MagicLight.ai是全球首款叙事驱动型AI动画视频创作平台,专注于解决从故事想法到完整动画的全流程痛点。它通过自研AI模型,保障角色、风格、场景高度一致性,让零动画经验者也能高效产出专业级叙事内容。广泛适用于独立创作者、动画工作室、教育机构及企业营销,助您轻松实现创意落地与商业化。
- 3798次使用
-
- JavaScript函数定义及示例详解
- 2025-05-11 502浏览
-
- 优化用户界面体验的秘密武器:CSS开发项目经验大揭秘
- 2023-11-03 501浏览
-
- 使用微信小程序实现图片轮播特效
- 2023-11-21 501浏览
-
- 解析sessionStorage的存储能力与限制
- 2024-01-11 501浏览
-
- 探索冒泡活动对于团队合作的推动力
- 2024-01-13 501浏览

