Vue項目中使用富文本編輯器Vue-Quill-Editor(含圖片自定義上傳服務、清除複製粘貼樣式等)

使用教程(注意細看總結部分,寫了幾點,但願有所幫助):
一、安裝插件:npm install vue-quill-editor
二、安裝插件依賴:npm install quill
三、main.js文件中引入:css

import Vue from 'vue'
import VueQuillEditor from 'vue-quill-editor'

import 'quill/dist/quill.core.css'
import 'quill/dist/quill.snow.css'
import 'quill/dist/quill.bubble.css'

Vue.use(VueQuillEditor)
new Vue({
  VueQuillEditor,
  render: h => h(App),
}).$mount('#app')

四、vue頁面中使用(代碼完整,複製就能使用):vue

<template>
  <div id="quillEditorId">
    <el-upload
      class="avatarUploader"
      action="https://jsonplaceholder.typicode.com/posts/"
      :show-file-list="false"
      :on-success="handleAvatarSuccess"
      :before-upload="beforeAvatarUpload"
    >
      <img v-if="imageUrl" :src="imageUrl" class="avatar" />
      <i v-else class="el-icon-plus avatar-uploader-icon"></i>
    </el-upload>
    <quill-editor
      id="myQuillEditorId"
      ref="myQuillEditor"
      v-model="ruleForm.editeContent"
      :options="editorOption"
      @change="handelEditorChange($event)"
    >
    </quill-editor>
  </div>
</template>
<script>
const toolbarOptions = [
  ['bold', 'italic', 'underline', 'strike'], //加粗,斜體,下劃線,刪除線
  ['blockquote', 'code-block'], //引用、代碼塊兒
  [{ header: 1 }, { header: 2 }], //標題,鍵值對的形式;一、2表示字體大小
  [{ list: 'ordered' }, { list: 'bullet' }], //列表
  [{ script: 'sub' }, { script: 'super' }], //上下標
  [{ indent: '-1' }, { indent: '+1' }], //縮進
  [{ direction: 'rtl' }], //文本方向
  [{ size: ['small', false, 'large', 'huge'] }], //字體大小
  [{ header: [1, 2, 3, 4, 5, 6, false] }], //幾級標題
  [{ color: [] }, { background: [] }], //字體顏色,字體背景顏色
  [{ font: [] }], //字體
  [{ align: [] }], //對齊方式
  ['clean'], //清除字體樣式
  ['image'], //上傳圖片、上傳視頻(video)、超連接(link)
]
export default {
  data() {
    return {
      imageUrl: '',
      editeContent: '',
      editorOption: {
        modules: {
          clipboard: {
            // 粘貼版,處理粘貼時候的自帶樣式
            matchers: [[Node.ELEMENT_NODE, this.HandleCustomMatcher]],
          },
          toolbar: {
            container: toolbarOptions, // 工具欄
            handlers: {
              image: function(value) {
                if (value) {
                  // 獲取隱藏的上傳圖片的class,不必定是.el-icon-plus。觸發上傳圖片事件
                  document.querySelector('.el-icon-plus').click()
                } else {
                  this.quill.format('image', false)
                }
              },
            },
          },
        },
        placeholder: '',
      },
    }
  },
  computed: {},
  async mounted() {},
  methods: {
    handleAvatarSuccess(res, file) {
      // 圖片上傳成功後的回調
      console.log(res, file)
    },
    beforeAvatarUpload(data) {
      // 思路:上傳圖片至服務後,拿到返回的圖片地址。直接建立image標籤插入光標所在的位置
      // 圖片上傳服務(本地服務或者阿里雲服務)
      // 獲取富文本組件實例
      let quill = this.$refs.myQuillEditor.quill
      // 上傳阿里雲成功後,按根據光標位置把圖片插入編輯器中
      if (data.url) {
        // 獲取光標所在位置,data.url表示上傳服務後返回的圖片地址
        let length = quill.getSelection().index
        // 插入圖片,data.url爲阿里雲返回的圖片連接地址
        quill.insertEmbed(length, 'image', data.url)
        // 調整光標到最後
        quill.setSelection(length + 1)
      } else {
        this.$message.closeAll()
        this.$message.error('圖片插入失敗')
      }
    },
    handelEditorChange(el) {
      console.log(el, 'el')
    },
    HandleCustomMatcher(node, Delta) {
      // 文字、圖片等,從別處複製而來,清除自帶樣式,轉爲純文本
      let ops = []
      Delta.ops.forEach(op => {
        if (op.insert && typeof op.insert === 'string') {
          ops.push({
            insert: op.insert,
          })
        }
      })
      Delta.ops = ops
      return Delta
    },
  },
}
</script>
<style scoped lang="scss">
#quillEditorId {
  .avatarUploader {
    display: none; // 隱藏上傳圖片組件
  }
}
</style>

總結:
一、變量toolbarOptions表示自定義的工具欄,能夠參照官網(官網寫的比較簡單)或者細看本文代碼(有詳細註釋);
二、若是不單獨處理圖片,圖片會被直接轉義成base64,跟隨DOM一起上傳服務;
三、本文對圖片作了自定義處理,選擇本地圖片時,會單獨上傳到服務,返回地址後,直接插入到富文本編輯中的當前節點。看代碼中editorOption的handlers的image函數,以及插入富文本編輯器當前光標函數beforeAvatarUpload,代碼中有詳細註釋;
四、粘貼板,變量clipboard。若是須要清理複製的自帶樣式,使用粘貼板進行清理,函數HandleCustomMatcher;
五、對於複製粘貼的狀況,多說一句。過程當中,編輯器已經將原有的DOM轉爲編輯器容許存在的DOM元素,因此這塊兒不用再處理(處理起來,也會有點複雜)。node

相關文章
相關標籤/搜索