0

0

JavaScript动态插入HTML:正确渲染图片与富文本内容

聖光之護

聖光之護

发布时间:2025-08-11 22:24:01

|

211人浏览过

|

来源于php中文网

原创

javascript动态插入html:正确渲染图片与富文本内容

本教程旨在解决在JavaScript中动态插入从数据库获取的HTML字符串(如<img>标签)时,内容未能正确渲染为图片或其他HTML元素,反而显示为纯文本的问题。核心解决方案在于理解并正确使用innerHTML属性替代createTextNode()方法,以确保浏览器能够解析并呈现作为字符串传递的HTML内容,同时强调了使用innerHTML时的安全注意事项。

1. 问题背景与现象分析

在前端开发中,我们经常需要从后端API或数据库获取包含HTML标签(例如<img>、<a>、<strong>等)的文本内容,并将其动态地插入到网页中。然而,一个常见的误区是使用document.createTextNode()方法来处理这些HTML字符串。

考虑以下场景:您从数据库中获取到用户的消息内容,其中包含用户的头像图片标签,例如:

<img src='uploads/defaultpp.png' alt='Profile Picture' width='500' height='600'>username: text

当您尝试使用JavaScript将其插入到DOM中时,如果采用了类似以下的代码:

function createDiv(divText, divName, divPicture, name){
    let child = document.createElement("div");      
    let content = document.createTextNode(divPicture + divName  + ": " + divText);  

    child.appendChild(content);         
    document.getElementById("myDiv").appendChild(child);
}

您会发现,页面上显示的不是一张图片和后续的文本,而是原封不动的HTML标签字符串,例如:

立即学习Java免费学习笔记(深入)”;

<img src='uploads/defaultpp.png' alt='Profile Picture' width='500' height='600'>username: text

这是因为createTextNode()方法的作用是将传入的字符串视为纯文本内容。它会对字符串中的HTML特殊字符(如<、>、&等)进行转义,将其转换为对应的HTML实体(例如<会被转义为)。这样做的目的是为了防止跨站脚本攻击(XSS),并确保纯文本内容不会被浏览器误解析为HTML标签。然而,当我们的意图就是渲染HTML标签时,这种转义行为反而成了障碍。

2. 解决方案:利用 innerHTML 属性

要正确地将包含HTML标签的字符串解析并渲染为实际的HTML元素,我们应该使用元素的innerHTML属性。innerHTML属性允许您设置或获取一个元素内部的HTML内容。当您向innerHTML赋一个字符串时,浏览器会将其解析为HTML结构,并创建相应的DOM节点。

靠岸学术
靠岸学术

一款集翻译,阅读,文献管理于一体的英文文献阅读器

下载

将上述createDiv函数修改为使用innerHTML,即可解决问题:

function createDiv(divText, divName, divPicture, name){
    let child = document.createElement("div");
    // 使用 innerHTML 将包含 HTML 标签的字符串直接插入到 div 元素中
    child.innerHTML = divPicture + divName  + ": " + divText;      
    document.getElementById("myDiv").appendChild(child);
}

代码解释:

  • let child = document.createElement("div");:这行代码创建了一个新的div元素,作为容器。
  • child.innerHTML = divPicture + divName + ": " + divText;:这是关键的改动。我们将包含<img>标签字符串(divPicture)以及其他文本内容拼接成一个完整的HTML字符串,然后将其赋值给child元素的innerHTML属性。浏览器在接收到这个字符串后,会将其中的<img>标签解析为一个实际的图片元素,并正确加载图片源。
  • document.getElementById("myDiv").appendChild(child);:最后,将这个包含正确渲染内容的child元素添加到页面上的目标myDiv中。

通过这种方式,当divPicture是一个完整的<img>标签字符串时,它将被浏览器识别并渲染为一张图片,而不是纯文本。

3. createTextNode 与 innerHTML 的对比

理解两者之间的根本区别对于正确的DOM操作至关重要:

特性 createTextNode() innerHTML
功能 创建一个文本节点。 设置或获取元素的HTML内容。
处理方式 将所有内容视为纯文本,对HTML特殊字符进行转义。 将内容解析为HTML结构,创建DOM节点。
安全性 默认安全,可有效防止XSS攻击(因为不解析HTML)。 存在XSS风险,如果内容来自不可信源,必须进行净化。
适用场景 插入纯文本内容,特别是用户输入,确保内容按字面显示。 插入包含HTML标签的字符串,需要浏览器解析和渲染HTML。

4. 注意事项与最佳实践

  1. 安全性(XSS防护): 使用innerHTML时,如果传入的HTML字符串来源于用户输入或任何不可信的外部源,务必进行严格的服务器端净化(Sanitization)。恶意用户可能会注入包含JavaScript代码的HTML(如<script>标签或事件属性),从而引发跨站脚本攻击。虽然在客户端进行一些简单的过滤是可能的,但最可靠的防护措施始终在后端进行。
  2. 性能考量: 对于非常大或频繁更新的HTML字符串,反复修改innerHTML可能会导致性能问题,因为它涉及到DOM的重新解析和重绘。在这种情况下,考虑使用document.createElement()、appendChild()、insertBefore()等原生DOM操作方法来构建和修改DOM树,它们通常更高效。然而,对于像聊天消息这样相对较小的HTML片段,innerHTML的便利性通常优于其潜在的性能劣势。
  3. 何时仍使用 createTextNode: 当您确定要插入的内容就是纯文本,且不希望其中任何字符被解释为HTML标签时,createTextNode仍然是首选。例如,显示用户输入的评论,其中可能包含<或>符号,但您不希望它们被渲染为HTML。

5. 总结

在JavaScript中动态生成并插入HTML内容时,正确选择DOM操作方法至关重要。当您需要将包含HTML标签的字符串(例如从数据库获取的<img>标签)解析并渲染为实际的HTML元素时,请使用元素的innerHTML属性。而当您仅需插入纯文本内容,并希望避免任何HTML解析时,则应使用document.createTextNode()。始终牢记innerHTML可能带来的安全风险,并对来自不可信源的数据进行严格的服务器端净化。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

761

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

221

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1568

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

651

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

1228

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

1204

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

193

2025.07.29

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

131

2025.08.07

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何进行WebSocket调试
如何进行WebSocket调试

共1课时 | 0.1万人学习

TypeScript全面解读课程
TypeScript全面解读课程

共26课时 | 5.1万人学习

前端工程化(ES6模块化和webpack打包)
前端工程化(ES6模块化和webpack打包)

共24课时 | 5.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号