使用createPortal方法无法插入HTML元素的问题排查

你的Portal组件未达到预期效果的核心原因是：你定义了Portal组件，但从未将它加入到React的组件渲染树中，导致createPortal的代码根本没有被执行，自然无法向#modal元素插入内容。

修复步骤 #

• 在主组件（比如App.tsx）中引入并渲染Portal组件
• 你的index.html中#modal元素的位置已经符合要求（在React根节点之外且初始化时已存在）

修改后的代码示例 #

修改App.tsx #

import { useState } from 'react';
import reactLogo from './assets/react.svg';
import viteLogo from '/vite.svg';
import './App.css';
// 引入Portal组件
import Portal from './dupe.tsx';

function App() {
  const [count, setCount] = useState(0);

  return (
    <>
      <div>
        <a href="https://vite.dev" target="_blank">
          <img src={viteLogo} className="logo" alt="Vite logo" />
        </a>
        <a href="https://react.dev" target="_blank">
          <img src={reactLogo} className="logo react" alt="React logo" />
        </a>
      </div>
      <h1>Vite + React</h1>
      <div className="card">
        <button onClick={() => setCount((count) => count + 1)}>
          count is {count}
        </button>
        <p>
          Edit <code>src/App.tsx</code> and save to test HMR
        </p>
      </div>
      <p className="read-the-docs">
        Click on the Vite and React logos to learn more
      </p>
      {/* 渲染Portal组件 */}
      <Portal />
    </>
  );
}

export default App;

其他代码无需调整 #

• dupe.tsx中的Portal逻辑本身是正确的，只要组件被React渲染，就会将<h1>Heading</h1>插入到#modal容器中
• index.html里的#modal元素位置符合要求

额外说明 #

React的createPortal必须在已挂载的React组件中调用才能生效，它的作用是将组件的部分DOM节点渲染到指定的外部容器，但组件本身仍属于React组件树的一部分，需要被纳入React的渲染流程。

内容的提问来源于stack exchange，提问作者anonymous