Mekki

vue3中使用tinymce记录

Mekki

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

TinyMCE 为 vue 提供了官方例子,详见https://packy-tang.gitee.io/vue-tinymce/#/

安装 tinymce

#npm
npm install tinymce
npm install @tinymce/tinymce-vue

#yarn
yarn add tinymce
yarn add @tinymce/tinymce-vue

下载中文语言包

下载地址:https://www.tiny.cloud/get-tiny/language-packages/

image.png

public中新建文件夹tinymce,将上面下载的语言包解压后放进去,另将node_modules/tinymce/skins文件夹也复制到tinymce

封装组件

新建文件夹tinymce

# index.vue
<template>
  <div class="tinymce-box">
    <Editor
      v-model="contentValue"
      :init="init"
      :disabled="disabled"
      @onClick="onClick"
    />
  </div>
</template>

<script>
  //引入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 emoticons hr pagebreak insertdatetime print preview | code selectall | 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;',

          height: 800, //注:引入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: '/demo/upimg.php',  //后端处理程序的url
          // images_upload_base_path: '/demo',  //相对基本路径--关于图片上传建议查看--http://tinymce.ax-z.cn/general/upload-images.php
          // 此处为图片上传处理函数,这个直接用了base64的图片形式上传图片,
          // 如需ajax上传可参考https://www.tiny.cloud/docs/configure/file-image-upload/#images_upload_handler
          images_upload_handler: (blobInfo, success, failure) => {
            const img = 'data:image/jpeg;base64,' + blobInfo.base64()
            success(img)
          },
        },
        contentValue: this.value,
      }
    },
    created() {},
    mounted() {
      tinymce.init({})
    },
    watch: {
      value(newValue) {
        this.contentValue = newValue
      },
      contentValue(newValue) {
        this.$emit('input', newValue)
      },
    },
    methods: {
      // 添加相关的事件,可用的事件参照文档=> https://github.com/tinymce/tinymce-vue => All available events
      // 需要什么事件可以自己增加
      onClick(e) {
        this.$emit('onClick', e, tinymce)
      },
      // 可以添加一些自己的自定义事件,如清空内容
      clear() {
        this.contentValue = ''
      },
    },
  }
</script>

<style lang="scss">
  .tinymce-box {
  }
</style>

在页面中引用

# test.vue
<template>
  <Tinymce ref="editor" v-model="value" />
</template>

<script>
  import Tinymce from '@/components/tinymce/index.vue'
  export default {
    components: {
      Tinymce,
    },
    data() {
      return {
        value: '123',
      }
    },
  }
</script>

解决 css 引入报错的问题

image.png

解决办法:

由于项目路径的部署,之前的默认css引入可能会出现问题并报警告,所以建议自己引入一份css以替代之前的

1、在public/tinymce文件夹下新建tinycontent.css

2、在src/components/tinymce/index.vue的init里引入tinycontent.css,并将content_style注释掉(因为引入css文件,content_style字段就不需要了)

content_css: '/tinymce/tinycontent.css',  //以css文件方式自定义可编辑区域的css样式,css文件需自己创建并引入
3、刷新或重启项目

image.png

image.png

image.png

解决表情插件缺失问题

解决办法:

1、将node_modules/tinymce/plugins/emoticons文件夹复制到public/tinymce里

2、在如上代码里的init里添加一行代码emoticons_database_url:'/tinymce/emoticons/js/emojis.js',见图

3、在如上代码里的plugins和toolbars里分别添加emoticons来引入表情插件,见图

4、刷新或重启项目

image.png

image.png

image.png

实现多图上传功能

使用axupimgs插件

参考文档: http://tinymce.ax-z.cn/more-plugins/axupimgs.php

作用:这是一个 tinymce 多图片批量上传插件,支持拖拽文件添加,拖拽支持白名单,自动过滤非白名单文件类型,支持全选后直接无脑拽。