TrapFocus API

想要学习更多组件属性和 CSS API，可以查阅 React TrapFocus 组件的 API 文档。

导入

import TrapFocus from '@mui/base/TrapFocus';
// 或
import { TrapFocus } from '@mui/base';

Utility component that locks focus inside the component.

名称	类型	默认值	描述
open^*	bool	false	If `true`, focus is locked.
children	element		A single child content element. ⚠️ Needs to be able to hold a ref.
disableAutoFocus	bool	false	If `true`, the trap focus will not automatically shift focus to itself when it opens, and replace it to the last focused element when it closes. This also works correctly with any trap focus children that have the `disableAutoFocus` prop. Generally this should never be set to `true` as it makes the trap focus less accessible to assistive technologies, like screen readers.
disableEnforceFocus	bool	false	If `true`, the trap focus will not prevent focus from leaving the trap focus while open. Generally this should never be set to `true` as it makes the trap focus less accessible to assistive technologies, like screen readers.
disableRestoreFocus	bool	false	If `true`, the trap focus will not restore focus to previously focused element once trap focus is hidden or unmounted.
getTabbable	func		Returns an array of ordered tabbable nodes (i.e. in tab order) within the root. For instance, you can provide the "tabbable" npm dependency. Signature: `function(root: HTMLElement) => void`
isEnabled	func	function defaultIsEnabled() { return true; }	This prop extends the `open` prop. It allows to toggle the open state without having to wait for a rerender when changing the `open` prop. This prop should be memoized. It can be used to support multiple trap focus mounted at the same time.

组件无法持有 ref。