<summary>:摘要展现元素

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

* Some parts of this feature may have varying levels of support.

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

尝试一下

属性

本元素仅包含全局属性

使用注意

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

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

默认标签文字

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

默认样式

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

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

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

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

示例

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

基本示例

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

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

结果

使用标题元素作为总结

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

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

结果

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

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

summary 元素中的 HTML

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

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

结果

技术概要

允许的内容 短语内容,或标题内容元素之一
标签省略 否,开始和结束标签都不能省略
允许的父元素 <details> 元素
隐式 ARIA 角色 button
允许的 ARIA 角色 没有允许的 role
DOM 接口 HTMLElement

规范

Specification
HTML
# the-summary-element

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
summary
display: list-item

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

参见