基于BootStrap的文本编辑器组件Summernote

2022-01-14,,,,

Summernote是一个基于jquery的bootstrap超级简单WYSIWYG在线编辑器。这篇文章主要介绍了基于BootStrap的文本编辑器组件Summernote的相关资料,需要的朋友可以参考下

Summernote是一个基于jquery的bootstrap超级简单WYSIWYG在线编辑器。Summernote非常的轻量级,大小只有30KB,支持Safari,Chrome,Firefox、Opera、Internet Explorer 9 +(IE8支持即将到来)。

特点:

世界上最好的WYSIWYG在线编辑器

极易安装

开源

自定义初化选项

支持快捷键

适用于各种后端程序言语

Summernote官网地址 :https://summernote.org/

这是官网的一个例子:

   Summernote 

Hello Summernote

效果图:

最简单的默认初始化组件的方式:

添加一个容器:

 Hello Summernote

再用Jquery初始化该组件:

 $(document).ready(function() { $('#summernote').summernote(); });

我们也可以自定义组件,如自定义编辑框的高度:

 $('#summernote').summernote({ height: 300,   // 定义编辑框高度 minHeight: null,  // 定义编辑框最低的高度 maxHeight: null,  // 定义编辑框最高德高度 });

我们还可以自定义工具栏:

  toolbar: [  ['fontname', ['fontname']], //字体系列 ['style', ['bold', 'italic', 'underline', 'clear']], // 字体粗体、字体斜体、字体下划线、字体格式清除 ['font', ['strikethrough', 'superscript', 'subscript']], //字体划线、字体上标、字体下标 ['fontsize', ['fontsize']], //字体大小 ['color', ['color']], //字体颜色  ['style', ['style']],//样式 ['para', ['ul', 'ol', 'paragraph']], //无序列表、有序列表、段落对齐方式 ['height', ['height']], //行高  ['table',['table']], //插入表格 ['hr',['hr']],//插入水平线 ['link',['link']], //插入链接 ['picture',['picture']], //插入图片 ['video',['video']], //插入视频  ['fullscreen',['fullscreen']], //全屏 ['codeview',['codeview']], //查看html代码 ['undo',['undo']], //撤销 ['redo',['redo']], //取消撤销 ['help',['help']], //帮助 ],

其它的一些初始化设置:

              lang:'zh-CN',  //设置中文,需引入中文插件summernote-zh-CN.js
              placeholder: 'write here...', //占位符
              dialogsInBody: true,  //对话框放在编辑框还是Body
              dialogsFade: true ,//对话框显示效果
              disableDragAndDrop: true ,//禁用拖放功能
              shortcuts: false ,//禁用快捷键

还有回调函数:

 callbacks: { }

回调函数里面的事件有 oninit,onenter,onfocus,onblur,onkeyup,onkeydown,onpaste,onImageUpload 等等,

这里主要介绍上传图片触发的事件 onImageUpload :

插入图片的时候,Summernote组件默认是将图片以二进制形式展示的,如果以此方式将文本框的内容存储到数据库时,会导致数据库数据量很大

这是summernote默认方式插入图片时存储到数据库的字段:

所以这里采用另一个方法,就是将图片上传到服务器,上传成功后回传图片的访问地址到插入的图片位置,展示图片;

具体实现如下:                                

 callbacks: { onImageUpload: function(file) { //图片默认以二进制的形式存储到数据库,调用此方法将请求后台将图片存储到服务器,返回图片请求地址到前端 //将图片放入Formdate对象中 var formData = new FormData(); //‘picture'为后台获取的文件名,file[0]是要上传的文件 formData.append("picture", file[0]); $.ajax({ type:'post', url:'请求后台地址', cache: false, data:formData, processData: false, contentType: false, dataType:'text', //请求成功后,后台返回图片访问地址字符串,故此以text格式获取,而不是json格式 success: function(picture) { $('#summernote').summernote('insertImage',picture); }, error:function(){ alert("上传失败"); } }); } }

后台处理请求存储图片到服务器,成功则返回图片访问地址:

 注意:我这里是将图片上传的真实地址和虚拟的图片访问地址在tomcat的server.xml中配置了映射关系,所以上传成功后返回给前端的是虚拟的访问地址;

 @RequestMapping(value="contentFileUpload",method=RequestMethod.POST) @ResponseBody public String contentFileUpload(MultipartFile picture) { if (picture!=null && picture.getOriginalFilename()!=null && picture.getOriginalFilename().trim().length()>0) { /** * picture上传路径(+时间文件夹) */ //真实的上传根路径 String realUploadPath = 'D:/Program Files (x86)/apache-tomcat-8.5.16/webapps/file'; //虚拟的文件访问根路径 String fictitiousRoot = '/file' //建立以时间命名的文件夹 SimpleDateFormat sdf=new SimpleDateFormat("/yyyy/MM/dd/"); String datePath = sdf.format(new Date()); //最终真实路径 String realuUploadBrandPath = realUploadPath+"/content"+datePath; //最终虚拟访问路径 String fictitiousUploadBrandPath =fictitiousRoot +"/content"+datePath; // 上传文件原始名称 String originFileName = picture.getOriginalFilename(); // 新的文件名称 String newFileName = UUID.randomUUID()+originFileName.substring(originFileName.lastIndexOf(".")); //如果路径文件夹不存在就创建 File dir=new File(realuUploadBrandPath); if(!dir.exists()){ dir.mkdirs(); } // 新文件 File newFile = new File(realuUploadBrandPath+File.separator+newFileName); // 将内存中的文件写入磁盘 try { picture.transferTo(newFile); } catch (IllegalStateException | IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } // 文件虚拟地址 String fictitiousFilePath = fictitiousUploadBrandPath+newFileName; return fictitiousFilePath; } return "false"; }

建议:真实的上传根路径应写在properties配置文件中,方便日后地址的修改,同时虚拟的访问根路径也不应存储到数据库当中,只需存储相对位置就可以,将虚拟的访问根路径也写在properties文件当中。

 通过上面的方法处理后,存储到数据库的字段:

 获取编辑框内容的方法:

 var markupStr = $('#summernote').summernote('code');

总结

以上就是基于BootStrap的文本编辑器组件Summernote的详细内容,更多请关注本站其它相关文章!

《基于BootStrap的文本编辑器组件Summernote.doc》

下载本文的Word格式文档,以方便收藏与打印。