0

0

details和summary标签怎么用?折叠内容如何实现?

月夜之吻

月夜之吻

发布时间:2025-08-03 08:00:02

|

376人浏览过

|

来源于php中文网

原创

使用 ails> 和

标签可原生实现内容折叠与展开,无需javascript;2. 为标题且必须是
的第一个子元素,默认折叠,添加 open 属性可默认展开;3. 可通过css隐藏默认标记并自定义指示符样式,如用 ::before 实现加号/减号切换;4. 原生支持键盘导航与屏幕阅读器,具备良好无障碍性,但自定义时需确保视觉提示清晰;5. 可通过javascript监听 toggle 事件实现动画、异步加载、状态记忆及手风琴效果,提升交互体验。

details和summary标签怎么用?折叠内容如何实现?

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

details和summary标签怎么用?折叠内容如何实现?

解决方案

说起来,这俩标签真是HTML5里一个挺实用的“小发明”。我第一次看到它,就觉得,哎,这不就是我们以前用JavaScript吭哧吭哧写出来的那个折叠效果嘛,现在直接原生支持了,省心多了。

具体怎么用呢?你把需要折叠的内容,比如一大段文字、一个图片列表,甚至是一个表单,都放进

标签里。而那个你希望用户点击来触发折叠的标题,就放到
标签里,这个
标签必须是
的第一个子元素。

details和summary标签怎么用?折叠内容如何实现?

举个例子,假设你想把一个常见问题解答(FAQ)的答案隐藏起来,只显示问题,用户点击问题才显示答案:

这是第一个问题:如何开始使用这个功能?

答案在这里:您只需要点击页面上的“注册”按钮,然后按照提示填写信息即可。

  • 步骤一:注册账号
  • 步骤二:登录系统
  • 步骤三:开始探索
第二个问题:支持哪些支付方式?

我们目前支持微信支付、支付宝和银行卡转账。

是不是很简单?默认情况下,

里面的内容是折叠的,只显示
。如果你想让它默认就是展开的,可以给
标签加一个
open
属性:

details和summary标签怎么用?折叠内容如何实现?
这个部分默认是展开的哦

因为我加了'open'属性。

就这么简单,没有复杂的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
伪元素来创建自己的指示符了,比如一个加号和减号:

ChatGPT Website Builder
ChatGPT Website Builder

ChatGPT网站生成器,AI对话快速生成网站

下载
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卡顿。毕竟,用户体验才是王道。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
html5动画制作有哪些制作方法
html5动画制作有哪些制作方法

html5动画制作方法有使用CSS3动画、使用JavaScript动画库、使用HTML5 Canvas等。想了解更多html5动画制作方法相关内容,可以阅读本专题下面的文章。

514

2023.10.23

HTML与HTML5的区别
HTML与HTML5的区别

HTML与HTML5的区别:1、html5支持矢量图形,html本身不支持;2、html5中可临时存储数据,html不行;3、html5新增了许多控件;4、html本身不支持音频和视频,html5支持;5、html无法处理不准确的语法,html5能够处理等等。想了解更多HTML与HTML5的相关内容,可以阅读本专题下面的文章。

440

2024.03.06

html5从入门到精通汇总
html5从入门到精通汇总

想系统掌握HTML5开发?本合集精选全网优质学习资源,涵盖免费教程、实战项目、视频课程与权威电子书,从基础语法到高级特性(Canvas、本地存储、响应式布局等)一应俱全,适合零基础小白到进阶开发者,助你高效入门并精通HTML5前端开发。

92

2025.12.30

html5新老标签汇总
html5新老标签汇总

HTML5在2026年持续优化网页语义化与交互体验,不仅引入了如<header>、<nav>、<article>、<section>、<aside>、<footer>等结构化标签,还新增了<video>、<audio>、<canvas>、<figure>、<time>、<mark>等增强多媒体与

125

2025.12.30

html5空格代码怎么写
html5空格代码怎么写

在HTML5中,空格不能直接通过键盘空格键实现,需使用特定代码。本合集详解常用空格写法:&nbsp;(不间断空格)、&ensp;(半个中文空格)、&emsp;(一个中文空格)及CSS的white-space属性等方法,帮助开发者精准控制页面排版,避免因空格失效导致布局错乱,适用于新手入门与实战参考。

79

2025.12.30

html5怎么做网站教程
html5怎么做网站教程

想从零开始学做网站?这份《HTML5怎么做网站教程》合集专为新手打造!涵盖HTML5基础语法、页面结构搭建、表单与多媒体嵌入、响应式布局及与CSS3/JavaScript协同开发等核心内容。无需编程基础,手把手教你用纯HTML5创建美观、兼容、移动端友好的现代网页。附实战案例+代码模板,快速上手,轻松迈出Web开发第一步!

159

2025.12.31

HTML5建模教程
HTML5建模教程

想快速掌握HTML5模板搭建?本合集汇集实用HTML5建模教程,从零基础入门到实战开发全覆盖!内容涵盖响应式布局、语义化标签、Canvas绘图、表单验证及移动端适配等核心技能,提供可直接复用的模板结构与代码示例。无需复杂配置,助你高效构建现代网页,轻松上手前端开发!

31

2025.12.31

html5怎么使用
html5怎么使用

想快速上手HTML5开发?本合集为你整理最实用的HTML5使用指南!涵盖HTML5基础语法、主流框架(如Bootstrap、Vue、React)集成方法,以及无需安装、直接在线编辑运行的平台推荐(如CodePen、JSFiddle)。无论你是新手还是进阶开发者,都能轻松掌握HTML5网页制作、响应式布局与交互功能开发,零配置开启高效前端编程之旅!

46

2025.12.31

C++ 设计模式与软件架构
C++ 设计模式与软件架构

本专题深入讲解 C++ 中的常见设计模式与架构优化,包括单例模式、工厂模式、观察者模式、策略模式、命令模式等,结合实际案例展示如何在 C++ 项目中应用这些模式提升代码可维护性与扩展性。通过案例分析,帮助开发者掌握 如何运用设计模式构建高质量的软件架构,提升系统的灵活性与可扩展性。

14

2026.01.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 0.8万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.1万人学习

CSS教程
CSS教程

共754课时 | 25.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号