关于 vue 富文本编辑器 Tinymce 踩坑日记

  1. 作为踩坑过 vue-quill-editor 富文本编辑器,以及 wangEditor 编辑器来说,个人感觉还是 Tinymce 功能更加强大跟齐全一些。说一下体验感,wangEditor 编辑器太年轻了,功能上缺乏很多东西,比如说上传图片无法方便的添加图片的 alt 信息,git issue上也有人提意见,功能目前还在计划中。而 vue-quill-editor 这款编辑器是根据 quill 编辑器为基础做的二次加工,功能上来说,感觉没有 Tinymce 增加功能方便简洁,而且为了一些特定化需求,可能还需要更改源码文件,这样就导致如果有人删了一下依赖包重新下载就凉透了。从目前来看,还是 Tinymce 这款功能比较齐全,而且也有人专门翻译做了中文文档,Tinymce 中文文档传送门,这个人做的还不错,更新速度也可以,在首页下方也有功能完全的Demo 可以体验。
  2. 接下来,开始说我在vue中 使用体验了,首先如果 Tinymce 第三方集成区所集成的版本所容纳的功能足够的话,就可以不用按照我的方法,可以直接使用 vue-tinymce 这个集成方案来解决,但是我为了追求所有的功能都能跟上最新版,所以没有选择这个方案,而是用了这个方案
   npm install --save @tinymce/tinymce-vue@3.2.8  tinymce
  1. 注意 @tinymce/tinymce-vue@3.2.8 指定版本安装,因为从 4.x.x 版本开始就是 vue3 所支持的版本,如果是 vue2 就必须装 4.x.x 版本以下的,否则会报错。
  2. 安装好之后,自定义一个编辑器组件,比如:
<template>
<div class="tinymce-editor">
   <editor
     v-model="myValue"
     :disabled="disabled"
     @onClick="onClick"
     :init="init"
   />
 </div>
</template>
<script>
import { getToken } from "@/utils/auth";
import tinymce from "tinymce/tinymce";
import Editor from "@tinymce/tinymce-vue";
import "tinymce/themes/silver";
import "tinymce/icons/default/icons"; //解决了icons.js 报错Unexpected token '<'
// 编辑器插件plugins
// 更多插件参考:https://www.tiny.cloud/docs/plugins/
import "tinymce/plugins/image"; // 插入上传图片插件
import "tinymce/plugins/media"; // 插入视频插件
import "tinymce/plugins/table"; // 插入表格插件c
import "tinymce/plugins/lists"; // 列表插件
import "tinymce/plugins/wordcount"; // 字数统计插件
import "tinymce/plugins/charmap"; // 特殊字符
import "tinymce/plugins/preview"; // 预览
import "tinymce/plugins/hr"; // 水平线
import "tinymce/plugins/help"; // 帮助文档
import "tinymce/plugins/imagetools"; // 图片编辑工具
import "tinymce/plugins/code"; // 编辑源码
import "tinymce/plugins/fullscreen"; // 全屏
import "tinymce/plugins/link"; // 超链接
import "tinymce/plugins/paste"; // 粘贴
import "tinymce/plugins/quickbars"; // 快速工具栏
import "tinymce/plugins/searchreplace"; // 查找替换

export default {
 components: {
   Editor,
 },
 props: {
   value: {
     type: String,
     default: "",
   },
   // 基本路径,默认为空根目录,如果你的项目发布后的地址为目录形式,
   // 即abc.com/tinymce,baseUrl需要配置成tinymce,不然发布后资源会找不到
   baseUrl: {
     type: String,
     default: "",
   },
   disabled: {
     type: Boolean,
     default: false,
   },
   plugins: {
     type: [String, Array],
     default:
       "lists image imagetools media table wordcount charmap preview hr help code fullscreen link paste quickbars searchreplace ",
   },
   toolbar: {
     type: [String, Array],
     default() {
       return [
         "code preview hr help searchreplace | removeformat charmap paste | fullscreen",
         "undo redo | formatselect | fontsizeselect | fontselect | bold italic underline forecolor backcolor | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | link lists image imagetools media table |",
       ];
     },
   },
 },
 data() {
   return {
     init: {
       skin_url: "/tinymce/skins/ui/oxide",
       language: "zh_CN",
       language_url: "/tinymce/langs/zh_CN.js",
       protect: [
         /\<\/?(if|endif)\>/g, //<if> & </endif>
         /\<xsl\:[^>]+\>/g, //<xsl:...>
         /<\?php.*?\?>/g, //php代码
       ], // 代码保护
       height: 700,
       plugins: this.plugins,
       toolbar: this.toolbar,
       charmap_append: [
         [0x2615, "morning coffee"],
         [0x2600, "sun"],
         [0x2601, "cloud"],
       ],
       branding: false,
       menubar: false,
       // 此处为图片上传处理函数,这个直接用了base64的图片形式上传图片,
       // 如需ajax上传可参考https://www.tiny.cloud/docs/configure/file-image-upload/#images_upload_handler
       images_upload_handler: (blobInfo, success, failure, progress) => {
         var xhr, formData;
         xhr = new XMLHttpRequest();
         xhr.withCredentials = false;
         xhr.open("POST", `${process.env.VUE_APP_BASE_API}/common/upload`);
         xhr.setRequestHeader("Authorization", `Bearer ${getToken()}`);
         xhr.upload.onprogress = function (e) {
           progress((e.loaded / e.total) * 100);
         };
         xhr.onload = function () {
           var json;
           if (xhr.status == 403) {
             failure("HTTP Error: " + xhr.status, { remove: true });
             return;
           }
           if (xhr.status < 200 || xhr.status >= 300) {
             failure("HTTP Error: " + xhr.status);
             return;
           }
           json = JSON.parse(xhr.responseText);
           if (!json || typeof json.url != "string") {
             failure("Invalid JSON: " + xhr.responseText);
             return;
           }
           success(json.url);
         };

         xhr.onerror = function () {
           failure(
             "Image upload failed due to a XHR Transport error. Code: " +
               xhr.status
           );
         };

         formData = new FormData();
         formData.append("file", blobInfo.blob(), blobInfo.filename());

         xhr.send(formData);
       },
     },
     myValue: this.value,
   };
 },
 mounted() {
   tinymce.init({});
 },
 methods: {
   // 添加相关的事件,可用的事件参照文档=> https://github.com/tinymce/tinymce-vue => All available events
   // 需要什么事件可以自己增加
   onClick(e) {
     this.$emit("onClick", e, tinymce);
   },
   // 可以添加一些自己的自定义事件,如清空内容
   clear() {
     this.myValue = "";
   },
 },
 watch: {
   value(newValue) {
     this.myValue = newValue;
   },
   myValue(newValue) {
     this.$emit("input", newValue);
   },
 },
};
</script>
  1. 注意,我这里只引入了一些插件,如果想要其他的工具,比如图片的插件,就需要先引入插件
// 编辑器插件plugins
import "tinymce/plugins/image"; // 插入上传图片插件
// 然后需要在 plugins  toolbar 中放入插件
plugins:"image";
toolbar:"image"
  1. 关键一点,就是如果看不到编辑器显示出来,还需要一步,在 node_modules 中找到 tinymce,找到对应 skins 文件,在public 文件夹下创建一个 tinymce 文件夹,将其复制出来放在 public/tinymce 文件夹下,或者 放在你可以知道准确的引入地址文件夹下的 xxxx/tinymce 文件夹中。init 时需要设置 skin_url,这是线下环境,如果线上环境找不到路径,就需要配置一个 baseUrl
    // 基本路径,默认为空根目录,如果你的项目发布后的地址为目录形式,
    // 即abc.com/tinymce,baseUrl需要配置成tinymce,不然发布后资源会找不到
	skin_url: "/tinymce/skins/ui/oxide",
	// or
	skin_url: `${baseUrl}/tinymce/skins/ui/oxide`,
  1. 如果看不懂英文,可以配置中文资源包,先去本地化资源包下载地址 下载,可以简单注册一个账号,然后进入文档 - > 本地化配置,就可以看到这个页面了,或者复制我从官网下载过来的中文包也行;

在这里插入图片描述
8. 我目前所用的本地化中文资源包js 文件
9. 然后在之前创建的的 tinymce 文件夹中再创建一个 language 文件夹,将 zh_CN.js 文件放在 language 中,然后在 init 中引入

	  language: "zh_CN",
      language_url: "/tinymce/langs/zh_CN.js",
     // or
     language_url: `${baseUrl}/tinymce/langs/zh_CN.js`,
  1. 接下来就可以去其他文件引用这个编辑器组件了。如果有其他的坑可以联系我,大家一起讨论。如果没看到,可以+qq 1499224990 联系我
  • 0
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值