React 19 兼容
React 19 兼容
antd v5 默认兼容 React 16 ~ 18 版本,对于 React 19 版本,可以使用以下兼容方法进行适配。该兼容方式以及接口将在 v6 被移除。
由于 React 19 调整了 react-dom
的导出方式,导致 antd 无法直接使用 ReactDOM.render
方法。因而使用 antd 会遇到以下问题:
Modal
、Notification
、Message
等组件的静态方法无效因而需要通过兼容配置,使 antd 在 React 19 中正常工作。
以下方法任选其一,其中优先推荐使用兼容包。
安装兼容包
npm install --save-dev @ant-design/v5-patch-for-react-19
在应用入口处引入兼容包
import '@ant-design/v5-patch-for-react-19';
再次提醒,默认情况下,请优先使用兼容包。除非对于 umd、微应用等特殊场景,才使用 unstableSetRender
方法。unstableSetRender
为底层注册方法,允许开发者修改 ReactDOM 的渲染方法。在你的应用入口处写入:
import { unstableSetRender } from 'antd';import { createRoot } from 'react-dom/client';unstableSetRender((node, container) => {container._reactRoot ||= createRoot(container);const root = container._reactRoot;root.render(node);return async () => {await new Promise((resolve) => setTimeout(resolve, 0));root.unmount();};});