Drawer(抽屉)
导航抽屉提供了一个访问您应用中的目标地址的途径。 侧边栏被固定在屏幕的左侧或右侧,而它包含了一些补充内容。
用户能够通过 Navigation drawers(或者 “sidebars”)来访问目标地址和一些应用功能,例如切换帐户。 它们既可以永久在屏幕上,也可以由一个导航菜单图标控制。
Side sheets 主要在平板和桌面上作为辅助侧边栏使用。
临时抽屉
你可以打开或关闭一个临时的导航抽屉。 抽屉组件的默认状态是关闭,而选中一个区则会触发抽屉组件在任何其他内容之上呈现。
而点击覆盖的区域(overlay)或者按下 Esc 键则可以关闭抽屉。 通过操控 open
属性,当选中一个子项的时候,抽屉则会被关闭。
{(['left', 'right', 'top', 'bottom'] as const).map((anchor) => (
<React.Fragment key={anchor}>
<Button onClick={toggleDrawer(anchor, true)}>{anchor}</Button>
<Drawer
anchor={anchor}
open={state[anchor]}
onClose={toggleDrawer(anchor, false)}
>
{list(anchor)}
</Drawer>
</React.Fragment>
))}
可滑动的抽屉
您可以使用 SwipeableDrawer
组件来实现滑动抽屉。
此组件附带 2 kB gzipped 的负载开销。 一些低端移动设备无法以 60 FPS 的速度跟随手指的移动。 你可以通过使用 disableBackdropTransition
这个属性来解决此问题。
{(['left', 'right', 'top', 'bottom'] as const).map((anchor) => (
<React.Fragment key={anchor}>
<Button onClick={toggleDrawer(anchor, true)}>{anchor}</Button>
<SwipeableDrawer
anchor={anchor}
open={state[anchor]}
onClose={toggleDrawer(anchor, false)}
onOpen={toggleDrawer(anchor, true)}
>
{list(anchor)}
</SwipeableDrawer>
</React.Fragment>
))}
在此文档的页面中有以下的一些属性,它们用来优化组件的使用:
- 一些高端的设备托管了 iOS。 在不丢失帧的情况下,能够启用背景过渡。 这样展示令人足够满意了。
- iOS 有一个“滑动回退”功能,它会影响发现功能,所以必须禁用发现功能。
const iOS =
typeof navigator !== 'undefined' && /iPad|iPhone|iPod/.test(navigator.userAgent);
<SwipeableDrawer disableBackdropTransition={!iOS} disableDiscovery={iOS} />;
保持挂载(mounted)
你可以使用 ModalProps
属性来确保临时抽屉不会被卸载,就像这样:
如果你使用的是桌面设备,那么可以点击 "OPEN" 按钮来切换抽屉的显示。 如果你使用的设备是手机,那么可以在 CodeSandbox(“编辑”图标)中打开该演示,并尝试滑动抽屉。
全高导航栏
你可以使用 ModalProps
属性来确保临时抽屉不会被卸载,就像这样:
<Drawer
variant="temporary"
ModalProps={{
keepMounted: true,
}}
/>
有关此部分的更多详情请查看 模态框性能部分。
响应式的抽屉
You can use the temporary
variant to display a drawer for small screens and permanent
for a drawer for wider screens.
持久的抽屉
持久抽屉可以在打开或关闭状态之间切换。 抽屉与内容位于同一表面的高度上。 它默认情况下是关闭的,可通过选择菜单图标打开,直到用户选择关闭之前,它都会保持打开状态。 在不同操作和不同节点切换时,抽屉的状态都会被记住。
当抽屉位于页面网格之外并打开时,抽屉会强制其他内容更改大小并适应较小的视口。
持久的抽屉能够适用于比移动设备大的屏幕尺寸。 那些有多个层次等级的应用,会用到向上的箭头作为导航,在这样的情况下,我们不推荐使用持久的抽屉。
迷你变体抽屉
在这种情况下,持久的抽屉会更改其宽度。 它的静止状态是一个与其内容相同的迷你抽屉,由一个应用栏夹住。 展开后,它将显示为标准的持久的导航抽屉。
若有快速选择访问应用以及访问应用内容的需求,我们建议您使用迷你变体抽屉。