本教程详细介绍了在 react native 应用中处理和显示 html 字符串的多种方法。针对原生环境无法直接使用 `dangerouslysetinnerhtml` 的问题，文章重点推荐了 `react native webview`、`react-native-htmlview` 和 `react-native-render-html` 等库，并提供了 `react-native-render-html` 的详细代码示例，帮助开发者安全、高效地将 html 内容渲染为原生视图，同时正确解析 html 实体。
在 react native 开发中，我们经常会遇到需要展示包含 HTML 标签和实体（如 “、’）的字符串数据。与 Web 环境不同，React Native 不支持浏览器原生的 dangerouslySetInnerHTML 属性来直接解析 HTML。这是因为 React Native 渲染的是原生组件，而非 dom 元素。因此，我们需要采用专门的库来将 HTML 字符串转换为可显示的原生视图。本文将介绍几种主流且推荐的解决方案。
1. 使用 React Native WebView
React Native WebView 是官方文档推荐的一种解决方案，它允许你在 React Native 应用中嵌入一个完整的 WebView 组件，从而加载和显示任意的 Web 内容，包括复杂的 HTML、css 和 javaScript。
适用场景：
- 当你的 HTML 内容非常复杂，包含大量的样式、脚本，甚至需要交互时。
- 需要显示完整的网页或局部 Web 页面。
- 对性能要求不是极致，可以接受 WebView 的开销。
基本用法概念： 首先，你需要安装 react-native-webview：
然后，在你的组件中导入并使用它：
立即学习“前端免费学习笔记（深入）”；
import React from 'react'; import { View } from 'react-native'; import WebView from 'react-native-webview'; function MyWebViewComponent() { const htmlContent = ` <html> <head> <style> body { font-family: sans-serif; margin: 16px; } h1 { color: #333; } p { line-height: 1.5; } </style> </head> <body> <h1>欢迎来到 WebView</h1> <p>这是一个包含 <b>HTML 标签</b> 和 <i>样式</i> 的示例内容。</p> <p>HTML 实体 ' 和 " 也会被正确解析。</p> </body> </html> `; return ( <View style={{ flex: 1 }}> <WebView originWhitelist={['*']} source={{ html: htmlContent }} style={{ flex: 1 }} /> </View> ); } export default MyWebViewComponent;
WebView 提供了一个沙盒环境，可以安全地渲染 HTML，并处理各种 HTML 实体和标签。
2. 使用 react-native-htmlview
react-native-htmlview 是一个轻量级的库，旨在将 HTML 内容解析并渲染为 React Native 的原生视图组件。它适用于相对简单的 HTML 内容，能够将常见的 HTML 标签（如 p, h1, strong, em 等）转换为对应的 Text 或 View 组件。
适用场景：
- HTML 内容不包含复杂样式或 javascript。
- 主要用于显示文本内容，并保留基本的格式化。
- 追求更接近原生组件的渲染效果。
基本用法概念： 安装 react-native-htmlview：
npm install react-native-htmlview
使用示例：
import React from 'react'; import { View, ScrollView } from 'react-native'; import HTMLView from 'react-native-htmlview'; function MyHTMLViewComponent() { const htmlContent = "<h1>标题</h1><p>这是一个<b>加粗</b>的段落，包含!和"实体。</p>"; return ( <ScrollView style={{ flex: 1, padding: 16 }}> <HTMLView value={htmlContent} stylesheet={{ h1: { fontSize: 24, fontWeight: 'bold', marginBottom: 10 }, p: { fontSize: 16, lineHeight: 24 }, b: { fontWeight: 'bold' } }} /> </ScrollView> ); } export default MyHTMLViewComponent;
HTMLView 允许你通过 stylesheet 属性为不同的 HTML 标签定义样式，从而更好地控制渲染效果。
3. 使用 react-native-render-html (推荐)
react-native-render-html 是一个功能强大且高度可定制的 HTML 渲染库。它能够将 HTML 字符串解析并渲染成 React Native 的原生组件树，同时支持丰富的样式、自定义渲染器以及对图片、链接等复杂元素的处理。对于大多数需要将 HTML 内容转换为原生视图的场景，这是一个非常优秀的通用解决方案。
适用场景：
- 需要将 HTML 内容渲染为原生组件，同时保持高度的样式控制和可定制性。
- HTML 内容可能包含图片、链接、列表等多种元素。
- 需要处理 HTML 实体并正确显示。
- 追求性能和原生体验。
安装：
npm install react-native-render-html
基本用法示例： 以下示例展示了如何使用 react-native-render-html 来解析一个包含 HTML 实体的字符串：
import React from "react"; import { ScrollView, usewindowDimensions, StyleSheet } from "react-native"; import RenderHTML from "react-native-render-html"; function HTMLRendererExample() { const { width } = useWindowDimensions(); // 获取屏幕宽度以适应内容 // 示例 HTML 字符串，包含 HTML 实体 const HTML_STRING = ` <p>What is the name of James Dean's character in the 1955 movie "Rebel Without a Cause"?</p> <ul> <li>James Dean</li> <li>Natalie Wood</li> <li>Sal Mineo</li> </ul> <img src="https://picsum.photos/200/100" alt="示例图片" /> <a href="https://reactnative.dev/">访问 React Native 官网</a> `; return ( <ScrollView style={styles.container}> <RenderHTML contentWidth={width} // 必须提供内容宽度以正确计算布局 source={{ html: HTML_STRING }} // 提供 HTML 字符串 tagsStyles={tagsStyles} // 可选：自定义标签样式 baseStyle={baseStyle} // 可选：基础样式 /> </ScrollView> ); } const tagsStyles = { p: { fontSize: 16, lineHeight: 24, marginBottom: 10, color: '#333', }, ul: { marginLeft: 20, marginBottom: 10, }, li: { fontSize: 15, lineHeight: 22, color: '#555', }, a: { color: 'blue', textDecorationLine: 'underline', }, img: { borderRadius: 8, marginTop: 10, marginBottom: 10, } }; const baseStyle = { fontSize: 16, color: '#222', }; const styles = StyleSheet.create({ container: { flex: 1, padding: 16, backgroundColor: '#f8f8f8', }, }); export default HTMLRendererExample;
代码解析：
- useWindowDimensions() 钩子用于获取当前设备的窗口尺寸，其中 width 被传递给 RenderHTML 的 contentWidth 属性。这是非常重要的，因为它帮助 RenderHTML 正确计算内部内容的布局，特别是当内容包含图片或需要流式布局时。
- source={{ html: HTML_STRING }} 是 RenderHTML 组件的核心属性，它接收一个包含 HTML 字符串的对象。
- tagsStyles 属性允许你为特定的 HTML 标签定义 React Native 样式。例如，你可以设置 p 标签的字体大小、行高和颜色。
- baseStyle 属性定义了所有文本元素的默认样式。
- react-native-render-html 会自动解析 ‘ 和 ” 等 HTML 实体，并将其显示为正确的字符（即 ‘ 和 “）。
注意事项：
- 性能： 对于非常大的 HTML 内容，即使是 react-native-render-html 也可能需要一些时间来解析和渲染。考虑对内容进行分页或按需加载。
- 样式定制： 该库提供了强大的样式定制能力，你可以通过 tagsStyles、classesStyles、idsStyles 等属性精细控制元素的样式。
- 自定义渲染器： 如果默认渲染器不满足需求，你还可以为特定标签（如 table、video）创建自定义渲染器，以实现更复杂的交互或布局。
- 图片和链接： react-native-render-html 能够很好地处理 <img> 标签（需要提供 contentWidth）和 <a> 标签（点击后通常会使用 Linking 模块打开外部链接）。
总结
在 React Native 中处理 HTML 字符串，核心在于选择一个合适的库来将 HTML 转换为原生视图。
- 如果你需要显示一个完整的、复杂的 Web 页面，包含大量脚本和交互，React Native WebView 是最佳选择。
- 如果你的 HTML 内容相对简单，主要是文本格式化，且希望快速集成，react-native-htmlview 可以满足需求。
- 对于大多数需要将 HTML 内容解析为可定制的原生组件，并要求良好性能和扩展性的场景，react-native-render-html 提供了一个强大且灵活的解决方案。
根据你的具体需求和 HTML 内容的复杂程度，选择最适合你的库，将 HTML 内容安全、高效地展示在你的 React Native 应用中。