JavaScript实现HTML转义与反转义的两种方法及工具类封装

作者:流萤

时间:2026-10-23

浏览:262

本文总结了JavaScript中HTML字符串转义与反转义的两种核心实现方式:利用浏览器内置DOM API(textContent/innerHTML)以及基于正则表达式的映射替换。文章提供了封装好的HtmlUtil工具类代码,包含编码、解码及去除标签、处理换行等常用字符串处理方法,并附带完整的测试用例与效果展示,帮助开发者快速掌握HTML特殊字符的安全处理技巧。

文章目录

本文详细介绍在JavaScript中对HTML字符串进行转义(编码)与反转义(解码)的具体实现方案及使用技巧,旨在为开发者提供实用的参考代码。

在JavaScript中,实现HTML字符串的转义与反转义主要依赖以下两种技术手段:

第一种方法是利用浏览器内部提供的DOM转换器来实现HTML的转义操作。

第二种方法是通过编写正则表达式来匹配并替换特殊字符,从而实现HTML的转义。

基于上述原理,下面提供一个封装完整的JavaScript工具类,便于在项目中直接调用。


var HtmlUtil = {
    /*1.用浏览器内部转换器实现html编码(转义)*/
    htmlEncode:function (html){
      //1.首先动态创建一个容器标签元素,如DIV
      var temp = document.createElement ("div");
      //2.然后将要转换的字符串设置为这个元素的innerText或者textContent
      (temp.textContent != undefined ) ? (temp.textContent = html) : (temp.innerText = html);
      //3.最后返回这个元素的innerHTML,即得到经过HTML编码转换的字符串了
      var output = temp.innerHTML;
      temp = null;
      return output;
    },
    /*2.用浏览器内部转换器实现html解码(反转义)*/
    htmlDecode:function (text){
      //1.首先动态创建一个容器标签元素,如DIV
      var temp = document.createElement("div");
      //2.然后将要转换的字符串设置为这个元素的innerHTML(ie,火狐,google都支持)
      temp.innerHTML = text;
      //3.最后返回这个元素的innerText或者textContent,即得到经过HTML解码的字符串了。
      var output = temp.innerText || temp.textContent;
      temp = null;
      return output;
    },
    /*3.用正则表达式实现html编码(转义)*/
    htmlEncodeByRegExp:function (str){ 
       var temp = "";
       if(str.length == 0) return "";
       temp = str.replace(/&/g,"&");
       temp = temp.replace(/</g,"&lt;");
       temp = temp.replace(/>/g,"&gt;");
       temp = temp.replace(/\s/g,"&nbsp;");
       temp = temp.replace(/\'/g,"&#39;");
       temp = temp.replace(/\"/g,"&quot;");
       return temp;
    },
    /*4.用正则表达式实现html解码(反转义)*/
    htmlDecodeByRegExp:function (str){ 
       var temp = "";
       if(str.length == 0) return "";
       temp = str.replace(/&amp;/g,"&");
       temp = temp.replace(/&lt;/g,"<");
       temp = temp.replace(/&gt;/g,">");
       temp = temp.replace(/&nbsp;/g," ");
       temp = temp.replace(/&#39;/g,"\'");
       temp = temp.replace(/&quot;/g,"\"");
       return temp; 
    },
    /*5.用正则表达式实现html编码(转义)(另一种写法)*/
    html2Escape:function(sHtml) {
       return sHtml.replace(/[<>&"]/g,function(c){return {'<':'&lt;','>':'&gt;','&':'&amp;','"':'&quot;'}[c];});
    },
    /*6.用正则表达式实现html解码(反转义)(另一种写法)*/
    escape2Html:function (str) {
       var arrEntities={'lt':'<','gt':'>','nbsp':' ','amp':'&','quot':'"'};
       return str.replace(/&(lt|gt|nbsp|amp|quot);/ig,function(all,t){return arrEntities[t];});
    }
  };

接下来通过具体的测试代码来验证上述方法的效果,并展示最终的运行结果。

首先,准备用于测试的HTML结构代码,包含用于显示原始内容、转义后内容及反转义后内容的容器。


<div>&</div>
<div>&amp;</div>
<div id="testdiv"></div>
<div id="testdiv1"></div>
<div id="testdiv2"></div>

<div id="regdiv"></div>
<div id="regdiv1"></div>
<div id="regdiv2"></div>

<div id="regdiv3"></div>
<div id="regdiv4"></div>
<div id="regdiv5"></div>

随后,编写JavaScript测试逻辑,调用封装好的工具类对包含特殊字符的HTML字符串进行编码和解码操作,并将结果渲染到页面上。


var strHtml='<div style="color:blue">符号:&amp;<div>';
  document.getElementById("testdiv").innerHTML=strHtml;

  var encodedHtml= HtmlUtil.htmlEncode(strHtml);// "&lt;div style="color:blue"&gt;符号:&amp;amp;&lt;div&gt;"
  document.getElementById("testdiv1").innerHTML=encodedHtml;

  var decodedHtml=HtmlUtil.htmlDecode(encodedHtml);// '<div style="color:blue">符号:&amp;<div>'
  document.getElementById("testdiv2").innerHTML=decodedHtml;

  var strHtml_1='<div style="color:red">符号:&amp;<div>';
  document.getElementById("regdiv").innerHTML=strHtml_1;

  var encodedHtml_1 =HtmlUtil.htmlEncodeByRegExp(strHtml_1);// "&lt;div style="color:red"&gt;符号:&amp;amp;&lt;div&gt;"
  document.getElementById("regdiv1").innerHTML=encodedHtml_1;

  var decodedHtml_1 =HtmlUtil.htmlDecodeByRegExp(encodedHtml_1);// '<div style="color:blue">符号:&amp;<div>'
  document.getElementById("regdiv2").innerHTML=decodedHtml_1;

  var strHtml_2='<div style="color:green">符号:&amp;<div>';
  document.getElementById("regdiv3").innerHTML=strHtml_2;

  var encodedHtml_2 =HtmlUtil.htmlEncodeByRegExp(strHtml_2);// "&lt;div style="color:green"&gt;符号:&amp;amp;&lt;div&gt;"
  document.getElementById("regdiv4").innerHTML=encodedHtml_2;

  var decodedHtml_2 =HtmlUtil.htmlDecodeByRegExp(encodedHtml_2);// '<div style="color:green">符号:&amp;<div>'
  document.getElementById("regdiv5").innerHTML=decodedHtml_2;

通过浏览器控制台或页面渲染效果,可以直观地看到转义与反转义处理前后的差异,验证工具类的正确性。

 在JavaScript中,实现HTML字符串的转义与反转义主要依赖以下两种技术手段:

除了基础的转义与反转义,实际开发中常需处理其他HTML字符串相关的格式化需求,以下是几种常用方法的实现。

第一种辅助功能是移除字符串中所有的HTML标签,仅保留纯文本内容。


function removeHtmlTab(tab) {
return tab.replace(/<[^<>]+?>/g,'');//删除所有HTML标签
}
removeHtmlTab('<div id="test">zyl</div><span>zzc</span>');// zylzzc

第二种功能是将字符串中的回车换行符(\r\n)转换为HTML的<br/>标签,以便在网页中正确显示换行。


function return2Br(str) {
  return str.replace(/\r?\n/g,"<br />");
}

第三种功能用于清理字符串首尾的空白换行,并将连续3次以上的换行符统一压缩为2次换行,优化文本排版。


function trimBr(str) {
  str=str.replace(/((\s|&nbsp;)*\r?\n){3,}/g,"\r\n\r\n");//限制最多2次换行
  str=str.replace(/^((\s|&nbsp;)*\r?\n)+/g,'');//清除开头换行
  str=str.replace(/((\s|&nbsp;)*\r?\n)+$/g,'');//清除结尾换行
  return str;
}

第四种功能是将字符串中出现的多个连续空格或空白字符合并为单个空格,保持文本整洁。


function mergeSpace(str) {
  str=str.replace(/(\s|&nbsp;)+/g,' ');
  return str;
}

此外,为了方便开发者进行在线测试和转换,这里推荐几款相关的实用在线工具。

提供在线HTML转义与反转义转换工具,支持实时查看编码和解码结果: http://tools.jb51.net/transcoding/html_transcode

提供Native与Unicode编码在线转换工具,适用于处理不同字符集之间的转换: http://tools.jb51.net/transcoding/native2unicode

提供在线中文汉字、ASCII码与Unicode编码的互相转换工具,便于处理多语言字符: http://tools.jb51.net/transcoding/chinese2unicode

如需深入了解JavaScript的其他相关技巧,可进一步查阅本站专题,包括《javascript编码操作技巧总结》、《JavaScript加密解密技巧汇总》、《JavaScript错误与调试技巧总结》、《JavaScript数据结构与算法技巧总结》、《JavaScript遍历算法与技巧总结》及《JavaScript数学运算用法总结》。

希望上述关于JavaScript程序设计的内容能对您的开发工作有所帮助。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章