大网数据广告活动
Web 标准与前端开发

<summary>:摘要展现元素

· 52CE 我爱测

HTML **`<summary>` 元素** 指定了 details 元素展开盒子的内容的摘要,标题或图例。点击 `<summary>` 元素可以切换父元素 `<details>` 开启和关闭的状态。

HTML <summary> 元素 指定了 details 元素展开盒子的内容的摘要,标题或图例。点击 <summary> 元素可以切换父元素 <details> 开启和关闭的状态。

HTML Demo: <summary>

<details>
  <summary>
    I have keys but no doors. I have space but no room. You can enter but can’t
    leave. What am I?
  </summary>
  A keyboard.
</details>
details {
  border: 1px solid #aaa;
  border-radius: 4px;
  padding: 0.5em 0.5em 0;
}

summary {
  font-weight: bold;
  margin: -0.5em -0.5em 0;
  padding: 0.5em;
}

details[open] {
  padding: 0.5em;
}

details[open] summary {
  border-bottom: 1px solid #aaa;
  margin-bottom: 0.5em;
}

属性

本元素仅包含全局属性。

使用注意

<summary> 元素的内容可以是任意标题内容、纯文本,或是可以在段落内使用的 HTML 代码。

<summary> 元素仅可作为 <details> 元素的第一个子节点。当用户在 <summary> 元素上点击时,父元素 <details> 会切换开启和关闭的状态,并会向 <details> 元素发送 HTMLElement/toggle_event 事件,令用户得知这样的状态改变何时发生。

默认标签文字

如果一个 <details> 元素的第一个子节点不是 <summary> 元素,user agent会使用一个默认字符串(通常为“详细信息”或“详情”)作为展开盒子的标签内容。

默认样式

根据 HTML 规范,<summary> 元素的默认样式包括 display: list-item。这使得改变或移除显示为标签旁边的展现部件的图标成为可能,默认的图标通常是一个三角形。

你也可以将样式改变为 display: block 来移除展开三角形。

参见浏览器兼容性以了解其中的细节,因为并不是所有浏览器支持这个元素的全部功能。

对于基于 Webkit 的浏览器,例如 Safari,可以通过非标准的 CSS 伪元素 ::-webkit-details-marker 来控制图标显示。要删除展开三角形,请使用 summary::-webkit-details-marker { display: none }。

示例

下面有一些 <summary> 元素的用法示例。你可以在 details 元素的文档中找到更多示例。

基本示例

一个简单的例子显示了在 details 元素中如何使用 <summary>:

<details open>
  <summary>概况</summary>
  <ol>
    <li>手上的现钱:$500.00</li>
    <li>当前发票:$75.30</li>
    <li>到期日:5/6/19</li>
  </ol>
</details>

结果

基本示例

使用标题元素作为总结

你可以在 <summary> 元素中像这样使用标题元素:

<details open>
  <summary><h4>概况</h4></summary>
  <ol>
    <li>手上的现钱:$500.00</li>
    <li>当前发票:$75.30</li>
    <li>到期日:5/6/19</li>
  </ol>
</details>

结果

使用标题元素作为总结

目前这有一些间距问题,可以用 CSS 解决。

[!WARNING] 因为 <summary> 元素的默认角色是 button(它将所有角色从子元素中剥离),这个例子对于使用辅助技术的用户来说是不可行的,例如屏幕阅读器。<h4> 的角色将被删除,因此对这些用户来说,不会被视为标题。

summary 元素中的 HTML

这个示例给 <summary> 元素增加了一些语义,以表明标签的重要性:

<details open>
  <summary><strong>概况</strong></summary>
  <ol>
    <li>手上的现钱:$500.00</li>
    <li>当前发票:$75.30</li>
    <li>到期日:5/6/19</li>
  </ol>
</details>

结果

summary_元素中的_HTML

技术概要

<table class="properties"> <tbody> <tr> <th scope="row">允许的内容</th> <td> <a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#短语内容" >短语内容</a >,或<a href="/zh-CN/docs/Web/HTML/Guides/Content_categories#标题内容" >标题内容</a >元素之一 </td> </tr> <tr> <th scope="row">标签省略</th> <td>否,开始和结束标签都不能省略</td> </tr> <tr> <th scope="row">允许的父元素</th> <td>details 元素</td> </tr> <tr> <th scope="row">隐式 ARIA 角色</th> <td> <code ><a href="/zh-CN/docs/Web/Accessibility/ARIA/Reference/Roles/button_role" >button</a ></code > </td> </tr> <tr> <th scope="row">允许的 ARIA 角色</th> <td>没有允许的 <code>role</code></td> </tr> <tr> <th scope="row">DOM 接口</th> <td>HTMLElement</td> </tr> </tbody> </table>

规范

浏览器兼容性

参见

  • details

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。