在 Vue 项目中引入 tinymce 富文本编辑器

简介: tinymce中文版资料:上传图片和文件 | TinyMCE中文文档中文手册tinymce英文版资料:tinymce | Docs | TinyMCEtinymce Github地址:https://github.com/tinymce/tinymce-vuetinymce gitee开源项目demo:tinymce: 在vue中使用tinymce富文本编辑器+tinymce富文本编辑器插入图

1、tinymce相关参考资料


tinymce中文版资料:


上传图片和文件 | TinyMCE中文文档中文手册


tinymce英文版资料:


tinymce | Docs | TinyMCE


tinymce Github地址:


https://github.com/tinymce/tinymce-vue


tinymce gitee开源项目demo:


tinymce: 在vue中使用tinymce富文本编辑器+tinymce富文本编辑器插入图片


2、tinymce安装以及下载


版本:cli3+tinymce5


如果没有购买tinymce服务,需要安装下面2个。


npm install @tinymce/tinymce-vue
npm install tinymce

安装完成以后,在安装目录node_modules 中找到 tinymce/skins 目录,然后将 skins 目录拷贝到 public(cli3是public目录,cli2应该是static目录) 目录下。


tinymce默认是英文界面,需要下载一个中文包,选择对应的中文包进行下载。把这个中文包也放在public目录下面。


下载地址:Language Packages | Trusted Rich Text Editor | TinyMCE


90f7aede8ec1d6b971606f8c9706a01.png


857c13d1f86b354eb30e835678ee61f.png

3、初始化


在页面引入以下文件


import tinymce from 'tinymce/tinymce'
import Editor from '@tinymce/tinymce-vue'
import 'tinymce/themes/silver'

发现编辑器图片找不到,引入图标


import 'tinymce/icons/default/icons'

 tinymce/tinymce是一个组件,引入组件注册,直接使用


//注册组件
components: {
    Editor
}

使用:


v-model:文本编辑器val,


:init绑定的初始化配置参数,完整的api可以参考上面提到的官方英文文档,和中文版的文档说明


:key,每次打开编辑器都是新的,防止重复。


<!-- 富文本编辑器 -->
<Editor id="tinymce" v-model="detailFormAdd.articleContent" :init="editorInit" :key="tinymceFlag"></Editor>

基础配置讲解:



4、扩展组件


完成了上面的初始化之后,就已经能正常运行编辑器了,但只有一些基本功能


tinymce 通过添加插件 步骤


plugins 的方式来添加功能

import引入组件

toolbar添加功能按钮

比如要添加一个上传图片的功能,就需要用到 image 插件,添加超链接需要用到 link 插件,常用的插件如下:


import 'tinymce/plugins/textcolor'
import 'tinymce/plugins/advlist'
import 'tinymce/plugins/table'
import 'tinymce/plugins/lists'
import 'tinymce/plugins/paste'
import 'tinymce/plugins/preview'
import 'tinymce/plugins/fullscreen'
import 'tinymce/plugins/save'
import 'tinymce/plugins/image'
editorInit: {
        language_url: '/tinymce/zh_CN.js',
        language: 'zh_CN',
        skin_url: '/tinymce/skins/ui/oxide',
        height: 500,
        browser_spellcheck: true, // 拼写检查
        branding: false, // 去水印
        elementpath: false, // 禁用编辑器底部的状态栏
        statusbar: false, // 隐藏编辑器底部的状态栏
        paste_data_images: true, // 允许粘贴图像
        menubar: false, // 隐藏最上方menu
        plugins: 'save advlist table lists paste preview fullscreen image',
        toolbar: 'fontselect fontsizeselect forecolor backcolor bold italic underline strikethrough save image| alignleft aligncenter alignright alignjustify | quicklink h2 h3 blockquote table numlist bullist preview fullscreen'
      }

5、上传图片


图片上传有2种,菜单栏增加了上传图片的按钮功能,2是编辑器里面直接粘贴。


1、图片上传


安装4的方法,配置image菜单。在init配置方法里面增加images_upload_handler回调方法方法,自定义上传图片,可以在这里设置。这给回调有三个参数images_upload_handler: function (blobInfo, success, failure),文件对象,成功回调,失败回调。在成功回调里面设置服务端接口返回的图片路径,图片src就会设置成返回的路径。


images_upload_handler: function (blobInfo, success, failure) {
          var formData
          var file = blobInfo.blob() // 转化为易于理解的file对象
          formData = new FormData()
          formData.append('file', file, file.name) // 添加formData
          //我项目封装的提交接口,此处写你自己的提交
          appRequestFile('xxx/xx', formData, 'post').then((res) => {
            console.log(res.data.data.filePath)
            //上传成功,成功回调,设置服务端返回的图片路径,设置成功以后,点击弹出框保存。图片就会显示在编辑器框里,图片的src就是接口返回的filePath
            success(res.data.data.filePath)
          })
        }


742af08fcab2e002155d7d05a67c3df.png


ca9888525b4ecfd65ee184b52572743.png



68bb3aff49b8d450d1272809357b420.png


c3d68b395ad82ffb00011264fc65e60.png




2、图片直接粘贴


图片直接从其他地方,复制粘贴到文本域中,首先在引入paster组件,在init配置项里,设置允许粘贴图片。


粘贴成功首先,会调用paste_preprocess方法,此时args里面会有图片相关信息,默认图片的src是base64.


然后会调用images_upload_handler,这里就跟上传图片是一样的了。

editorInit: {
        language_url: '/tinymce/zh_CN.js',
        language: 'zh_CN',
        skin_url: '/tinymce/skins/ui/oxide',
        height: 500,
        browser_spellcheck: true, // 拼写检查
        branding: false, // 去水印
        elementpath: false, // 禁用编辑器底部的状态栏
        statusbar: false, // 隐藏编辑器底部的状态栏
        paste_data_images: true, // 允许粘贴图像
        menubar: false, // 隐藏最上方menu
        plugins: 'save advlist table lists paste preview fullscreen image',
        toolbar: 'fontselect fontsizeselect forecolor backcolor bold italic underline strikethrough save image| alignleft aligncenter alignright alignjustify | quicklink h2 h3 blockquote table numlist bullist preview fullscreen',
        images_upload_handler: function (blobInfo, success, failure) {
          var formData
          var file = blobInfo.blob() // 转化为易于理解的file对象
          formData = new FormData()
          formData.append('file', file, file.name) // 此处与源文档不一样
          appRequestFile('/upload/simple?moudle=cms', formData, 'post').then((res) => {
            console.log('-----images_upload_handler')
            console.log(res.data.data.filePath)
            success(res.data.data.filePath)
          })
        },
        paste_preprocess: function (plugin, args) {
         //粘贴图片成功,返回的args.
          console.log('---paster' + args)
        }
      }


6、最后贴下完整代码



<template>
  <div class="privateLetter mt20">
    <el-form size="small" label-width="150px" ref="detailFormAdd" :model="detailFormAdd" label-positon="left" :rules="formRule">
      <el-row>
        <el-col :span="20" :offset="1">
          <el-form-item  class="filter-item is-required" label="资讯内容:" prop="articleContent">
             <!-- 富文本编辑器 -->
             <Editor id="tinymce" v-model="detailFormAdd.articleContent" :init="editorInit" :key="tinymceFlag"></Editor>
          </el-form-item>
        </el-col>
      </el-row>
      <div class="mt20 tc mb20">
        <el-button type="primary" size="medium" @click="submit()">保存</el-button>
      </div>
    </el-form>
  </div>
</template>
<script>
import tinymce from 'tinymce/tinymce'
import Editor from '@tinymce/tinymce-vue'
import 'tinymce/themes/silver'
import 'tinymce/plugins/textcolor'
import 'tinymce/plugins/advlist'
import 'tinymce/plugins/table'
import 'tinymce/plugins/lists'
import 'tinymce/plugins/paste'
import 'tinymce/plugins/preview'
import 'tinymce/plugins/fullscreen'
import 'tinymce/plugins/save'
import 'tinymce/plugins/image'
import 'tinymce/icons/default/icons'
import { appRequestFormData, appRequest, appRequestFile } from '@/fetch/index.js'
import qs from 'qs'
export default {
  name: '',
  components: {
    Editor
  },
  data () {
    return {
      tinymceFlag: 1,
      editorInit: {
        language_url: '/tinymce/zh_CN.js',
        language: 'zh_CN',
        skin_url: '/tinymce/skins/ui/oxide',
        height: 500,
        browser_spellcheck: true, // 拼写检查
        branding: false, // 去水印
        elementpath: false, // 禁用编辑器底部的状态栏
        statusbar: false, // 隐藏编辑器底部的状态栏
        paste_data_images: true, // 允许粘贴图像
        menubar: false, // 隐藏最上方menu
        plugins: 'save advlist table lists paste preview fullscreen image',
        toolbar: 'fontselect fontsizeselect forecolor backcolor bold italic underline strikethrough save image| alignleft aligncenter alignright alignjustify | quicklink h2 h3 blockquote table numlist bullist preview fullscreen',
        images_upload_handler: function (blobInfo, success, failure) {
          var formData
          var file = blobInfo.blob() // 转化为易于理解的file对象
          formData = new FormData()
          formData.append('file', file, file.name) // 此处与源文档不一样
          appRequestFile('/upload/simple?moudle=cms', formData, 'post').then((res) => {
            success(res.data.data.filePath)
          })
        },
        paste_preprocess: function (plugin, args) {
          console.log('---paster')
        }
      },
      detailFormAdd: {
        articleContent: ''
      },
      formRule: {
        articleContent: [
          { required: true, message: '请编写资讯内容', trigger: 'blur' },
          { min: 1, max: 1000000, message: '请编写资讯内容', trigger: 'blur' }
        ]
      },
      setHeader: {
        token: token
      }
    }
  },
  mounted () {
    var self = this
    tinymce.init({})
  },
  activated () {
    this.tinymceFlag++
  },
  methods: {
    submit () {
      this.$refs.detailFormAdd.validate((valid) => {
        if (valid) {
          appRequestFormData('/sys/cms/save', qs.stringify(this.detailFormAdd), 'post').then((res) => {
            this.$message(res.data.msg)
            this.$router.go(-1)
          })
        } else {
          this.$message({
            type: 'error',
            message: '请完整表单信息'
          })
          return false
        }
      })
    },
    cancel () {
      this.$confirm('确定要取消吗?', '确定取消', {
        type: 'warning'
      })
        .then(() => {
          this.$router.go(-1)
        })
    }
  },
  created () {
  }
}
</script>
<style lang="stylus">
 .avatar-uploader .el-upload {
    border: 1px dashed #d9d9d9;
    border-radius: 6px;
    cursor: pointer;
    position: relative;
    overflow: hidden;
  }
  .avatar-uploader .el-upload:hover {
    border-color: #409EFF;
  }
  .avatar-uploader-icon {
    font-size: 28px;
    color: #8c939d;
    width: 178px;
    height: 178px;
    line-height: 178px;
    text-align: center;
  }
  .avatar {
    width: 178px;
    height: 178px;
    display: block;
  }
</style>



目录
相关文章
|
17天前
|
JavaScript 应用服务中间件 nginx
vue项目中页面遇到404报错
vue项目中页面遇到404报错
|
1月前
|
JavaScript
vue.js项目评估流程图特效
vue.js项目评估流程图特效
86 2
vue.js项目评估流程图特效
|
1月前
|
JavaScript 前端开发 测试技术
在Vue项目中,常见的错误类型有哪些?
在Vue项目中,常见的错误类型有哪些?
25 2
|
1月前
|
JavaScript 安全 中间件
在Vue项目中,什么情况下需要使用错误处理机制?
在Vue项目中,什么情况下需要使用错误处理机制?
20 2
|
1月前
|
运维 监控 JavaScript
分享一些 Vue 项目中的最佳实践和经验教训。
分享一些 Vue 项目中的最佳实践和经验教训。
19 2
|
1月前
|
JavaScript
vue-cli创建vue3+ts项目
vue-cli创建vue3+ts项目
37 0
|
18天前
|
JavaScript
Vue项目中强制刷新页面的方法
Vue项目中强制刷新页面的方法
14 0
|
1月前
|
JavaScript 前端开发 网络架构
Vue3项目中使用vue-router
Vue3项目中使用vue-router
44 0
|
2天前
|
JavaScript
Vue 如何新建一个项目(如何安装依赖)
Vue 如何新建一个项目(如何安装依赖)
9 0
|
8天前
|
JavaScript
vue3+vite项目配置ESlint
vue3+vite项目配置ESlint
12 0