TinyMce富文本编辑器使用【详细】

1,646 阅读3分钟

TinyMCE是一款易用、且功能强大的所见即所得的富文本编辑器。同类程序有:UEditor、Kindeditor、Simditor、CKEditor、wangEditor、Suneditor、froala等等。

TinyMCE的优势:

  • 开源可商用,基于LGPL2.1
  • 插件丰富,自带插件基本涵盖日常所需功能(示例看下面的Demo-2)
  • 接口丰富,可扩展性强,有能力可以无限拓展功能
  • 界面好看,符合现代审美
  • 提供经典、内联、沉浸无干扰三种模式(详见“介绍与入门”)
  • 对标准支持优秀(自v5开始)
  • 多语言支持,官网可下载几十种语言。

image.png

官网及文档:www.tiny.cloud

官网下载:www.tiny.cloud/get-tiny/se…

Github:github.com/tinymce

【推荐】为vue开发者整合的tinymce组件

安装

经典模式 |TinyMCE中文文档中文手册 (ax-z.cn)

  1. 安装依赖
npm install @tinymce/tinymce-vue -S
npm install tinymce -S 
  1. 编辑器本身是英文编辑器,所以还需要下载本地化文件(下载这个)

image.png 也可以这里获取【zh-CN.js】

组件注册

1、组件注册引用核心

import tinymce from 'tinymce/tinymce'; //tinymce核心文件
import Editor from '@tinymce/tinymce-vue';

2、Editor 初始化

tinymce.init({
  language_url: tinymce.addI18n("zh_CN", zh_CN), // 中文语言包路径
  language: "zh_CN",
  skin_url: "/src/assets/tinymce/skins/ui/oxide", // 编辑器皮肤样式
  content_css: "/src/assets/tinymce/skins/content/default/content.css",
  menubar: true, // 隐藏菜单栏
  autoresize_bottom_margin: 50,
  min_height: 350,
})

3、Editor 插件引入

// 插件依赖
import "tinymce/themes/silver/theme"; // 引用主题文件
import "tinymce/icons/default"; // 引用图标文件
import "tinymce/plugins/link";
import "tinymce/plugins/code";
import "tinymce/plugins/table";
import "tinymce/plugins/lists";
import "tinymce/plugins/advlist";
import "tinymce/plugins/anchor";
import "tinymce/plugins/autolink"; //锚点
import "tinymce/plugins/autoresize";
import "tinymce/plugins/autosave";
import "tinymce/plugins/charmap"; //特殊字符
import "tinymce/plugins/code"; //查看源码
import "tinymce/plugins/codesample"; //插入代码
import "tinymce/plugins/directionality"; //
import "tinymce/plugins/fullpage"; //页面属性编辑
import "tinymce/plugins/fullscreen"; //全屏
import "tinymce/plugins/help"; //帮助
import "tinymce/plugins/hr"; //横线
import "tinymce/plugins/image"; //图片
import "tinymce/plugins/imagetools"; //图片工具
import "tinymce/plugins/importcss"; //图片工具
import "tinymce/plugins/insertdatetime"; //时间插入
import "tinymce/plugins/media"; //媒体插入
import "tinymce/plugins/nonbreaking"; //
import "tinymce/plugins/noneditable"; //不间断空格
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"; //
import "tinymce/plugins/template"; //插入模板
import "tinymce/plugins/textpattern"; //
import "tinymce/plugins/toc"; //
import "tinymce/plugins/visualblocks"; //
import "tinymce/plugins/visualchars"; //
import "tinymce/plugins/wordcount"; //数字统计

4、tinymce图片上传(支持本地资源)

tinymce.init({
  language_url: tinymce.addI18n("zh_CN", zh_CN), // 中文语言包路径
  language: "zh_CN",
  skin_url: "/src/assets/tinymce/skins/ui/oxide", // 编辑器皮肤样式
  content_css: "/src/assets/tinymce/skins/content/default/content.css",
  menubar: true, // 隐藏菜单栏
  autoresize_bottom_margin: 50,
  min_height: 350,
  file_picker_types: "file media",
  // 图片上传
  images_upload_handler: function (blobInfo, success) {
      let reader = new FileReader();
      reader.readAsDataURL(blobInfo.blob());
      reader.onload = function () {
        success(this.result);
      };
    }
})

image.png image.png

5、文件/视频上传(本地资源)

tinymce.init({
  language_url: tinymce.addI18n("zh_CN", zh_CN), // 中文语言包路径
  language: "zh_CN",
  skin_url: "/src/assets/tinymce/skins/ui/oxide", // 编辑器皮肤样式
  content_css: "/src/assets/tinymce/skins/content/default/content.css",
  menubar: true, // 隐藏菜单栏
  autoresize_bottom_margin: 50,
  min_height: 350,
  file_picker_types: "file media",
  // 文件/视频上传
  file_picker_callback: function (callback, value, meta) {
    //当点击media图标上传时,判断meta.filetype == 'media'有必要,因为file_picker_callback是media(媒体)、image(图片)、file(文件)的共同入口
    if (meta.filetype == "media") {
      //创建一个隐藏的type=file的文件选择input
      let input = document.createElement("input");
      input.setAttribute("type", "file");
      input.onchange = function () {
        let file = this.files[0]; //只选取第一个文件。如果要选取全部,后面注意做修改
        let formData;
        formData = new FormData();
        formData.append("file", file);
        // 后台请求
        try {
          uploadImg(formData)
            .then((res) => {
              //接口返回的文件保存地址
              let mediaLocation = res.filenames;
              //callback()回调函数,将mediaLocation显示在弹框输入框中
              callback(mediaLocation, {
                title: file.name,
              });
            })
            .catch((err) => {
              console.error("出现未知问题,刷新页面,或者联系程序员: " + err);
            });
        } catch (error) {
          console.error("出现未知问题,请稍后重试!");
        }
      };
      //触发点击
      input.click();
    }
  }
})

image.png

Bug 修复

一般引入正常都会出现次报错! image.png 【修复】

  • 将对应的报错资源找到,放置项目本地。

image.png 在初始化时,手动引入 image.png

完整代码

【完整代码获取】

欢迎留言交流:【语雀花园】