HTML details 标签使用说明

一、快速了解 details

有些同学可能从来没有用过details这个标签，这里简单介绍一下。

details通常和summary配合使用，天然支持展开收起的效果。例如

html

<details>
  <summary>System Requirements</summary>
  <p>
    Requires a computer running an operating system. The computer must have some
    memory and ideally some kind of long-term storage. An input device as well
    as some form of output device is recommended.
  </p>
</details>

效果如下

虽然有些难看，但都是可以通过 CSS 自定义的。

如果想去除这个“黑色三角”，这个“黑色三角”其实是 ::marker生成的，，而这个 ::marker是通过list-style生成，所以要去除可以这样

css

summary {
  list-style: none;
}
/*或者*/
summary {
  display: flex; /*默认是list-style*/
}

还支持嵌套，进一步美化可以实现树形结构目录

有兴趣的可以回顾一下之前这篇文章：

CSS 实现树状结构目录

以后碰到类似的交互就直接用这个标签吧，别用JS了

二、新增的 name 属性

和大多数表单元素一样，这个name也是可以直接设置和获取的

details.name; // 获取
details.name = 'xxx'; // 设置

除此之外，还支持了“手风琴”模式。所谓“手风琴”模式，相信大家都有所耳闻，就是多个折叠面板，打开其中一个会关闭其他的，比如下方是ant design中的手风琴效果

现在如果用details就可以很轻易的实现这个效果，结构如下

html

<div class="con">
  <details>
    <summary>欢迎</summary>
    <p>最近 details元素新增了一个name属性</p>
  </details>
  <details>
    <summary>关注</summary>
    <p>
      别看这只是一个普普通通的属性，这可是带来了一个全新的模式，一起了解一下吧
    </p>
  </details>
  <details>
    <summary>前端</summary>
    <p>details通常和summary配合使用，天然支持展开收起的效果</p>
  </details>
  <details>
    <summary>侦探</summary>
    <p>虽然有些难看，但都是可以通过 CSS 自定义的</p>
  </details>
</div>

效果如下

嗯，有点丑...我们美化一下

css

.con {
  width: 300px;
  border-radius: 8px;
  border: 1px solid #9747ff;
  background-color: #fdf0ca;
  overflow: hidden;
}
summary {
  display: flex;
  align-items: center;
  line-height: 2;
  padding: 0 10px;
  cursor: pointer;
  border-bottom: 1px solid #9747ff;
  background-color: #ffe8a3;
}
summary::before {
  content: "";
  width: 20px;
  height: 20px;
  background: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 448 512'%3E %3Cpath d='M207.029 381.476L12.686 187.132c-9.373-9.373-9.373-24.569 0-33.941l22.667-22.667c9.357-9.357 24.522-9.375 33.901-.04L224 284.505l154.745-154.021c9.379-9.335 24.544-9.317 33.901.04l22.667 22.667c9.373 9.373 9.373 24.569 0 33.941L240.971 381.476c-9.373 9.372-24.569 9.372-33.942 0z'%3E%3C/path%3E %3C/svg%3E")
    center/50% no-repeat;
  opacity: 0.6;
  transform: rotate(-90deg);
}
details[open] summary::before {
  transform: rotate(0deg);
}
p {
  margin: 0;
  padding: 5px 10px;
  border-bottom: 1px solid #9747ff;
}
details:last-child p,
details:last-child:not([open]) summary {
  border: 0;
}

效果如下

不过现在每个折叠面板是互相独立的，都可以打开或者关闭。

现在我们想要把这几个面板关联起来，就像单选框一样，用相同的name表示

html

<div class="con">
  <details name="a">
    <summary>欢迎</summary>
    <p>最近 details元素新增了一个name属性</p>
  </details>
  <details name="a">
    <summary>关注</summary>
    <p>
      别看这只是一个普普通通的属性，这可是带来了一个全新的模式，一起了解一下吧
    </p>
  </details>
  <details name="a">
    <summary>前端</summary>
    <p>details通常和summary配合使用，天然支持展开收起的效果</p>
  </details>
  <details name="a">
    <summary>侦探</summary>
    <p>虽然有些难看，但都是可以通过 CSS 自定义的</p>
  </details>
</div>

这样就是实现了手风琴的效果了

是不是非常简单呢？

三、还是需要 polyfill 一下

虽然好用，但是兼容性还不行，需要用一段 JS 来兜个底。

首先我们需要判断一下，也就是检测details到底支不支持name这个特性，这个很简单，我们只需要创建一个details元素，然后看这个属性是否存在就行了，如下

'name' in document.createElement('details');

效果如下

对于不支持的浏览器，我们就需要通过监听打开关闭状态了，直接监听click事件

details元素其实还有一个toggle事件，也可以用于监听，但是在这里不太合适，因为toggle是在状态改变后才触发，有点晚了，会造成闪烁的问题

我们需要监听所有的details元素，然后根据name属性，把其他相同name的都关闭，具体实现如下

if (!('name' in document.createElement('details'))) {
  const details = [...document.querySelectorAll('details')]
  details.forEach(el => {
    el.addEventListener('click', () => {
      if (!el.open) {
        details.filter(d => d.getAttribute('name') === el.getAttribute('name') && d!==el && d.open).forEach(m => {
          m.open = false
        })
      }
    })
  })
}

我们现在来看Firefox的效果

同样支持多个分组，每个分组设置相同的name就行

完整代码可以访问以下链接：

details with name (codepen.io)

四、总结一下

总的来说是一个不痛不痒的新特性，你学到了，下面总结一下

details通常和summary配合使用，天然支持展开收起的效果
summary前面的黑色三角形是::marker渲染的，可以通过设置list-style: none去除
新增的name属性可以直接通过dom.name的方式设置和获取
多个details元素添加name属性后会变成手风琴模式，即打开其中一个会关闭其他
目前兼容性还不行，需要polyfill一下
可以通过'name' in document.createElement('details')来检测是否支持该特性

HTML details 标签使用说明

一、快速了解 details ​

二、新增的 name 属性 ​

三、还是需要 polyfill 一下 ​

四、总结一下 ​

一、快速了解 details

二、新增的 name 属性

三、还是需要 polyfill 一下

四、总结一下