美文网首页前端文章收集
vue-quill-editor图片上传

vue-quill-editor图片上传

作者: NowYouSeeAll | 来源:发表于2017-04-27 18:23 被阅读13121次

问题描述

  项目使用的vue2.0开发,项目中需要一个富文本编辑器,楼主经过一番心理挣扎选择了vue-quill-editor。具体如何引用作者在项目中已经写得很明白了,我在这里就不再赘述。
  vue-quill-editor插入图片的方式是将图片转为base64再放入内容中,这样就会产生一个问题,如果图片比较大的话,富文本的内容就会很大,楼主是将内容存在数据库中的,这样一来,一方面会占用大量的数据库存储空间,另一方面当图片太大的时候富文本的内容,会超过数据库的存储上限,从而会产生内容被截断从而显示不全的问题(即使是text类型,也有存储上限65535)。
  那么问题来了,如何将图片上传到自己的服务器或第三方服务,然后将获得的图片url插入到文本中呢?我认为大致有两个方法,其一是将任务交给服务端,服务端截取base64图片并转化为文件,将其路径或者url替换原来的图片数据;其二是对控件本身下手,首先将图片上传,然后插入到富文本中。接下来楼主就开始了自己的踩坑之路。

解决方案

基础简介

  1. vue-quill-editor是基于quill(github地址)适用于Vue2的富文本编辑器,所以对于quill的原生属性扩展也是支持的。quill文档地址
  2. quill 中有许多扩展和自定义方法功能。比如图片的重定义大小、图片上传的点击处理等。

图片上传

通过查看quill项目issue。发现其中是有对图片上传这方面问题进行考虑和修改的。所以图片上传这个方案是可行的。接下来就是如何实现。

  1. 首先我们需要在项目中拿到quill的实例。这个在vue-quill-editor项目中有介绍如何获取。基本方法就是通过ref获取你的vue-quill-editor实例,再获取quill实例,代码如下。其中newEditor就是我的vue-quill-editor

     this.$refs.newEditor.quill
    
  2. 在拿到实例后我们需要考虑如何图片上传并将url插入文本中。通过查找发现可以注册一个自定义的图片处理函数,当顶部的工具栏中的图片按钮被点击的时候,就会触发这个函数。然而在实际使用中你会发现这个函数并不像文档中所说的接收(image, callback)两个参数,image是你的图片,你只需要在callback中将传入处理后的url就可以。而是接收一个参数state,当被点击时就会触发这个函数,并传入state值----true。这里首先介绍一下,如何注册这个处理函数-imgHandler。这里要注意,注册函数要写在mounted生命周期钩子里。

    mounted() {
    var vm =this
      var imgHandler = async function(state) {
        if (state) {
          //button is clicked
        }
      }
      vm.$refs.newEditor.quill.getModule("toolbar").addHandler("image", imgHandler)
    }
    
  3. 通过在stackflow查阅,发现就只能在imgHandler中自己实现点击上传和插入的功能。这样就在editor下面写一个不显示的input,并监听变化上传图片,获取其实例,当imgHandler被点击时,模拟input按钮被点击。代码变成如下示例。

     mounted() {
         var vm =this
         var imgHandler = async function(image) {
         vm.addImgRange = vm.$refs.newEditor.quill.getSelection()
         if (image) {
             var fileInput = document.getElementById(vm.uniqueId) //隐藏的file文本ID
             fileInput.click() //加一个触发事件
           }
         }
         vm.$refs.newEditor.quill.getModule("toolbar").addHandler("image", imgHandler)
       }
    
  4. 最后是input的点击上传和图片url的插入。
    HTML代码

       <div
         v-loading="imageLoading"
         element-loading-text="请稍等,图片上传中">
         <quill-editor
           ref="newEditor"
           :options="newOption"
           style="height: 200px; margin-bottom: 54px"
           v-model="editorContent"
           @change="editorChange">
         </quill-editor>
         <form action="" method="post" enctype="multipart/form-data" id="uploadFormMulti">
           <input style="display: none" :id="uniqueId" type="file" name="avator" multiple accept="image/jpg,image/jpeg,image/png,image/gif" @change="uploadImg('uploadFormMulti')"><!--style="display: none"-->
         </form>
       </div>
    

vue代码

      uploadImg: async function(id) {
            var vm = this
            vm.imageLoading = true
            var formData = new FormData($('#' + id)[0])
            try {
              const url = await vm.uploadImgReq(formData)// 自定义的图片上传函数
              if (url != null && url.length > 0) {
                var value = url
                vm.addImgRange = vm.$refs.newEditor.quill.getSelection()
                value = value.indexOf('http') != -1 ? value : 'http:' + value
                vm.$refs.newEditor.quill.insertEmbed(vm.addImgRange != null?vm.addImgRange.index:0, 'image', value, Quill.sources.USER)
              } else {
                vm.$message.warning("图片增加失败")
              }
              document.getElementById(vm.uniqueId).value=''
            } catch ({message: msg}) {
              document.getElementById(vm.uniqueId).value=''
              vm.$message.warning(msg)
            }
            vm.imageLoading = false
          },

到这里就大功告成啦。如果有什么错误、问题或者更好的解决方案欢迎指正讨论~
最后,在解决这个问题的时候,顺便把ImageResize集成到了控件中。具体实现比较简单可以参考vue-quill-editor中的demo示例

    import Quill from 'quill'
      import { ImageResize } from '../modules/ImageResize.js'
      Quill.register('modules/imageResize', ImageResize)
  1. 项目示例

图片上传功能需要自己实现,目前是写了一个空的promise请求,插入了指定的图片。

github demo项目

相关文章

网友评论

    本文标题:vue-quill-editor图片上传

    本文链接:https://www.haomeiwen.com/subject/zclnzttx.html