Accordion 扩展面板
扩展面板包含了流程的创建和元素的轻量编辑。
扩展面板 是一个轻量级容器,既可以单独使用,也可以和卡片这样更大的平面相结合。
注意: 此版本的扩展面板将不再记录在 Material Design 指南中,但 Material-UI 将继续支持它。 您可能属性它之前的名字为 "expansion panel"。
简单的扩展面板
Accordion 1
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse malesuada lacus ex, sit amet blandit leo lobortis eget.
Accordion 2
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse malesuada lacus ex, sit amet blandit leo lobortis eget.
Disabled Accordion
General settings
I am an accordion
Nulla facilisi. Phasellus sollicitudin nulla et quam mattis feugiat. Aliquam eget maximus est, id dignissim quam.
Users
You are currently not an owner
Donec placerat, lectus sed mattis semper, neque lectus feugiat lectus, varius pulvinar diam eros in elit. Pellentesque convallis laoreet laoreet.
Advanced settings
Filtering has been entirely disabled for whole web server
Nunc vitae orci ultricies, auctor nunc in, volutpat nisl. Integer sit amet egestas eros, vitae egestas augue. Duis vel est augue.
Personal data
Nunc vitae orci ultricies, auctor nunc in, volutpat nisl. Integer sit amet egestas eros, vitae egestas augue. Duis vel est augue.
自定义扩展面板
以下是自定义组件的一个示例。 您可以在 重写文档页 中了解有关此内容的更多信息。
Collapsible Group Item #2
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.
Collapsible Group Item #3
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 }} />
不过对所有情况下的性能优化,这并不是灵丹妙药。 请您务必先确定性能的瓶颈所在,再考虑这些优化策略。
次要标题和列
您也可以使用多列来构造内容,而且将辅助文本添加到面板能够以辅助用户。
无障碍设计
(WAI-ARIA: https://www.w3.org/TR/wai-aria-practices/#accordion)
为了获得最佳的无障碍设计,我们建议在 AccordionSummary
上设置 id
和 aria-controls
。 Accordion
将为扩展面板的内容区域派生必需的 aria-labelledby
和 id
。