跳到主要內容跳到主要內容

PortalAPI

React Portal 元件的 API 參考文件。瞭解此匯出模組的 props、CSS 和其他 API。

示範

匯入

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

閱讀這份關於最小化套件大小的指南,以瞭解差異。



Portals 提供一流的方式將子元件渲染到父元件 DOM 階層之外的 DOM 節點中。

Props

名稱類型預設值描述
childrennode-

要渲染到 container 中的子元件。

containerHTML 元素
| func
-

HTML 元素或返回 HTML 元素的函式。container 將會附加 portal 子元件。
您也可以提供回呼函式,此函式會在 React 版面配置效果中呼叫。這可讓您從 ref 設定 container,並使伺服器端渲染成為可能。
預設情況下,它使用最上層文件物件的 body,因此大部分時間它只是 document.body

disablePortalboolfalse

children 將會位於父元件的 DOM 階層之下。

元件無法持有 ref。

原始碼

如果您在此頁面中找不到資訊,請考慮查看元件的實作以取得更多詳細資訊。