视频1 视频21 视频41 视频61 视频文章1 视频文章21 视频文章41 视频文章61 推荐1 推荐3 推荐5 推荐7 推荐9 推荐11 推荐13 推荐15 推荐17 推荐19 推荐21 推荐23 推荐25 推荐27 推荐29 推荐31 推荐33 推荐35 推荐37 推荐39 推荐41 推荐43 推荐45 推荐47 推荐49 关键词1 关键词101 关键词201 关键词301 关键词401 关键词501 关键词601 关键词701 关键词801 关键词901 关键词1001 关键词1101 关键词1201 关键词1301 关键词1401 关键词1501 关键词1601 关键词1701 关键词1801 关键词1901 视频扩展1 视频扩展6 视频扩展11 视频扩展16 文章1 文章201 文章401 文章601 文章801 文章1001 资讯1 资讯501 资讯1001 资讯1501 标签1 标签501 标签1001 关键词1 关键词501 关键词1001 关键词1501 专题2001
基于BootStrap的文本编辑器组件Summernote
2020-11-27 22:26:34 责编:小采
文档


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

特点:

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

极易安装

开源

自定义初化选项

支持快捷键

适用于各种后端程序言语

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

这是官网的一个例子:

<!DOCTYPE html>
<html lang="en">
<head>
 <meta charset="UTF-8">
 <title>Summernote</title>
 <link href="http://netdna.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.css" rel="external nofollow" rel="stylesheet">
 <script src="http://cdnjs.cloudflare.com/ajax/libs/jquery/3.2.1/jquery.js"></script> 
 <script src="http://netdna.bootstrapcdn.com/bootstrap/3.3.5/js/bootstrap.js"></script> 
 <link href="http://cdnjs.cloudflare.com/ajax/libs/summernote/0.8.8/summernote.css" rel="external nofollow" rel="stylesheet">
 <script src="http://cdnjs.cloudflare.com/ajax/libs/summernote/0.8.8/summernote.js"></script>
</head>
<body>
 <div id="summernote"><p>Hello Summernote</p></div>
 <script>
 $(document).ready(function() {
 $('#summernote').summernote();
 });
 </script>
</body>
</html>

效果图:

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

在<body>添加一个容器<div>:

<div id="summernote">Hello Summernote</div>

再用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,希望对大家有所帮助,如果大家有任何疑问请给我留言,小编会及时回复大家的。在此也非常感谢大家对脚本之家网站的支持!

下载本文
显示全文
专题