VueQuill 富文本编辑器技术文档快速上手

在此之前，我讲解过关于VueQuill是什么的文章点击查看
什么是 VueQuill（前端的富文本编辑器）？

1. 安装 VueQuill

要在你的 Vue 项目中使用 VueQuill，你需要首先安装 vue-quill-editor 和 quill 包。

npm install vue-quill-editor quill --save

2. 配置 VueQuill

在你的 Vue 项目中，配置 VueQuill 编辑器。你需要在你的主 JavaScript 文件（通常是 main.js）中引入并注册 VueQuill。

// main.js

import Vue from 'vue'
import App from './App.vue'
import VueQuillEditor from 'vue-quill-editor'

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

Vue.use(VueQuillEditor)

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

3. 在组件中使用 VueQuill

在你的 Vue 组件中使用 VueQuill 编辑器。你可以通过引入 quill-editor 组件来使用它。

<template>
  <div id="app">
    <quill-editor
      v-model="content"
      :options="editorOptions"
      @blur="onEditorBlur($event)"
      @focus="onEditorFocus($event)"
      @change="onEditorChange($event)"
    />
  </div>
</template>

<script>
export default {
  data() {
    return {
      content: '',
      editorOptions: {
        theme: 'snow'
      }
    }
  },
  methods: {
    onEditorBlur(editor) {
      console.log('editor blur!', editor)
    },
    onEditorFocus(editor) {
      console.log('editor focus!', editor)
    },
    onEditorChange({ editor, html, text }) {
      console.log('editor change!', editor, html, text)
    }
  }
}
</script>

<style>
@import "~quill/dist/quill.snow.css";
</style>

4. 配置选项

你可以通过 editorOptions 来配置 Quill 编辑器的选项。以下是一些常见的配置：

export default {
  data() {
    return {
      content: '',
      editorOptions: {
        // 主题配置
        theme: 'snow',
        // 工具栏配置
        modules: {
          toolbar: [
            [{ 'header': [1, 2, false] }],
            ['bold', 'italic', 'underline'],
            ['image', 'code-block']
          ]
        }
      }
    }
  }
}

5. 事件处理

VueQuill 支持多种事件处理，包括 @blur、@focus 和 @change。你可以在方法中处理这些事件：

methods: {
  onEditorBlur(editor) {
    console.log('editor blur!', editor)
  },
  onEditorFocus(editor) {
    console.log('editor focus!', editor)
  },
  onEditorChange({ editor, html, text }) {
    console.log('editor change!', editor, html, text)
  }
}

6. 数据格式

VueQuill 编辑器的内容可以以 HTML 或 Delta 格式存储。你可以通过 v-model 绑定数据，并在处理数据时根据需要进行转换。

data() {
  return {
    content: ''
  }
},
methods: {
  saveContent() {
    // 存储 HTML 格式
    const htmlContent = this.content

    // 存储 Delta 格式
    const deltaContent = this.$refs.quillEditor.quill.getContents()

    console.log('HTML Content:', htmlContent)
    console.log('Delta Content:', deltaContent)
  }
}

7. 自定义工具栏

你可以自定义 Quill 编辑器的工具栏，添加或删除按钮和功能。

editorOptions: {
  modules: {
    toolbar: [
      [{ 'header': '1' }, { 'header': '2' }, { 'font': [] }],
      [{ 'list': 'ordered'}, { 'list': 'bullet' }],
      ['bold', 'italic', 'underline'],
      ['image', 'code-block']
    ]
  }
}

8. 示例项目结构

my-vue-quill-project
├── node_modules
├── public
│   ├── index.html
├── src
│   ├── assets
│   ├── components
│   │   └── MyEditor.vue
│   ├── App.vue
│   └── main.js
├── .gitignore
├── package.json
└── README.md

9. 常见问题

如何添加图片上传功能？

你可以自定义 Quill 工具栏并实现图片上传功能。具体实现可以参考 Quill 文档。

如何自定义编辑器主题？

你可以通过引入不同的 Quill 样式文件并在 editorOptions 中设置 theme 来自定义主题。

---