如何在vue3.0+中使用tinymce及实现多图上传文件上传公式编辑功能
相关文档
本文部分内容借鉴: 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实现多图上传文件上传公式编辑的资料请关注我们其它相关文章!