跳转到内容

🎉 Material UI v5 is out! Head to the migration guide to get started.

Accordion 扩展面板

扩展面板包含了流程的创建和元素的轻量编辑。

扩展面板 是一个轻量级容器,既可以单独使用,也可以和卡片这样更大的平面相结合。

注意: 此版本的扩展面板将不再记录在 Material Design 指南中,但 Material-UI 将继续支持它。 您可能属性它之前的名字为 "expansion panel"。

简单的扩展面板

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse malesuada lacus ex, sit amet blandit leo lobortis eget.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse malesuada lacus ex, sit amet blandit leo lobortis eget.

可控制的折叠面板

使用控制面板 组件,能够扩展已有的控制面板行为,来创建自定义的扩展面板组。

Nulla facilisi. Phasellus sollicitudin nulla et quam mattis feugiat. Aliquam eget maximus est, id dignissim quam.

Donec placerat, lectus sed mattis semper, neque lectus feugiat lectus, varius pulvinar diam eros in elit. Pellentesque convallis laoreet laoreet.

Nunc vitae orci ultricies, auctor nunc in, volutpat nisl. Integer sit amet egestas eros, vitae egestas augue. Duis vel est augue.

Nunc vitae orci ultricies, auctor nunc in, volutpat nisl. Integer sit amet egestas eros, vitae egestas augue. Duis vel est augue.

自定义扩展面板

以下是自定义组件的一个示例。 您可以在 重写文档页 中了解有关此内容的更多信息。

Collapsible Group Item #1

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse malesuada lacus ex, sit amet blandit leo lobortis eget. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse malesuada lacus ex, sit amet blandit leo lobortis eget.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse malesuada lacus ex, sit amet blandit leo lobortis eget. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse malesuada lacus ex, sit amet blandit leo lobortis eget.

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse malesuada lacus ex, sit amet blandit leo lobortis eget. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse malesuada lacus ex, sit amet blandit leo lobortis eget.

其他操作

当你把 Checkbox 或者一个按钮这样的操作事件放进 AccordionSummary,当在打开和收缩控制面板时使用这个操作,你则需要阻止 focus 和 click 事件的传播(propagation)。 您还应该为该操作提供一个 aria-label 标签,否则嵌套操作的标签将包含在控制扩展面板的父按钮的标签中。

The click event of the nested action will propagate up and expand the accordion unless you explicitly stop it.

The focus event of the nested action will propagate up and also focus the accordion unless you explicitly stop it.

If you forget to put an aria-label on the nested action, the label of the action will also be included in the label of the parent button that controls the accordion expansion.

性能

即使扩展面板没有展开,默认情况下扩展面板的内容也会挂载。 这样的默认情况是是考虑到了服务端渲染(server-side rendering)和搜索引擎优化(SEO)。 如果您在扩展面板中渲染组件树性能开销很大,或者只是想要渲染很多不带内容的扩展面板,那么通过启用 TransitionProps 中的 unmountOnExit 来改变默认的渲染方式也许可行。

<Accordion TransitionProps={{ unmountOnExit: true }} />

不过对所有情况下的性能优化,这并不是灵丹妙药。 请您务必先确定性能的瓶颈所在,再考虑这些优化策略。

次要标题和列

您也可以使用多列来构造内容,而且将辅助文本添加到面板能够以辅助用户。

Location

Select trip destination

Barbados
Select your destination of choice
Learn more

无障碍设计

(WAI-ARIA: https://www.w3.org/TR/wai-aria-practices/#accordion)

为了获得最佳的无障碍设计,我们建议在 AccordionSummary 上设置 idaria-controlsAccordion 将为扩展面板的内容区域派生必需的 aria-labelledbyid