Guns二次开发（十五）：集成 ueditor 富文本编辑器

技术2022-07-10 131

关于博客中使用的Guns版本问题请先阅读 Guns二次开发目录

在做商品添加模块的时候，需要用到富文本编辑器来上传和编辑商品详情，细心的朋友可能已经发现，Guns其实自身也集成了一个富文本编辑器 ——wangEditor。

只不过，这个富文本编辑器是轻量级的，还不能满足商品详情的某些复杂编辑功能：

所以想来想去，还是决定再集成一个重量级的富文本编辑器，百度 UEditor。

1、官网下载百度UEditor源码

百度UEditor源码的官网下载地址是 http://ueditor.baidu.com/website/download.html ，因为Guns是用java语言写的，所以此处需要下载jsp版本的源码，如下图：

下载后得到压缩包：

解压之后得到下面这个文件夹：

2、将ueditor源码放到guns中

首先在guns中，新建一个文件用于存放ueditor的文件：

效果如下：

3、引入ueditor需要的maven依赖

4、修改ueditor中的配置

（1）因为前面步骤在引入源码文件的时候，我们没有引入ueditor 的jsp文件夹中的内容，而jsp文件夹中有一个 config.json 配置文件内容是前后端通信相关的配置。此处我们新建PublicMsg类，在该类中创建静态变量来存储 config.json 中的内容：(新建ueditor的配置文件类，这也是替换原配置文件的关键，以后需要对配置文件的更改也将是在这里进行！！！)

（2）修改ueditor.config.js文件的后台请求路径：

然后就是统一的 Feng.ctxPath+"/ueditor" 后端接口了

（3）后端代码的实现

接着是图片上传的接口，这个必须配置，否则富文本中的图片无法上传：

5、前端页面使用ueditor

后端相关的配置写好了，前端页面如何配置呢？首先需要注意，富文本的时候需要区分两个场景，场景一是在添加的时候，添加页面需要加载一个内容空白的富文本；场景二是在编辑页面的时候，编辑页面在打开的时候，是要加载之前保存的富文本内容的，所以需要先从数据库获取到一开始添加时保存的富文本内容，然后在回显到富文本中。

（1）前端页面必须引入的js文件

不管是添加页面，还是修改页面，都需要在这两个页面中引入以下js：

（2）添加页面如何引入富文本

首先展示一下添加页面加载的富文本效果图：

在添加页面，需要有一个 id 为 “editor”的div标签，用于定位富文本在页面中的位置：

然后还是在这个页面，初始化 ueditor 富文本框，如下图中的js：

（3）前端如何获取富文本框中的内容

下面几行代码就是js中获取富文本内容的方法：

//获取编辑器内容 var ue = UE.getEditor('editor'); if(!(ue && ue.hasContents())){//编辑器是否有内容 Feng.error("请填写商品详情信息！！！"); return false; } var detail = ue.getContent();

值得注意的是，这里获取的方法富文本详情如果直接传递到给后端接口是不行的，因为一些特殊字符会被转义，最终保存到数据库的内容与你传给后端的内容是不一样的，为了解决这个问题，我便将富文本中的内容进行base64加密后再传给后端，等取出来的时候再用base64解密，就能原样获取到之前的内容。

（4）加密富文本框的内容

//获取编辑器内容 var ue = UE.getEditor('editor'); if(!(ue && ue.hasContents())){//编辑器是否有内容 Feng.error("请填写商品详情信息！！！"); return false; } var detail = ue.getContent(); //设置编码方式为 $.base64.utf8encode = true; detail=$.base64.btoa(detail);

同时页面中也要同步引入base64加密函数：

base64的js函数会在最后贴出来。

（5）编辑页面如何引入富文本

编辑页面比较难的一点，就是要在富文本中回显之前保存的富文本内容，我也是花了一些时间才找到方法。

6、源码

（1）maven依赖

<dependency> <groupId>com.gitee.qdbp.thirdparty</groupId> <artifactId>ueditor</artifactId> <version>1.4.3.3</version> </dependency>

（2）PublicMsg.java

package cn.stylefeng.guns.elephish.utils.ueditor; /** * * 新建PublicMsg类，创建静态变量存储resources/static/jsp/config.json中的内容： * (新建ueditor的配置文件类，这也是替换原配置文件的关键，以后需要对配置文件的更改也将是在这里进行！！！) * */ public class PublicMsg { public static String UEDITOR_CONFIG = "{\n" + " \"imageActionName\":\"uploadimage\",\n" + " \"imageFieldName\":\"upfile\",\n" + " \"imageMaxSize\":2048000,\n" + " \"imageAllowFiles\":[\n" + " \".png\",\n" + " \".jpg\",\n" + " \".jpeg\",\n" + " \".gif\",\n" + " \".bmp\"\n" + " ],\n" + " \"imageCompressEnable\":true,\n" + " \"imageCompressBorder\":1600,\n" + " \"imageInsertAlign\":\"none\",\n" + " \"imageUrlPrefix\":\"\",\n" + " \"imagePathFormat\":\"/storage/image/{yyyy}{mm}{dd}/{time}{rand:6}\",\n" + " \"scrawlActionName\":\"uploadscrawl\",\n" + " \"scrawlFieldName\":\"upfile\",\n" + " \"scrawlPathFormat\":\"/storage/image/{yyyy}{mm}{dd}/{time}{rand:6}\",\n" + " \"scrawlMaxSize\":2048000,\n" + " \"scrawlUrlPrefix\":\"http://35.201.165.105:8000\",\n" + " \"scrawlInsertAlign\":\"none\",\n" + " \"snapscreenActionName\":\"uploadimage\",\n" + " \"snapscreenPathFormat\":\"/storage/image/{yyyy}{mm}{dd}/{time}{rand:6}\",\n" + " \"snapscreenUrlPrefix\":\"http://35.201.165.105:8000\",\n" + " \"snapscreenInsertAlign\":\"none\",\n" + " \"catcherLocalDomain\":[\n" + " \"127.0.0.1\",\n" + " \"localhost\",\n" + " \"img.baidu.com\"\n" + " ],\n" + " \"catcherActionName\":\"catchimage\",\n" + " \"catcherFieldName\":\"source\",\n" + " \"catcherPathFormat\":\"/storage/image/{yyyy}{mm}{dd}/{time}{rand:6}\",\n" + " \"catcherUrlPrefix\":\"\",\n" + " \"catcherMaxSize\":2048000,\n" + " \"catcherAllowFiles\":[\n" + " \".png\",\n" + " \".jpg\",\n" + " \".jpeg\",\n" + " \".gif\",\n" + " \".bmp\"\n" + " ],\n" + " \"videoActionName\":\"uploadvideo\",\n" + " \"videoFieldName\":\"upfile\",\n" + " \"videoPathFormat\":\"/storage/video/{yyyy}{mm}{dd}/{time}{rand:6}\",\n" + " \"videoUrlPrefix\":\"\",\n" + " \"videoMaxSize\":102400000,\n" + " \"videoAllowFiles\":[\n" + " \".flv\",\n" + " \".swf\",\n" + " \".mkv\",\n" + " \".avi\",\n" + " \".rm\",\n" + " \".rmvb\",\n" + " \".mpeg\",\n" + " \".mpg\",\n" + " \".ogg\",\n" + " \".ogv\",\n" + " \".mov\",\n" + " \".wmv\",\n" + " \".mp4\",\n" + " \".webm\",\n" + " \".mp3\",\n" + " \".wav\",\n" + " \".mid\"\n" + " ],\n" + " \"fileActionName\":\"uploadfile\",\n" + " \"fileFieldName\":\"upfile\",\n" + " \"filePathFormat\":\"/storage/file/{yyyy}{mm}{dd}/{time}{rand:6}\",\n" + " \"fileUrlPrefix\":\"\",\n" + " \"fileMaxSize\":51200000,\n" + " \"fileAllowFiles\":[\n" + " \".png\",\n" + " \".jpg\",\n" + " \".jpeg\",\n" + " \".gif\",\n" + " \".bmp\",\n" + " \".flv\",\n" + " \".swf\",\n" + " \".mkv\",\n" + " \".avi\",\n" + " \".rm\",\n" + " \".rmvb\",\n" + " \".mpeg\",\n" + " \".mpg\",\n" + " \".ogg\",\n" + " \".ogv\",\n" + " \".mov\",\n" + " \".wmv\",\n" + " \".mp4\",\n" + " \".webm\",\n" + " \".mp3\",\n" + " \".wav\",\n" + " \".mid\",\n" + " \".rar\",\n" + " \".zip\",\n" + " \".tar\",\n" + " \".gz\",\n" + " \".7z\",\n" + " \".bz2\",\n" + " \".cab\",\n" + " \".iso\",\n" + " \".doc\",\n" + " \".docx\",\n" + " \".xls\",\n" + " \".xlsx\",\n" + " \".ppt\",\n" + " \".pptx\",\n" + " \".pdf\",\n" + " \".txt\",\n" + " \".md\",\n" + " \".xml\"\n" + " ],\n" + " \"imageManagerActionName\":\"listimage\",\n" + " \"imageManagerListPath\":\"/storage/image/\",\n" + " \"imageManagerListSize\":20,\n" + " \"imageManagerUrlPrefix\":\"\",\n" + " \"imageManagerInsertAlign\":\"none\",\n" + " \"imageManagerAllowFiles\":[\n" + " \".png\",\n" + " \".jpg\",\n" + " \".jpeg\",\n" + " \".gif\",\n" + " \".bmp\"\n" + " ],\n" + " \"fileManagerActionName\":\"listfile\",\n" + " \"fileManagerListPath\":\"/storage/file/\",\n" + " \"fileManagerUrlPrefix\":\"\",\n" + " \"fileManagerListSize\":20,\n" + " \"fileManagerAllowFiles\":[\n" + " \".png\",\n" + " \".jpg\",\n" + " \".jpeg\",\n" + " \".gif\",\n" + " \".bmp\",\n" + " \".flv\",\n" + " \".swf\",\n" + " \".mkv\",\n" + " \".avi\",\n" + " \".rm\",\n" + " \".rmvb\",\n" + " \".mpeg\",\n" + " \".mpg\",\n" + " \".ogg\",\n" + " \".ogv\",\n" + " \".mov\",\n" + " \".wmv\",\n" + " \".mp4\",\n" + " \".webm\",\n" + " \".mp3\",\n" + " \".wav\",\n" + " \".mid\",\n" + " \".rar\",\n" + " \".zip\",\n" + " \".tar\",\n" + " \".gz\",\n" + " \".7z\",\n" + " \".bz2\",\n" + " \".cab\",\n" + " \".iso\",\n" + " \".doc\",\n" + " \".docx\",\n" + " \".xls\",\n" + " \".xlsx\",\n" + " \".ppt\",\n" + " \".pptx\",\n" + " \".pdf\",\n" + " \".txt\",\n" + " \".md\",\n" + " \".xml\"\n" + " ]\n" + "}"; /** * Ueditor的返回状态类型 */ public enum UeditorMsg{ SUCCESS("SUCCESS"),ERROR("上传失败"); private String v; UeditorMsg(String v){ this.v =v; } public String get(){ return this.v; } } }

（3）UEditorController.java

package cn.stylefeng.guns.elephish.utils.ueditor; import cn.stylefeng.guns.core.common.exception.BizExceptionEnum; import cn.stylefeng.guns.elephish.constants.ConfigurableConstant; import cn.stylefeng.guns.elephish.utils.fastdfs.FastDFSClientWrapper; import cn.stylefeng.guns.elephish.utils.fastdfs.FileType; import cn.stylefeng.roses.kernel.model.exception.ServiceException; import com.alibaba.fastjson.JSONObject; import com.google.common.collect.Maps; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.multipart.MultipartFile; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.IOException; import java.io.PrintWriter; import java.util.Map; /** */ @RestController public class UEditorController { private Logger logger = LoggerFactory.getLogger(getClass()); @Autowired private FastDFSClientWrapper fastDFSClientWrapper; /** * 初始化时，让PublicMsg替换原配置文件config.json * @param request * @return */ @RequestMapping("/ueditor") public void ueditorConfig(HttpServletRequest request, HttpServletResponse response, @RequestParam(value = "upfile",required = false) MultipartFile upfile) { logger.info("进入ueditorConfig==========="); response.setContentType("application/json;charset=utf-8"); // String rootPath = request.getSession().getServletContext().getRealPath("/"); try { String exec = null; String actionType = request.getParameter("action"); if ("config".equals(actionType)) { // 请求参数中的action若为"config",则标识此请求为获取富文本的config.json,且此请求为前端初始化富文本组件之后自动调用的 request.setCharacterEncoding( "utf-8" ); exec = PublicMsg.UEDITOR_CONFIG; } else if (upfile!=null &&!upfile.isEmpty()) { // 若action不是"config",则表示为上传文件操作,文件类型在config.json中都有体现 exec = uploadImage(upfile); }else{ return ; } PrintWriter writer = response.getWriter(); writer.write(exec); writer.flush(); writer.close(); } catch (IOException e) { logger.error("UeditorController-->ueditorConfig exception:", e); } } /** * 图片上传 * @param file * @return */ private String uploadImage(MultipartFile file) { logger.info("进入上传.....ueditor"); try{ // 判断文件类型 String suffix = FileType.getSuffix(file.getContentType()); if (suffix == null) { // logger.info("暂不支持当前类型的文件上传:"+suffix); throw new ServiceException(BizExceptionEnum.FILE_TYPE_NONSUPPORT); } String fileUri = fastDFSClientWrapper.uploadFile(file.getBytes(),suffix); //fastdfs服务器的域名 String prefix = ConfigurableConstant.FILE_UPLOAD_SERVER_ADDRESS; return new JSONObject(resultMap("SUCCESS", prefix+fileUri, file.getSize(), file.getOriginalFilename(),file.getOriginalFilename(), file.getContentType())).toString(); }catch (Exception e){ // throw new ServiceException(BizExceptionEnum.UPLOAD_ERROR); return new JSONObject(resultMap("文件上传失败","",0, "","","")).toString(); } } // 返回前端的json格式,貌似富文本要求为此种格式,组件便与解析 private Map<String,Object> resultMap(String state, String url, long size, String title, String original, String type){ Map<String ,Object> result = Maps.newHashMap(); result.put("state",state); result.put("original",original); result.put("size",size); result.put("title",title); result.put("type",type); result.put("url", url); return result; } }

（4）ConfigurableConstant.java

package cn.stylefeng.guns.elephish.constants; /** * 可以配置的常量，通常是生产和测试环境时需要改变的常量 * */ public interface ConfigurableConstant { /** * 测试环境下 fastdfs文件服务器的ip地址 */ String FILE_UPLOAD_SERVER_ADDRESS = "http://192.168.0.115/"; }

（5）FileType.java

package cn.stylefeng.guns.elephish.utils.fastdfs; import org.apache.commons.lang3.StringUtils; /** * 定义了用户允许上传的文件类型 * @ClassName: FileType * @author hqq * */ public enum FileType { JPG("image/jpeg", "jpg") ,PNG("image/png","png") // ,PDF("application/pdf","pdf") // ,TXT("text/plain","txt") // ,DOC("application/msword","doc") // ,DOCX("application/vnd.openxmlformats-officedocument.wordprocessingml.document","docx") // ,XLS("application/vnd.ms-excel","xls") // ,XLS2("application/octet-stream","xls") // ,XLSM("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet","xlsm") // ,XLSX("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet","xlsx") ; //属性 private String contentType; private String suffix; // 构造方法 FileType(String contentType,String suffix ){ this.contentType=contentType; this.suffix=suffix; } /** * 传入contentType,获取后缀名 * @param contentType * @return 返回对应的后缀名，没有值就返回null */ public static String getSuffix(String contentType){ if(StringUtils.isBlank(contentType)){ return null; } for(FileType tf:FileType.values()){ if(StringUtils.endsWithIgnoreCase(contentType,tf.getContentType())){ return tf.getSuffix(); } } return null; } public String getContentType() { return contentType; } public void setContentType(String contentType) { this.contentType = contentType; } public String getSuffix() { return suffix; } public void setSuffix(String suffix) { this.suffix = suffix; } }

（6）jquery.base64.js

/*! * jquery.base64.js 0.1 - https://github.com/yckart/jquery.base64.js * Makes Base64 en & -decoding simpler as it is. * * Based upon: https://gist.github.com/Yaffle/1284012 * * Copyright (c) 2012 Yannick Albert (http://yckart.com) * Licensed under the MIT license (http://www.opensource.org/licenses/mit-license.php). * 2013/02/10 **/ ;(function($) { var b64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/", a256 = '', r64 = [256], r256 = [256], i = 0; var UTF8 = { /** * Encode multi-byte Unicode string into utf-8 multiple single-byte characters * (BMP / basic multilingual plane only) * * Chars in range U+0080 - U+07FF are encoded in 2 chars, U+0800 - U+FFFF in 3 chars * * @param {String} strUni Unicode string to be encoded as UTF-8 * @returns {String} encoded string */ encode: function(strUni) { // use regular expressions & String.replace callback function for better efficiency // than procedural approaches var strUtf = strUni.replace(/[\u0080-\u07ff]/g, // U+0080 - U+07FF => 2 bytes 110yyyyy, 10zzzzzz function(c) { var cc = c.charCodeAt(0); return String.fromCharCode(0xc0 | cc >> 6, 0x80 | cc & 0x3f); }) .replace(/[\u0800-\uffff]/g, // U+0800 - U+FFFF => 3 bytes 1110xxxx, 10yyyyyy, 10zzzzzz function(c) { var cc = c.charCodeAt(0); return String.fromCharCode(0xe0 | cc >> 12, 0x80 | cc >> 6 & 0x3F, 0x80 | cc & 0x3f); }); return strUtf; }, /** * Decode utf-8 encoded string back into multi-byte Unicode characters * * @param {String} strUtf UTF-8 string to be decoded back to Unicode * @returns {String} decoded string */ decode: function(strUtf) { // note: decode 3-byte chars first as decoded 2-byte strings could appear to be 3-byte char! var strUni = strUtf.replace(/[\u00e0-\u00ef][\u0080-\u00bf][\u0080-\u00bf]/g, // 3-byte chars function(c) { // (note parentheses for precence) var cc = ((c.charCodeAt(0) & 0x0f) << 12) | ((c.charCodeAt(1) & 0x3f) << 6) | (c.charCodeAt(2) & 0x3f); return String.fromCharCode(cc); }) .replace(/[\u00c0-\u00df][\u0080-\u00bf]/g, // 2-byte chars function(c) { // (note parentheses for precence) var cc = (c.charCodeAt(0) & 0x1f) << 6 | c.charCodeAt(1) & 0x3f; return String.fromCharCode(cc); }); return strUni; } }; while(i < 256) { var c = String.fromCharCode(i); a256 += c; r256[i] = i; r64[i] = b64.indexOf(c); ++i; } function code(s, discard, alpha, beta, w1, w2) { s = String(s); var buffer = 0, i = 0, length = s.length, result = '', bitsInBuffer = 0; while(i < length) { var c = s.charCodeAt(i); c = c < 256 ? alpha[c] : -1; buffer = (buffer << w1) + c; bitsInBuffer += w1; while(bitsInBuffer >= w2) { bitsInBuffer -= w2; var tmp = buffer >> bitsInBuffer; result += beta.charAt(tmp); buffer ^= tmp << bitsInBuffer; } ++i; } if(!discard && bitsInBuffer > 0) result += beta.charAt(buffer << (w2 - bitsInBuffer)); return result; } var Plugin = $.base64 = function(dir, input, encode) { return input ? Plugin[dir](input, encode) : dir ? null : this; }; Plugin.btoa = Plugin.encode = function(plain, utf8encode) { plain = Plugin.raw === false || Plugin.utf8encode || utf8encode ? UTF8.encode(plain) : plain; plain = code(plain, false, r256, b64, 8, 6); return plain + '===='.slice((plain.length % 4) || 4); }; Plugin.atob = Plugin.decode = function(coded, utf8decode) { coded = String(coded).split('='); var i = coded.length; do {--i; coded[i] = code(coded[i], true, r64, a256, 6, 8); } while (i > 0); coded = coded.join(''); return Plugin.raw === false || Plugin.utf8decode || utf8decode ? UTF8.decode(coded) : coded; }; }(jQuery));

（7）ueditor.config.js

/** * ueditor完整配置项 * 可以在这里配置整个编辑器的特性 */ /**************************提示******************************** * 所有被注释的配置项均为UEditor默认值。 * 修改默认配置请首先确保已经完全明确该参数的真实用途。 * 主要有两种修改方案，一种是取消此处注释，然后修改成对应参数；另一种是在实例化编辑器时传入对应参数。 * 当升级编辑器时，可直接使用旧版配置文件替换新版配置文件,不用担心旧版配置文件中因缺少新功能所需的参数而导致脚本报错。 **************************提示********************************/ (function () { /** * 编辑器资源文件根路径。它所表示的含义是：以编辑器实例化页面为当前路径，指向编辑器资源文件（即dialog等文件夹）的路径。 * 鉴于很多同学在使用编辑器的时候出现的种种路径问题，此处强烈建议大家使用"相对于网站根目录的相对路径"进行配置。 * "相对于网站根目录的相对路径"也就是以斜杠开头的形如"/myProject/ueditor/"这样的路径。 * 如果站点中有多个不在同一层级的页面需要实例化编辑器，且引用了同一UEditor的时候，此处的URL可能不适用于每个页面的编辑器。 * 因此，UEditor提供了针对不同页面的编辑器可单独配置的根路径，具体来说，在需要实例化编辑器的页面最顶部写上如下代码即可。当然，需要令此处的URL等于对应的配置。 * window.UEDITOR_HOME_URL = "/xxxx/xxxx/"; */ var URL = window.UEDITOR_HOME_URL || getUEBasePath(); /** * 配置项主体。注意，此处所有涉及到路径的配置别遗漏URL变量。 */ window.UEDITOR_CONFIG = { //为编辑器实例添加一个路径，这个不能被注释 UEDITOR_HOME_URL: URL // 服务器统一请求接口路径 // , serverUrl: URL + "jsp/controller.jsp" , serverUrl: Feng.ctxPath+"/ueditor" //工具栏上的所有的功能按钮和下拉框，可以在new编辑器的实例时选择自己需要的重新定义 , toolbars: [[ 'fullscreen', 'source', '|', 'undo', 'redo', '|', 'bold', 'italic', 'underline', 'fontborder', 'strikethrough', 'superscript', 'subscript', 'removeformat', 'formatmatch', 'autotypeset', 'blockquote', 'pasteplain', '|', 'forecolor', 'backcolor', 'insertorderedlist', 'insertunorderedlist', 'selectall', 'cleardoc', '|', 'rowspacingtop', 'rowspacingbottom', 'lineheight', '|', 'customstyle', 'paragraph', 'fontfamily', 'fontsize', '|', 'directionalityltr', 'directionalityrtl', 'indent', '|', 'justifyleft', 'justifycenter', 'justifyright', 'justifyjustify', '|', 'touppercase', 'tolowercase', '|', 'link', 'unlink', 'anchor', '|', 'imagenone', 'imageleft', 'imageright', 'imagecenter', '|', 'simpleupload', 'insertimage', 'emotion', 'scrawl', 'insertvideo', 'music', 'attachment', 'map', 'gmap', 'insertframe', 'insertcode', 'webapp', 'pagebreak', 'template', 'background', '|', 'horizontal', 'date', 'time', 'spechars', 'snapscreen', 'wordimage', '|', 'inserttable', 'deletetable', 'insertparagraphbeforetable', 'insertrow', 'deleterow', 'insertcol', 'deletecol', 'mergecells', 'mergeright', 'mergedown', 'splittocells', 'splittorows', 'splittocols', 'charts', '|', 'print', 'preview', 'searchreplace', 'drafts', 'help' ]] //当鼠标放在工具栏上时显示的tooltip提示,留空支持自动多语言配置，否则以配置值为准 //,labelMap:{ // 'anchor':'', 'undo':'' //} //语言配置项,默认是zh-cn。有需要的话也可以使用如下这样的方式来自动多语言切换，当然，前提条件是lang文件夹下存在对应的语言文件： //lang值也可以通过自动获取 (navigator.language||navigator.browserLanguage ||navigator.userLanguage).toLowerCase() //,lang:"zh-cn" //,langPath:URL +"lang/" //主题配置项,默认是default。有需要的话也可以使用如下这样的方式来自动多主题切换，当然，前提条件是themes文件夹下存在对应的主题文件： //现有如下皮肤:default //,theme:'default' //,themePath:URL +"themes/" //,zIndex : 900 //编辑器层级的基数,默认是900 //针对getAllHtml方法，会在对应的head标签中增加该编码设置。 //,charset:"utf-8" //若实例化编辑器的页面手动修改的domain，此处需要设置为true //,customDomain:false //常用配置项目 //,isShow : true //默认显示编辑器 //,textarea:'editorValue' // 提交表单时，服务器获取编辑器提交内容的所用的参数，多实例时可以给容器name属性，会将name给定的值最为每个实例的键值，不用每次实例化的时候都设置这个值 //,initialContent:'欢迎使用ueditor!' //初始化编辑器的内容,也可以通过textarea/script给值，看官网例子 //,autoClearinitialContent:true //是否自动清除编辑器初始内容，注意：如果focus属性设置为true,这个也为真，那么编辑器一上来就会触发导致初始化的内容看不到了 //,focus:false //初始化时，是否让编辑器获得焦点true或false //如果自定义，最好给p标签如下的行高，要不输入中文时，会有跳动感 //,initialStyle:'p{line-height:1em}'//编辑器层级的基数,可以用来改变字体等 //,iframeCssUrl: URL + '/themes/iframe.css' //给编辑区域的iframe引入一个css文件 //indentValue //首行缩进距离,默认是2em //,indentValue:'2em' //,initialFrameWidth:1000 //初始化编辑器宽度,默认1000 //,initialFrameHeight:320 //初始化编辑器高度,默认320 //,readonly : false //编辑器初始化结束后,编辑区域是否是只读的，默认是false //,autoClearEmptyNode : true //getContent时，是否删除空的inlineElement节点（包括嵌套的情况） //启用自动保存 //,enableAutoSave: true //自动保存间隔时间，单位ms //,saveInterval: 500 //,fullscreen : false //是否开启初始化时即全屏，默认关闭 //,imagePopup:true //图片操作的浮层开关，默认打开 //,autoSyncData:true //自动同步编辑器要提交的数据 //,emotionLocalization:false //是否开启表情本地化，默认关闭。若要开启请确保emotion文件夹下包含官网提供的images表情文件夹 //粘贴只保留标签，去除标签所有属性 //,retainOnlyLabelPasted: false //,pasteplain:false //是否默认为纯文本粘贴。false为不使用纯文本粘贴，true为使用纯文本粘贴 //纯文本粘贴模式下的过滤规则 //'filterTxtRules' : function(){ // function transP(node){ // node.tagName = 'p'; // node.setStyle(); // } // return { // //直接删除及其字节点内容 // '-' : 'script style object iframe embed input select', // 'p': {$:{}}, // 'br':{$:{}}, // 'div':{'$':{}}, // 'li':{'$':{}}, // 'caption':transP, // 'th':transP, // 'tr':transP, // 'h1':transP,'h2':transP,'h3':transP,'h4':transP,'h5':transP,'h6':transP, // 'td':function(node){ // //没有内容的td直接删掉 // var txt = !!node.innerText(); // if(txt){ // node.parentNode.insertAfter(UE.uNode.createText(' '),node); // } // node.parentNode.removeChild(node,node.innerText()) // } // } //}() //,allHtmlEnabled:false //提交到后台的数据是否包含整个html字符串 //insertorderedlist //有序列表的下拉配置,值留空时支持多语言自动识别，若配置值，则以此值为准 //,'insertorderedlist':{ // //自定的样式 // 'num':'1,2,3...', // 'num1':'1),2),3)...', // 'num2':'(1),(2),(3)...', // 'cn':'一,二,三....', // 'cn1':'一),二),三)....', // 'cn2':'(一),(二),(三)....', // //系统自带 // 'decimal' : '' , //'1,2,3...' // 'lower-alpha' : '' , // 'a,b,c...' // 'lower-roman' : '' , //'i,ii,iii...' // 'upper-alpha' : '' , lang //'A,B,C' // 'upper-roman' : '' //'I,II,III...' //} //insertunorderedlist //无序列表的下拉配置，值留空时支持多语言自动识别，若配置值，则以此值为准 //,insertunorderedlist : { //自定的样式 // 'dash' :'— 破折号', //-破折号 // 'dot':' 。小圆圈', //系统自带 // 'circle' : '', // '○ 小圆圈' // 'disc' : '', // '● 小圆点' // 'square' : '' //'■ 小方块' //} //,listDefaultPaddingLeft : '30'//默认的左边缩进的基数倍 //,listiconpath : 'http://bs.baidu.com/listicon/'//自定义标号的路径 //,maxListLevel : 3 //限制可以tab的级数, 设置-1为不限制 //,autoTransWordToList:false //禁止word中粘贴进来的列表自动变成列表标签 //fontfamily //字体设置 label留空支持多语言自动切换，若配置，则以配置值为准 //,'fontfamily':[ // { label:'',name:'songti',val:'宋体,SimSun'}, // { label:'',name:'kaiti',val:'楷体,楷体_GB2312, SimKai'}, // { label:'',name:'yahei',val:'微软雅黑,Microsoft YaHei'}, // { label:'',name:'heiti',val:'黑体, SimHei'}, // { label:'',name:'lishu',val:'隶书, SimLi'}, // { label:'',name:'andaleMono',val:'andale mono'}, // { label:'',name:'arial',val:'arial, helvetica,sans-serif'}, // { label:'',name:'arialBlack',val:'arial black,avant garde'}, // { label:'',name:'comicSansMs',val:'comic sans ms'}, // { label:'',name:'impact',val:'impact,chicago'}, // { label:'',name:'timesNewRoman',val:'times new roman'} //] //fontsize //字号 //,'fontsize':[10, 11, 12, 14, 16, 18, 20, 24, 36] //paragraph //段落格式值留空时支持多语言自动识别，若配置，则以配置值为准 //,'paragraph':{'p':'', 'h1':'', 'h2':'', 'h3':'', 'h4':'', 'h5':'', 'h6':''} //rowspacingtop //段间距值和显示的名字相同 //,'rowspacingtop':['5', '10', '15', '20', '25'] //rowspacingBottom //段间距值和显示的名字相同 //,'rowspacingbottom':['5', '10', '15', '20', '25'] //lineheight //行内间距值和显示的名字相同 //,'lineheight':['1', '1.5','1.75','2', '3', '4', '5'] //customstyle //自定义样式，不支持国际化，此处配置值即可最后显示值 //block的元素是依据设置段落的逻辑设置的，inline的元素依据BIU的逻辑设置 //尽量使用一些常用的标签 //参数说明 //tag 使用的标签名字 //label 显示的名字也是用来标识不同类型的标识符，注意这个值每个要不同， //style 添加的样式 //每一个对象就是一个自定义的样式 //,'customstyle':[ // {tag:'h1', name:'tc', label:'', style:'border-bottom:#ccc 2px solid;padding:0 4px 0 0;text-align:center;margin:0 0 20px 0;'}, // {tag:'h1', name:'tl',label:'', style:'border-bottom:#ccc 2px solid;padding:0 4px 0 0;margin:0 0 10px 0;'}, // {tag:'span',name:'im', label:'', style:'font-style:italic;font-weight:bold'}, // {tag:'span',name:'hi', label:'', style:'font-style:italic;font-weight:bold;color:rgb(51, 153, 204)'} //] //打开右键菜单功能 //,enableContextMenu: true //右键菜单的内容，可以参考plugins/contextmenu.js里边的默认菜单的例子，label留空支持国际化，否则以此配置为准 //,contextMenu:[ // { // label:'', //显示的名称 // cmdName:'selectall',//执行的command命令，当点击这个右键菜单时 // //exec可选，有了exec就会在点击时执行这个function，优先级高于cmdName // exec:function () { // //this是当前编辑器的实例 // //this.ui._dialogs['inserttableDialog'].open(); // } // } //] //快捷菜单 //,shortcutMenu:["fontfamily", "fontsize", "bold", "italic", "underline", "forecolor", "backcolor", "insertorderedlist", "insertunorderedlist"] //elementPathEnabled //是否启用元素路径，默认是显示 //,elementPathEnabled : true //wordCount //,wordCount:true //是否开启字数统计 //,maximumWords:10000 //允许的最大字符数 //字数统计提示，{#count}代表当前字数，{#leave}代表还可以输入多少字符数,留空支持多语言自动切换，否则按此配置显示 //,wordCountMsg:'' //当前已输入 {#count} 个字符，您还可以输入{#leave} 个字符 //超出字数限制提示留空支持多语言自动切换，否则按此配置显示 //,wordOverFlowMsg:'' //<span style="color:red;">你输入的字符个数已经超出最大允许值，服务器可能会拒绝保存！</span> //tab //点击tab键时移动的距离,tabSize倍数，tabNode什么字符做为单位 //,tabSize:4 //,tabNode:' ' //removeFormat //清除格式时可以删除的标签和属性 //removeForamtTags标签 //,removeFormatTags:'b,big,code,del,dfn,em,font,i,ins,kbd,q,samp,small,span,strike,strong,sub,sup,tt,u,var' //removeFormatAttributes属性 //,removeFormatAttributes:'class,style,lang,width,height,align,hspace,valign' //undo //可以最多回退的次数,默认20 //,maxUndoCount:20 //当输入的字符数超过该值时，保存一次现场 //,maxInputCount:1 //autoHeightEnabled // 是否自动长高,默认true //,autoHeightEnabled:true //scaleEnabled //是否可以拉伸长高,默认true(当开启时，自动长高失效) //,scaleEnabled:false //,minFrameWidth:800 //编辑器拖动时最小宽度,默认800 //,minFrameHeight:220 //编辑器拖动时最小高度,默认220 //autoFloatEnabled //是否保持toolbar的位置不动,默认true //,autoFloatEnabled:true //浮动时工具栏距离浏览器顶部的高度，用于某些具有固定头部的页面 //,topOffset:30 //编辑器底部距离工具栏高度(如果参数大于等于编辑器高度，则设置无效) //,toolbarTopOffset:400 //设置远程图片是否抓取到本地保存 //,catchRemoteImageEnable: true //设置是否抓取远程图片 //pageBreakTag //分页标识符,默认是_ueditor_page_break_tag_ //,pageBreakTag:'_ueditor_page_break_tag_' //autotypeset //自动排版参数 //,autotypeset: { // mergeEmptyline: true, //合并空行 // removeClass: true, //去掉冗余的class // removeEmptyline: false, //去掉空行 // textAlign:"left", //段落的排版方式，可以是 left,right,center,justify 去掉这个属性表示不执行排版 // imageBlockLine: 'center', //图片的浮动方式，独占一行剧中,左右浮动，默认: center,left,right,none 去掉这个属性表示不执行排版 // pasteFilter: false, //根据规则过滤没事粘贴进来的内容 // clearFontSize: false, //去掉所有的内嵌字号，使用编辑器默认的字号 // clearFontFamily: false, //去掉所有的内嵌字体，使用编辑器默认的字体 // removeEmptyNode: false, // 去掉空节点 // //可以去掉的标签 // removeTagNames: {标签名字:1}, // indent: false, // 行首缩进 // indentValue : '2em', //行首缩进的大小 // bdc2sb: false, // tobdc: false //} //tableDragable //表格是否可以拖拽 //,tableDragable: true //sourceEditor //源码的查看方式,codemirror 是代码高亮，textarea是文本框,默认是codemirror //注意默认codemirror只能在ie8+和非ie中使用 //,sourceEditor:"codemirror" //如果sourceEditor是codemirror，还用配置一下两个参数 //codeMirrorJsUrl js加载的路径，默认是 URL + "third-party/codemirror/codemirror.js" //,codeMirrorJsUrl:URL + "third-party/codemirror/codemirror.js" //codeMirrorCssUrl css加载的路径，默认是 URL + "third-party/codemirror/codemirror.css" //,codeMirrorCssUrl:URL + "third-party/codemirror/codemirror.css" //编辑器初始化完成后是否进入源码模式，默认为否。 //,sourceEditorFirst:false //iframeUrlMap //dialog内容的路径～会被替换成URL,垓属性一旦打开，将覆盖所有的dialog的默认路径 //,iframeUrlMap:{ // 'anchor':'~/dialogs/anchor/anchor.html', //} //allowLinkProtocol 允许的链接地址，有这些前缀的链接地址不会自动添加http //, allowLinkProtocols: ['http:', 'https:', '#', '/', 'ftp:', 'mailto:', 'tel:', 'git:', 'svn:'] //webAppKey 百度应用的APIkey，每个站长必须首先去百度官网注册一个key后方能正常使用app功能，注册介绍，http://app.baidu.com/static/cms/getapikey.html //, webAppKey: "" //默认过滤规则相关配置项目 //,disabledTableInTable:true //禁止表格嵌套 //,allowDivTransToP:true //允许进入编辑器的div标签自动变成p标签 //,rgb2Hex:true //默认产出的数据中的color自动从rgb格式变成16进制格式 // xss 过滤是否开启,inserthtml等操作 ,xssFilterRules: true //input xss过滤 ,inputXssFilter: true //output xss过滤 ,outputXssFilter: true // xss过滤白名单名单来源: https://raw.githubusercontent.com/leizongmin/js-xss/master/lib/default.js ,whitList: { a: ['target', 'href', 'title', 'class', 'style'], abbr: ['title', 'class', 'style'], address: ['class', 'style'], area: ['shape', 'coords', 'href', 'alt'], article: [], aside: [], audio: ['autoplay', 'controls', 'loop', 'preload', 'src', 'class', 'style'], b: ['class', 'style'], bdi: ['dir'], bdo: ['dir'], big: [], blockquote: ['cite', 'class', 'style'], br: [], caption: ['class', 'style'], center: [], cite: [], code: ['class', 'style'], col: ['align', 'valign', 'span', 'width', 'class', 'style'], colgroup: ['align', 'valign', 'span', 'width', 'class', 'style'], dd: ['class', 'style'], del: ['datetime'], details: ['open'], div: ['class', 'style'], dl: ['class', 'style'], dt: ['class', 'style'], em: ['class', 'style'], font: ['color', 'size', 'face'], footer: [], h1: ['class', 'style'], h2: ['class', 'style'], h3: ['class', 'style'], h4: ['class', 'style'], h5: ['class', 'style'], h6: ['class', 'style'], header: [], hr: [], i: ['class', 'style'], img: ['src', 'alt', 'title', 'width', 'height', 'id', '_src', 'loadingclass', 'class', 'data-latex'], ins: ['datetime'], li: ['class', 'style'], mark: [], nav: [], ol: ['class', 'style'], p: ['class', 'style'], pre: ['class', 'style'], s: [], section:[], small: [], span: ['class', 'style'], sub: ['class', 'style'], sup: ['class', 'style'], strong: ['class', 'style'], table: ['width', 'border', 'align', 'valign', 'class', 'style'], tbody: ['align', 'valign', 'class', 'style'], td: ['width', 'rowspan', 'colspan', 'align', 'valign', 'class', 'style'], tfoot: ['align', 'valign', 'class', 'style'], th: ['width', 'rowspan', 'colspan', 'align', 'valign', 'class', 'style'], thead: ['align', 'valign', 'class', 'style'], tr: ['rowspan', 'align', 'valign', 'class', 'style'], tt: [], u: [], ul: ['class', 'style'], video: ['autoplay', 'controls', 'loop', 'preload', 'src', 'height', 'width', 'class', 'style'] } }; function getUEBasePath(docUrl, confUrl) { return getBasePath(docUrl || self.document.URL || self.location.href, confUrl || getConfigFilePath()); } function getConfigFilePath() { var configPath = document.getElementsByTagName('script'); return configPath[ configPath.length - 1 ].src; } function getBasePath(docUrl, confUrl) { var basePath = confUrl; if (/^(\/|\\\\)/.test(confUrl)) { basePath = /^.+?\w(\/|\\\\)/.exec(docUrl)[0] + confUrl.replace(/^(\/|\\\\)/, ''); } else if (!/^[a-z]+:/i.test(confUrl)) { docUrl = docUrl.split("#")[0].split("?")[0].replace(/[^\\\/]+$/, ''); basePath = docUrl + "" + confUrl; } return optimizationPath(basePath); } function optimizationPath(path) { var protocol = /^[a-z]+:\/\//.exec(path)[ 0 ], tmp = null, res = []; path = path.replace(protocol, "").split("?")[0].split("#")[0]; path = path.replace(/\\/g, '/').split(/\//); path[ path.length - 1 ] = ""; while (path.length) { if (( tmp = path.shift() ) === "..") { res.pop(); } else if (tmp !== ".") { res.push(tmp); } } return protocol + res.join("/"); } window.UE = { getUEBasePath: getUEBasePath }; })();

（8）添加页面的核心代码

<div> <div class="basic_info"> <div class="basic_title"><strong style="color:green;text-align:center;font-size: large">商品详情</strong></div><br/> <div id="editor" class="row"></div> </div><br/><hr/><br/> </div> <script> $(function(){ UE.Editor.prototype._bkGetActionUrl = UE.Editor.prototype.getActionUrl; UE.Editor.prototype.getActionUrl = function(action) { if (action == 'uploadimage' || action == 'uploadscrawl' || action == 'uploadfile') { return Feng.ctxPath+'/ueditor'; } else { return this._bkGetActionUrl.call(this, action); } } var ue=UE.getEditor('editor'); //js中 }) </script> <script src="${ctxPath}/static/modular/elephish/common/jquery.base64.js?j=${date().time}"></script> <script src="${ctxPath}/static/js/plugins/ueditor/ueditor.config.js?j=${date().time}" type="text/javascript" charset="utf-8" ></script> <script src="${ctxPath}/static/js/plugins/ueditor/ueditor.all.js?j=${date().time}" type="text/javascript" charset="utf-8" > </script> <script src="${ctxPath}/static/js/plugins/ueditor/lang/zh-cn/zh-cn.js?j=${date().time}" type="text/javascript" charset="utf-8" ></script>

（9）修改页面的核心代码

<div>  <div id="productDetail" style="display: none;">${item.detail}</div> <div class="basic_info"> <div class="basic_title"><strong style="color:green;text-align:center;font-size: large">商品详情</strong></div><br/> <div id="editor" class="row"></div> </div><br/><hr/><br/> <div class="publish_goods" onclick="ProductInfoDlg.editSubmit()">保存商品</div> </div> <script> $(function(){ UE.Editor.prototype._bkGetActionUrl = UE.Editor.prototype.getActionUrl; UE.Editor.prototype.getActionUrl = function(action) { if (action == 'uploadimage' || action == 'uploadscrawl' || action == 'uploadfile') { return Feng.ctxPath+'/ueditor'; } else { return this._bkGetActionUrl.call(this, action); } } var ue=UE.getEditor('editor'); //js中 //获取后天返回的富文本内容 var detail =$("#productDetail").html(); if(detail){ ue.addListener("ready", function () { //富文本框中回显之前保存的内容，注意此处需要先用base64解密，因为保存的时候加密了 ue.setContent($.base64.atob(detail, true)); }); } }) </script> <script src="${ctxPath}/static/modular/elephish/common/jquery.base64.js?j=${date().time}"></script> <script src="${ctxPath}/static/js/plugins/ueditor/ueditor.config.js?j=${date().time}" type="text/javascript" charset="utf-8" ></script> <script src="${ctxPath}/static/js/plugins/ueditor/ueditor.all.js?j=${date().time}" type="text/javascript" charset="utf-8" > </script> <script src="${ctxPath}/static/js/plugins/ueditor/lang/zh-cn/zh-cn.js?j=${date().time}" type="text/javascript" charset="utf-8" ></script>

至此，功能实现。

参考资料：

springboot集成Ueditor(踩坑)

UEditor后端配置项说明

spring boot 整合百度ueditor富文本

该系列更多文章请前往 Guns二次开发目录

Processed: 0.012, SQL: 9