大网数据广告活动
React 前端开发

React 中文参考:renderToStaticMarkup

· 52CE 我爱测

此方法渲染的是 **无法进行二次渲染的非交互式 HTML**。如果你需要使用 React 作为简单静态页面生成器,或者需要呈现纯静态内容(例如邮件),则这种方法非常适用。

renderToStaticMarkup 会将非交互的 React 组件树渲染成 HTML 字符串。

const html = renderToStaticMarkup(reactNode, options?)

参考 {/reference/}

renderToStaticMarkup(reactNode, options?) {/rendertostaticmarkup/}

在服务器上,调用 renderToStaticMarkup 将你的应用程序渲染成 HTML。


const html = renderToStaticMarkup(<Page />);

它将会把 React 组件转换为非交互式 HTML 。

请看下方更多示例。

参数 {/parameters/}

  • reactNode:你想要渲染到 HTML 的 React 节点。例如像是 <Page /> 之类的 JSX。
  • 可选的 options:一个服务器渲染的对象。
    • 可选的 identifierPrefix:一个 React 使用 useId 生成的 ID 的字符串前缀,用于避免在同一页面上使用多个 root 时发生冲突。

返回值 {/returns/}

一个 HTML 字符串。

注意事项 {/caveats/}

  • renderToStaticMarkup 的输出无法进行二次渲染。

  • renderToStaticMarkup 对 Suspense 的支持有限。如果一个组件触发了 Suspense,renderToStaticMarkup 立即将它的后备方案作为 HTML 输出。

  • renderToStaticMarkup 在浏览器中可以使用,但不建议在客户端代码中使用它。如果你需要在浏览器中将组件渲染成 HTML,请把它渲染到 DOM 节点中以获取 HTML。


用法 {/usage/}

将一个非交互式的 React 树渲染成 HTML 字符串 {/rendering-a-non-interactive-react-tree-as-html-to-a-string/}

调用 renderToStaticMarkup 将你的应用程序渲染为 HTML 字符串,然后将其与服务器响应一起发送:


// 路由处理程序语法取决于你的后端框架
app.use('/', (request, response) => {
  const html = renderToStaticMarkup(<Page />);
  response.send(html);
});

这将会把 React 组件转换为非交互式 HTML 。

此方法渲染的是 无法进行二次渲染的非交互式 HTML。如果你需要使用 React 作为简单静态页面生成器,或者需要呈现纯静态内容(例如邮件),则这种方法非常适用。

对于交互式的应用程序,建议在服务器端使用 renderToString 方法,而在客户端上使用 hydrateRoot 方法。

本文来自 React 文档中文译者及贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
React 文档中文译者及贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。