HTML详情标签使用教程:details和summary详解
时间:2025-09-04 12:20:46 393浏览 收藏
一分耕耘,一分收获!既然打开了这篇文章《details和summary标签是HTML中用于创建可折叠内容的语义化标签,常用于实现“点击展开/收起”效果。以下是它们的基本用法和实现方式:一、基本语法 这里是折叠的内容。 这是默认展开的内容。标题
标签定义折叠面板的标题,用户点击后会切换内容的显示与隐藏。二、默认行为默认情况下,
可以切换状态。如果希望默认展开内容,可以添加 open 属性:
默认展开的标题
是浏览器原生组件,但可以通过 CSS 自定义样式:details {
border: 1px solid #ccc;
padding: 10px;
margin-bottom: 10px;
}
summary {
font-weight: bold;
cursor: pointer;
}注意:某些浏览器对
使用 标签可原生实现内容折叠与展开,无需JavaScript;2.
为标题且必须是

用和标签就能轻松实现网页内容的折叠与展开。简单来说,是一个容器,用来包裹所有你想隐藏或显示的内容;而则是这个容器的“标题”,用户点击它就能控制容器内其他内容的显示隐藏。这是HTML5原生提供的一个非常方便的功能,省去了我们写JavaScript的麻烦。

解决方案
说起来,这俩标签真是HTML5里一个挺实用的“小发明”。我第一次看到它,就觉得,哎,这不就是我们以前用JavaScript吭哧吭哧写出来的那个折叠效果嘛,现在直接原生支持了,省心多了。
具体怎么用呢?你把需要折叠的内容,比如一大段文字、一个图片列表,甚至是一个表单,都放进标签里。而那个你希望用户点击来触发折叠的标题,就放到标签里,这个标签必须是的第一个子元素。

举个例子,假设你想把一个常见问题解答(FAQ)的答案隐藏起来,只显示问题,用户点击问题才显示答案:
<details>
<summary>这是第一个问题:如何开始使用这个功能?</summary>
<p>答案在这里:您只需要点击页面上的“注册”按钮,然后按照提示填写信息即可。</p>
<ul>
<li>步骤一:注册账号</li>
<li>步骤二:登录系统</li>
<li>步骤三:开始探索</li>
</ul>
</details>
<details>
<summary>第二个问题:支持哪些支付方式?</summary>
<p>我们目前支持微信支付、支付宝和银行卡转账。</p>
</details>是不是很简单?默认情况下,里面的内容是折叠的,只显示。如果你想让它默认就是展开的,可以给标签加一个open属性:

<details open> <summary>这个部分默认是展开的哦</summary> <p>因为我加了'open'属性。</p> </details>
就这么简单,没有复杂的CSS,也没有一行JavaScript。这对于那些需要快速实现交互,又不想引入太多JS的场景来说,简直是福音。当然,如果你需要更复杂的动画或者状态控制,JS还是少不了的,但这俩标签提供了一个非常好的起点。
如何自定义和标签的样式?
虽然原生和已经很方便了,但它默认的样式可能有点朴素,甚至在不同浏览器里长得还不太一样。比如那个小箭头,有的浏览器是三角形,有的是小加号。如果你对UI有要求,那肯定得自己动手美化一下。
自定义样式主要围绕这两个标签本身以及它们内部的元素。最常见的需求就是改变那个默认的展开/折叠指示符。这个指示符其实是由summary元素的::marker伪元素控制的。
你可以这样把它干掉:
summary::-webkit-details-marker {
display: none; /* 针对WebKit内核浏览器,如Chrome, Safari */
}
summary::marker {
display: none; /* 标准写法,针对Firefox等 */
}把默认的marker去掉后,你就可以用CSS的::before或::after伪元素来创建自己的指示符了,比如一个加号和减号:
summary {
list-style: none; /* 移除默认列表样式,某些浏览器可能需要 */
cursor: pointer; /* 提示用户可点击 */
position: relative;
padding-left: 20px; /* 为自定义指示符留出空间 */
}
summary::before {
content: '+'; /* 默认显示加号 */
position: absolute;
left: 0;
font-weight: bold;
transition: transform 0.2s ease;
}
details[open] summary::before {
content: '-'; /* 展开时显示减号 */
transform: rotate(0deg); /* 确保形状不变,只是内容变了 */
}
/* 还可以给summary添加hover效果,或者改变文字颜色等等 */
summary:hover {
color: #007bff;
}当然,你也可以直接给和添加背景色、边框、内边距等等,就像对待其他HTML元素一样。记住,是块级元素,可以设置宽度、高度、内外边距等。有时候,为了确保布局不乱,给加个display: block;或者width: 100%;也是个好习惯。我个人就遇到过一些奇怪的布局问题,最后发现是默认的display属性在捣鬼。
使用和标签时需要注意哪些无障碍性问题?
无障碍性(Accessibility)在网页设计中是个挺重要的考量,尤其对于折叠内容这种交互元素。好在和标签在原生层面就提供了不错的无障碍支持。
首先,它们自带了键盘导航功能。用户可以通过Tab键聚焦到上,然后按Enter键或空格键就能展开/折叠内容。这对于不方便使用鼠标的用户来说,是个非常友好的特性。
其次,屏幕阅读器也能很好地识别这两个标签。当焦点在上时,屏幕阅读器会告诉用户这是一个可点击的“摘要”或“标题”,并且会告知其当前的展开/折叠状态(比如“已折叠”或“已展开”)。这是因为浏览器会自动为它们添加role="group"和aria-expanded等ARIA属性。
不过,如果你自定义了指示符(比如上面说的用::before伪元素),或者用JavaScript控制了展开/折叠,那么就得格外小心了。
如果你移除了原生的::marker,确保你自定义的指示符视觉上足够清晰,能明确告诉用户这是个可点击的元素,并且能反映出当前的状态。虽然屏幕阅读器依然能读出状态,但视觉上的提示对所有用户都很重要。
更深一层,如果你的折叠内容里面有复杂的交互元素,比如表单字段、按钮,确保这些元素在折叠状态下不会被无意中聚焦到。通常情况下,浏览器会处理好这一点,但如果通过JS动态插入或移除内容,就要检查一下tabindex和aria-hidden属性是否正确设置了。
我通常会建议,如果只是简单的FAQ或者内容隐藏,直接用原生和就好,无障碍性方面省心。但如果涉及复杂的动态内容加载或者状态管理,JavaScript的介入就需要我们手动去维护好ARIA属性,确保屏幕阅读器能正确理解页面的状态变化。
如何结合JavaScript增强和标签的功能?
虽然和原生功能很强大,但总有些时候,我们希望它能做更多,比如:
- 在内容展开时播放一个动画。
- 在内容展开时异步加载数据。
- 记录用户的展开偏好,下次访问时保持状态。
- 实现“手风琴”效果(Accordion),即展开一个,其他自动折叠。
这时候,JavaScript就派上用场了。标签有一个toggle事件,当内容展开或折叠时都会触发。我们可以监听这个事件来执行自定义逻辑。
const detailsElements = document.querySelectorAll('details');
detailsElements.forEach(details => {
details.addEventListener('toggle', () => {
if (details.open) {
// 内容展开了
console.log('内容已展开:', details.querySelector('summary').textContent);
// 可以在这里添加展开动画类,或者加载数据
// details.classList.add('is-open');
// loadContent(details); // 假设有个函数用来加载内容
} else {
// 内容折叠了
console.log('内容已折叠:', details.querySelector('summary').textContent);
// details.classList.remove('is-open');
}
});
});实现手风琴效果也是一个常见需求。基本思路是,当一个被打开时,遍历所有其他的,如果它们是打开状态,就把它关闭。
const detailsGroups = document.querySelectorAll('.accordion-group details'); // 假设你的手风琴都在一个特定类名下
detailsGroups.forEach(currentDetails => {
currentDetails.addEventListener('toggle', () => {
if (currentDetails.open) {
detailsGroups.forEach(otherDetails => {
if (otherDetails !== currentDetails && otherDetails.open) {
otherDetails.open = false; // 关闭其他已展开的details
}
});
}
});
});这个手风琴的实现方式,我个人觉得比以前用jQuery或者纯JS写一大堆slideToggle之类的要清晰多了,因为它利用了原生的open属性。
当然,结合JS也意味着你要更关注性能。比如,如果展开时需要加载大量数据,考虑使用节流(throttle)或防抖(debounce),或者添加加载指示器,避免UI卡顿。毕竟,用户体验才是王道。
终于介绍完啦!小伙伴们,这篇关于《HTML详情标签使用教程:details和summary详解》的介绍应该让你收获多多了吧!欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识,快来关注吧!
-
502 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
274 收藏
-
232 收藏
-
339 收藏
-
359 收藏
-
342 收藏
-
385 收藏
-
192 收藏
-
360 收藏
-
149 收藏
-
477 收藏
-
313 收藏
-
169 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习