相关文档
本文部分内容借鉴: https://www.cnblogs.com/zhongchao666/p/11142537.html
tinymce中文文档: http://tinymce.ax-z.cn/
安装tinymce
1、安装相关依赖
yarn add tinymce || npm install tinymce -S yarn add @tinymce/tinymce-vue || npm install @tinymce/tinymce-vue -S
2、汉化编辑器前往此地址下载中文汉化包: https://www.tiny.cloud/get-tiny/language-packages/
在项目public文件夹下新建tinymce文件夹,将下载后的压缩包解压至此文件夹另将node_modules/tinymce/skins文件夹也复制到public/tinymce里
3、封装组件:在src/components下新建TEditor.vue,并写入以下代码
<template> <div class=\"tinymce-box\"> <Editor v-model=\"contentValue\" :init=\"init\" :disabled=\"disabled\" @onClick=\"onClick\" /> </div> </template> <script> import api from \'../api/api.js\' //引入tinymce编辑器 import Editor from \'@tinymce/tinymce-vue\' //引入node_modules里的tinymce相关文件文件 import tinymce from \'tinymce/tinymce\' //tinymce默认hidden,不引入则不显示编辑器 import \'tinymce/themes/silver\' //编辑器主题,不引入则报错 import \'tinymce/icons/default\' //引入编辑器图标icon,不引入则不显示对应图标 // 引入编辑器插件(基本免费插件都在这儿了) import \'tinymce/plugins/advlist\' //高级列表 import \'tinymce/plugins/anchor\' //锚点 import \'tinymce/plugins/autolink\' //自动链接 import \'tinymce/plugins/autoresize\' //编辑器高度自适应,注:plugins里引入此插件时,Init里设置的height将失效 import \'tinymce/plugins/autosave\' //自动存稿 import \'tinymce/plugins/charmap\' //特殊字符 import \'tinymce/plugins/code\' //编辑源码 import \'tinymce/plugins/codesample\' //代码示例 import \'tinymce/plugins/directionality\' //文字方向 import \'tinymce/plugins/emoticons\' //表情 import \'tinymce/plugins/fullpage\' //文档属性 import \'tinymce/plugins/fullscreen\' //全屏 import \'tinymce/plugins/help\' //帮助 import \'tinymce/plugins/hr\' //水平分割线 import \'tinymce/plugins/image\' //插入编辑图片 import \'tinymce/plugins/importcss\' //引入css import \'tinymce/plugins/insertdatetime\' //插入日期时间 import \'tinymce/plugins/link\' //超链接 import \'tinymce/plugins/lists\' //列表插件 import \'tinymce/plugins/media\' //插入编辑媒体 import \'tinymce/plugins/nonbreaking\' //插入不间断空格 import \'tinymce/plugins/pagebreak\' //插入分页符 import \'tinymce/plugins/paste\' //粘贴插件 import \'tinymce/plugins/preview\'//预览 import \'tinymce/plugins/print\'//打印 import \'tinymce/plugins/quickbars\' //快速工具栏 import \'tinymce/plugins/save\' //保存 import \'tinymce/plugins/searchreplace\' //查找替换 // import \'tinymce/plugins/spellchecker\' //拼写检查,暂未加入汉化,不建议使用 import \'tinymce/plugins/tabfocus\' //切入切出,按tab键切出编辑器,切入页面其他输入框中 import \'tinymce/plugins/table\' //表格 import \'tinymce/plugins/template\' //内容模板 import \'tinymce/plugins/textcolor\' //文字颜色 import \'tinymce/plugins/textpattern\' //快速排版 import \'tinymce/plugins/toc\' //目录生成器 import \'tinymce/plugins/visualblocks\' //显示元素范围 import \'tinymce/plugins/visualchars\' //显示不可见字符 import \'tinymce/plugins/wordcount\' //字数统计 export default { name: \'TEditor\', components: { Editor }, props: { value: { type: String, default: \'\' }, disabled: { type: Boolean, default: false }, plugins: { type: [String, Array], default: \'print preview searchreplace autolink directionality visualblocks visualchars fullscreen image link media template code codesample table charmap hr pagebreak nonbreaking anchor insertdatetime advlist lists wordcount textpattern autosave \' }, toolbar: { type: [String, Array], default: \'fullscreen undo redo restoredraft | cut copy paste pastetext | forecolor backcolor bold italic underline strikethrough link anchor | alignleft aligncenter alignright alignjustify outdent indent | \\ styleselect formatselect fontselect fontsizeselect | bullist numlist | blockquote subscript superscript removeformat | \\ table image media charmap hr pagebreak insertdatetime print preview | code selectall searchreplace visualblocks | indent2em lineheight formatpainter axupimgs\' }, }, data(){ return { init: { language_url: \'/tinymce/langs/zh_CN.js\', //引入语言包文件 language: \'zh_CN\', //语言类型 skin_url: \'/tinymce/skins/ui/oxide\', //皮肤:浅色 // skin_url: \'/tinymce/skins/ui/oxide-dark\',//皮肤:暗色 plugins: this.plugins, //插件配置 toolbar: this.toolbar, //工具栏配置,设为false则隐藏 // menubar: \'file edit\', //菜单栏配置,设为false则隐藏,不配置则默认显示全部菜单,也可自定义配置--查看 http://tinymce.ax-z.cn/configure/editor-appearance.php --搜索“自定义菜单” fontsize_formats: \'12px 14px 16px 18px 20px 22px 24px 28px 32px 36px 48px 56px 72px\', //字体大小 font_formats: \'微软雅黑=Microsoft YaHei,Helvetica Neue,PingFang SC,sans-serif;苹果苹方=PingFang SC,Microsoft YaHei,sans-serif;宋体=simsun,serif;仿宋体=FangSong,serif;黑体=SimHei,sans-serif;Arial=arial,helvetica,sans-serif;Arial Black=arial black,avant garde;Book Antiqua=book antiqua,palatino;\', //字体样式 lineheight_formats: \"0.5 0.8 1 1.2 1.5 1.75 2 2.5 3 4 5\", //行高配置,也可配置成\"12px 14px 16px 20px\"这种形式 height: 400, //注:引入autoresize插件时,此属性失效 placeholder: \'在这里输入文字\', branding: false, //tiny技术支持信息是否显示 resize: false, //编辑器宽高是否可变,false-否,true-高可变,\'both\'-宽高均可,注意引号 // statusbar: false, //最下方的元素路径和字数统计那一栏是否显示 elementpath: false, //元素路径是否显示 content_style: \"img {max-width:100%;}\", //直接自定义可编辑区域的css样式 // content_css: \'/tinycontent.css\', //以css文件方式自定义可编辑区域的css样式,css文件需自己创建并引入 // images_upload_url: \'/apib/api-upload/uploadimg\', //后端处理程序的url,建议直接自定义上传函数image_upload_handler,这个就可以不用了 // images_upload_base_path: \'/demo\', //相对基本路径--关于图片上传建议查看--http://tinymce.ax-z.cn/general/upload-images.php paste_data_images: true, //图片是否可粘贴 images_upload_handler: (blobInfo, success, failure) => { if(blobInfo.blob().size/1024/1024>2){ failure(\"上传失败,图片大小请控制在 2M 以内\") }else{ let params=new FormData() params.append(\'file\',blobInfo.blob()) let config={ headers:{ \"Content-Type\":\"multipart/form-data\" } } this.$axios.post(`${api.baseUrl}/api-upload/uploadimg`,params,config).then(res=>{ if(res.data.code==200){ success(res.data.msg) //上传成功,在成功函数里填入图片路径 }else{ failure(\"上传失败\") } }).catch(()=>{ failure(\"上传出错,服务器开小差了呢\") }) } } }, contentValue: this.value } }, watch: { value (newValue) { this.contentValue = newValue }, contentValue (newValue) { this.$emit(\'input\', newValue) }, }, created(){ }, mounted(){ tinymce.init({}) }, methods: { // 添加相关的事件,可用的事件参照文档=> https://github.com/tinymce/tinymce-vue => All available events onClick(e){ this.$emit(\'onClick\', e, tinymce) }, //清空内容 clear(){ this.contentValue = \'\' }, }, } </script> <style lang=\"less\"> </style>
注册及使用组件
在main.js中全局注册 import TEditor from \'@/components/TEditor.vue\' Vue.component(\'TEditor\',TEditor) 在相关页面使用 <TEditor ref=\"editor\" v-model=\"value\" />
注:单图上传插件调用接口不同,上传图片和上传文件的两个函数都有调用,所以上传文件函数里也要添加对图片上传的判断和处理
表情插件无法成功加载
出现如下报错,是因为引入路径出问题,引入不到文件包导致的,需要自己配置路径
Uncaught SyntaxError: Unexpected token \'<\' Failed to load emoticons: Script at URL \"http://xxxx/static/js/plugins/emoticons/js/emojis.js\" did not call `tinymce.Resource.add(\'tinymce.plugins.emoticons\', data)` within 1 second
解决方法
1、将node_modules/tinymce/plugins/emoticons文件夹复制到public/tinymce里
2、在如上代码里的init里添加一行代码emoticons_database_url:\’/tinymce/emoticons/js/emojis.js\’,见图
3、在如上代码里的plugins和toolbars里分别添加emoticons来引入表情插件,见图
4、刷新或重启项目即可
添加首行缩进功能
参考文档: http://tinymce.ax-z.cn/more-plugins/indent2em.php
1、前往上方文档里下载intent2em插件 2、将解压后的首行缩进插件intent2em复制到public/tinymce文件夹下,见图 3、在indent2em里新建index.js并写入以下代码 // Exports the \"indent2em\" plugin for usage with module loaders // Usage: // CommonJS: // require(\'tinymce/plugins/indent2em\') // ES2015: // import \'tinymce/plugins/indent2em\' require(\'./plugin.js\'); 4、在components/TEditor.vue里引入首行缩进插件,并在plugins和toolbar里注册该插件,见图 import \'../../public/tinymce/indent2em\' //首行缩进 5、刷新或重启项目即可使用
格式刷
方法和首行缩进功能一样
解决css引入报警告的问题
解决
由于项目路径的部署,之前的默认css引入可能会出现问题并报警告,所以建议自己引入一份css以替代之前的 1、在public/tinymce文件夹下新建tinycontent.css 2、在src/components/TEditor.vue的init里引入tinycontent.css,并将content_style注释掉(因为引入css文件,content_style字段就不需要了) content_css: `${api.editorUrl}tinymce/tinycontent.css`, //以css文件方式自定义可编辑区域的css样式,css文件需自己创建并引入 3、刷新或重启项目即可,警告消失
实现多图上传功能
参考文档: http://tinymce.ax-z.cn/more-plugins/axupimgs.php
1、前往上方文档里下载多图上传插件axupimgs 2、将解压后的多图上传插件axupimgs复制到public/tinymce文件夹下 3、在axupimgs文件夹下新建index.js并写入以下代码 // Exports the \"axupimgs\" plugin for usage with module loaders // Usage: // CommonJS: // require(\'tinymce/plugins/axupimgs\') // ES2015: // import \'tinymce/plugins/axupimgs\' require(\'./plugin.js\'); 4、打开axupimgs/plugin.js,配置以下几行代码(为什么配置:因为这几行代码的作用是引入多图上传弹框upfiles.html文件, 若多图上传功能有弹框,但是弹框内无内容,则可能是此路径未引入正确,此时则需要再配置一下) 配置前: tinymce.PluginManager.add(\'axupimgs\', function(editor, url) { var pluginName=\'多图上传\'; window.axupimgs={}; //扔外部公共变量,也可以扔一个自定义的位置 var baseURL=tinymce.baseURL; var iframe1 = baseURL+\'/plugins/axupimgs/upfiles.html\'; 配置后: + import api from \'@/api/api.js\' tinymce.PluginManager.add(\'axupimgs\', function(editor, url) { var pluginName=\'多图上传\'; window.axupimgs={}; //扔外部公共变量,也可以扔一个自定义的位置 + var baseURL=api.editorUrl; + var iframe1 = baseURL+\'tinymce/axupimgs/upfiles.html\'; 注:每个人的项目不同,则路径配置也不同,根据自己项目配置即可。 5、在components/TEditor.vue里引入多图上传插件,并在plugins和toolbar里注册该插件(见图) import \'../../public/tinymce/axupimgs\' //多图上传 6、刷新或重启项目即可 注:此多图上传功能是基于单图上传功能的,多图上传就是多次调用单图上传的接口函数(见最上方 images_upload_handler)。 所以必须先完成单图上传功能才行,单图上传在最上面代码里已经实现了,这里不做赘述。
添加文件上传以及媒体上传功能(上传功能包括图片上传,文件上传以及媒体上传三类。其中图片上传使用图片上传函数,文件和媒体上传均使用文件上传函数)
参考文档: http://tinymce.ax-z.cn/general/upload-images.php
1、在plugins和toolbar里注册link插件以及media插件(见图) 2、在init里添加以下代码(以下代码对于link插件和media插件是通用的,配置好后这两个插件就都可以使用了)(见图) file_picker_types: \'file image media\', //分别对应三个类型文件的上传:link插件,image和axupimgs插件,media插件。想屏蔽某个插件的上传就去掉对应的参数 file_picker_callback: (callback, value, meta)=>{ let filetype=\'.pdf, .txt, .zip, .rar, .7z, .doc, .docx, .xls, .xlsx, .ppt, .pptx, .mp3, .mp4, .jpg\'; //限制文件的上传类型 let inputElem = document.createElement(\'input\'); //创建文件选择 inputElem.setAttribute(\'type\', \'file\'); inputElem.setAttribute(\'accept\', filetype); inputElem.click(); inputElem.onchange=()=>{ let upurl=\'\' let file=inputElem.files[0] //获取文件信息 if(file.type.slice(0,5)==\'video\'){ //判断文件类型 upurl=`${api.baseUrl}/api-upload/uploadTxVideo` }else{ upurl=`${api.baseUrl}/api-upload/upload` } if(file.type.slice(0,5)==\'image\'&&file.size/1024/1024>2){ alert(\"上传失败,图片大小请控制在2M以内\") }else if(file.type.slice(0,5)==\'video\'&&file.size/1024/1024>500){ alert(\"上传失败,视频大小请控制在 500M 以内\") }else if(file.size/1024/1024>10){ alert(\"上传失败,文件大小请控制在 10M 以内\") }else{ let params=new FormData() params.append(\'file\',file) let config={ headers:{ \"Content-Type\":\"multipart/form-data\" } } this.$axios.post(upurl,params,config).then(res=>{ if(res.data.code==200){ callback(res.data.data) //上传成功,在回调函数里填入文件路径 }else{ alert(\"上传失败\") } }).catch(()=>{ alert(\"上传出错,服务器开小差了呢\") }) } } } 3、具体效果见图
集成公式编辑功能
假如你的项目需要公式编辑功能
1、MathJax插件+LaTeX语法 说到公式编辑功能,首先想到的是引入MathJax插件,使用LaTeX语法。这样做出来的有几个缺点, 一个是用户是不会LaTeX语法的,另一个是在vue的v-html里,LateX语法渲染的富文本是不生效的, 因为latex的语法里的斜杠\\在v-html里会被转义,导致无法识别。所以考虑了一下还是放弃了这个实现方式, 当然,如果你的项目使用mathjax没有影响,则可以使用其方式,实现方式这里不做赘述,请参考以下文档 实现步骤: https://www.cnblogs.com/already/p/12876452.html mathjax使用文档1: https://www.cnblogs.com/mqingqing123/p/12711372.html mathjax使用文档2: https://www.cnblogs.com/mqingqing123/p/12026817.html LaTeX语法: https://www.jianshu.com/p/27b163b1c6ef 2、使用百度编辑器的kityformula 之前一直使用百度编辑器,对百度编辑器的公式编辑插件kityformula还是比较赞的。 但是kityformula是依附于百度编辑器的,不能单独拎出来集成到tinymce里(如果有大神有办法单独集成还请告知) 所以考虑在项目中引入百度编辑器,并只使用其公式编辑功能,然后将百度编辑器整个集成到tinymce里。
实现步骤
1、前往此地址下载ueditor包: https://files.cnblogs.com/files/huihuihero/UEditor.zip
2、将解压后的包复制到public文件夹下,与tinymce文件夹同级
3、创建公式编辑的插件
参考文档:http://tinymce.ax-z.cn/advanced/creating-a-plugin.php
1、在public/tinymce文件夹下新建formulas文件夹 2、在formulas文件夹下新建index.js,写入以下代码 // Exports the \"formulas\" plugin for usage with module loaders // Usage: // CommonJS: // require(\'tinymce/plugins/formulas\') // ES2015: // import \'tinymce/plugins/formulas\' require(\'./plugin.js\'); 3、在formulas文件夹下新建plugin.js和plugin.min.js,写入以下代码,两个文件代码一样即可 import api from \'@/api/api.js\' tinymce.PluginManager.add(\'formulas\', function(editor, url) { var pluginName=\'公式\'; //配置文件引入路径,根据自己项目来,我这里引入的api.editorUrl=http://192.168.1.171/apib //需要说明的是iframe1所代表的页面地址在线下跑的时候需能够访问,否则访问不了会默认展示至项目首页 var iframe1 = api.editorUrl+\'tinymce/formulas/formulas.html\'; var openDialog = function () { return editor.windowManager.openUrl({ title: pluginName, size: \'large\', url:iframe1, buttons: [ { type: \'cancel\', text: \'Close\' }, // { // type: \'custom\', // text: \'Save\', // name: \'save\', // primary: true // }, ], }); }; // 注册一个工具栏按钮名称 editor.ui.registry.addButton(\'formulas\', { text: pluginName, onAction: function () { openDialog(); } }); // 注册一个菜单项名称 menu/menubar editor.ui.registry.addMenuItem(\'formulas\', { text: pluginName, onAction: function() { openDialog(); } }); return { getMetadata: function () { return { //插件名和链接会显示在“帮助”→“插件”→“已安装的插件”中 name: \"Example plugin\",//插件名称 url: \"http://exampleplugindocsurl.com\", //作者网址 }; } }; }); 4、在formulas文件夹下新建formulas.html,并写入以下代码 <!doctype html> <html> <head> <meta charset=\"utf-8\" /> <title>formulas</title> <meta name=\"viewport\" content=\"user-scalable=no, width=device-width, initial-scale=1.0, maximum-scale=1.0\"/> <meta name=\"apple-mobile-web-app-capable\" content=\"yes\" /> <meta name=\"apple-mobile-web-app-status-bar-style\" content=\"black\" /> <meta name=\"format-detection\" content=\"telephone=no\"> <meta http-equiv=\"X-UA-Compatible\" content=\"IE=edge,chrome=1\" /> <style> html,body{margin:0;padding:0;background:#fff;} #wrap{ width: 80%; margin-left: 10%; } #editor{ width: 100%; height: 300px; margin-top: 40px; } .remind-a{ font-size: 14px; color: #6f6f6f; margin-top: 60px; } .remind-a span{ font-size: 16px; font-weight: 700; color: #333; } .remind-b{ font-size: 14px; color: #6f6f6f; margin-top: 10px; } </style> </head> <body> <div id=\"wrap\"> <div id=\"editor\"></div> <div class=\"remind-a\">点击左上角 <span>∑</span> 符号即可编辑公式</div> <div class=\"remind-b\">编辑完成后 Ctrl+C 复制,之后在编辑器里 Ctrl+V 粘贴即可</div> </div> </body> <script type=\"text/javascript\" src=\"../../UEditor/ueditor.config.js\"></script> <script type=\"text/javascript\" src=\"../../UEditor/ueditor.all.js\"></script> <script type=\"text/javascript\" src=\"../../UEditor/lang/zh-cn/zh-cn.js\"></script> <script type=\"text/javascript\" charset=\"utf-8\" src=\"../../UEditor/kityformula-plugin/addKityFormulaDialog.js\"></script> <script type=\"text/javascript\" charset=\"utf-8\" src=\"../../UEditor/kityformula-plugin/getKfContent.js\"></script> <script type=\"text/javascript\" charset=\"utf-8\" src=\"../../UEditor/kityformula-plugin/defaultFilterFix.js\"></script> <script id=\"editor\" type=\"text/plain\" name=\"gdesc\" style=\"width:100%;height:350px;\"></script> <script type=\"text/javascript\"> //实例化编辑器 var ue = UE.getEditor(\'editor\', {toolbars: [\"kityformula\"]}); </script> </html>
4、引入自制的公式编辑插件formulas
在src/components/TEditor.vue里的引入公式编辑插件,并在plugins和toolbar里注册该插件 import \'../../public/tinymce/formulas\' //公式编辑
5、重启项目,公式编辑功能开发完成
最近新建一个项目,在@tinymce/tinymce-vue版本为4.0.0+的时候,会出现以下报错。因此出现报错的同学,建议使用4.0.0之前的版本号,如下(成功解决报错)
以上就是在vue3.0+中使用tinymce及实现多图上传,文件上传,公式编辑等功能的详细内容,更多关于vue实现多图上传文件上传公式编辑的资料请关注其它相关文章!
暂无评论内容