跳到内容
+

Portal

Portal 组件允许你将其子元素渲染到 Portal 自身 DOM 层次结构之外的 DOM 节点中。

Portal API

导入

import { Portal } from '@mui/base/Portal';
// or
import { Portal } from '@mui/base';

了解更多关于差异的信息,请阅读这篇关于最小化捆绑包大小的指南

Props

名称类型默认值描述
childrennode-

要渲染到 container 中的子元素。

containerHTML 元素
| 函数
-

一个 HTML 元素或返回 HTML 元素的函数。container 将会附加 portal 子元素。
你也可以提供一个回调函数,它会在 React 布局 effect 中被调用。这允许你从 ref 设置 container,并且也使得服务端渲染成为可能。
默认情况下,它使用顶层文档对象的 body,所以通常情况下它就是 document.body

disablePortalboolfalse

children 将会位于父组件的 DOM 层次结构之下。


该组件无法持有 ref。