">文档：<amp-accordion> - amp.dev - AMP 框架
AMP
EN
Deutsch Français العربية Español Italiano Indonesia 日本語 한국어 Português Русский Türkçe 中文 Polski Tiếng việt

amp-accordion

实验性
Bento

描述

一个堆叠的标题列表，通过用户交互折叠或展开内容部分。

 

必需脚本

<script async custom-element="amp-accordion" src="https://cdn.ampproject.org/v0/amp-accordion-1.0.js"></script>

支持的布局

为观众提供浏览内容大纲并跳转到任意部分的方法。这对于移动设备非常有用，即使是部分中的几个句子也需要滚动。

用法

amp-accordion 组件允许您显示可折叠和可展开的内容部分。此组件为观众提供浏览内容大纲并跳转到任意部分的方法。有效使用可减少移动设备上的滚动需求。

示例

以下示例包含一个带有三个部分的 amp-accordion。第三部分上的 expanded 属性可在页面加载时展开该部分。

 
<amp-accordion id="my-accordion" disable-session-states>
  <section>
    <h2>Section 1</h2>
    <p>Content in section 1.</p>
  </section>
  <section>
    <h2>Section 2</h2>
    <div>Content in section 2.</div>
  </section>
  <section expanded>
    <h2>Section 3</h2>
    <amp-img src="/static/inline-examples/images/squirrel.jpg"
      width="320"
      height="256"></amp-img>
  </section>
</amp-accordion>
在游乐场打开此代码段

在有效的 AMP 文档外部独立使用

Bento 允许您在非 AMP 页面中使用 AMP 组件，而无需完全符合 AMP 规范。您可以获取这些组件，并将它们放置在不支持 AMP 的框架和 CMS 的实现中。在我们的指南 在非 AMP 页面中使用 AMP 组件 中阅读更多内容。

要查找 amp-accordion 的独立版本，请参阅 bento-accordion。

属性

animate

在 <amp-accordion> 中包含 animate 属性，以便在展开内容时添加“向下滚动”动画，在折叠时添加“向上滚动”动画。

此属性可根据 媒体查询 进行配置。

 
<amp-accordion animate>
  <section>
    <h2>Section 1</h2>
    <p>Content in section 1.</p>
  </section>
  <section>
    <h2>Section 2</h2>
    <div>Content in section 2.</div>
  </section>
  <section>
    <h2>Section 3</h2>
    <amp-img
      src="/static/inline-examples/images/squirrel.jpg"
      width="320"
      height="256"
    ></amp-img>
  </section>
</amp-accordion>
在游乐场打开此代码段

expanded

将 expanded 属性应用于嵌套的 <section>，以便在页面加载时展开该部分。

使用 amp-bind 将 [expanded] 属性绑定到以编程方式展开或折叠 <section> 元素。如果表达式评估为 false，则展开的部分会折叠。如果表达式评估为除 false 之外的任何内容，则折叠的部分会展开。

 
<amp-accordion>
  <section
    [expanded]="sectionOne"
    on="expand:AMP.setState({sectionOne: true});collapse:AMP.setState({sectionOne: false})"
  >
    <h2>Section 1</h2>
    <p>Bunch of awesome content</p>
  </section>
  <section>
    <h2>Section 2</h2>
    <div>Bunch of awesome content</div>
  </section>
  <section expanded>
    <h2>Section 3</h2>
    <div>Bunch of awesome content</div>
  </section>
</amp-accordion>
<button on="tap:AMP.setState({sectionOne: true})">Expand section 1</button>
<button on="tap:AMP.setState({sectionOne: false})">Collapse section 1</button>
在游乐场打开此代码段

expand-single-section

通过将 expand-single-section 属性应用于 <amp-accordion> 元素，一次只允许展开一个部分。这意味着，如果用户点击折叠的 <section>，它会展开并折叠其他已展开的 <section>。

 
<amp-accordion expand-single-section>
  <section>
    <h2>Section 1</h2>
    <p>Content in section 1.</p>
  </section>
  <section>
    <h2>Section 2</h2>
    <div>Content in section 2.</div>
  </section>
  <section>
    <h2>Section 3</h2>
    <amp-img
      src="/static/inline-examples/images/squirrel.jpg"
      width="320"
      height="256"
    ></amp-img>
  </section>
</amp-accordion>
在游乐场打开此代码段

样式

amp-accordion 元素选择器根据您的规范对 amp-accordion 进行样式设置。以下示例将背景颜色更改为绿色

amp-accordion {
  background-color: green;
}

对 amp-accordion 进行样式设置时，请记住以下几点

  • amp-accordion 元素始终为 display: block。
  • float 无法对 <section>、标题或内容元素进行样式设置。
  • 展开的部分将 expanded 属性应用于 <section> 元素。
  • 内容元素使用 overflow: hidden 进行清除修复，因此无法有滚动条。
  • <amp-accordion>、<section>、标题和内容元素的边距设置为 0，但可以在自定义样式中覆盖。
  • 标题和内容元素都是 position: relative。

辅助功能

amp-accordion 自动添加以下 ARIA 属性

  • aria-controls：应用于每个 amp-accordion 部分的标题元素。
  • aria-expanded (state)：应用于每个 amp-accordion 部分的标题元素。
  • aria-labelledby：应用于每个 amp-accordion 部分的内容元素。

amp-accordion 还自动添加以下辅助功能属性

  • tabindex：应用于每个 amp-accordion 部分的标题元素。
  • role=button：应用于每个 amp-accordion 部分的标题元素。
  • role=region：应用于每个 amp-accordion 部分的内容元素。

版本说明

amp-accordion 的实验性 1.0 版本不支持会话状态。它表现得好像总是应用了 disable-session-states 属性一样。

版本 0.1 和 1.0 与 amp-bind 兼容，但一些绑定语法不同。您可以在版本 1.0 中直接使用 expanded 属性进行绑定。版本 1.0 中不支持 data-expand 绑定。有关详细信息，请参见 expanded 属性。

需要更多帮助？

您已经阅读了本文档十几次，但它并没有真正涵盖您所有的问题？也许其他人也有同感：在 Stack Overflow 上联系他们。

转到 Stack Overflow
发现了一个错误或缺少功能？

AMP 项目强烈鼓励您参与和贡献！我们希望您成为我们开源社区的持续参与者，但我们也欢迎针对您特别热衷的问题进行一次性贡献。

转到 GitHub