Vue3集成Quill富文本编辑器完整指南

更新日期: 2025-06-10阅读: 521标签: 富文本

还在为vue项目找一款强大的富文本编辑器?Quill.js作为轻量级但功能全面的选择,集成到Vue3中只需5步!下面分享实际项目验证的集成方案,解决中文配置、图片上传等高频痛点


安装与环境准备(避开版本坑)

# 使用官方适配Vue3的封装(2023年更新)
npm install @vueup/vue-quill@latest quill@6.x

# 安装图片调整模块(解决图片缩放问题)
npm install quill-image-resize-module --save-dev


基础集成方案(含中文配置)

<template>
  <div class="editor-container">
    <!-- 关键:使用v-model双向绑定 -->
    <QuillEditor 
      v-model:content="htmlContent" 
      contentType="html"
      :options="editorOptions"
      @ready="onEditorReady"
    />
  </div>
</template>

<script setup>
import { QuillEditor } from '@vueup/vue-quill'
import '@vueup/vue-quill/dist/vue-quill.snow.css'

// 中文配置项(解决工具栏英文问题)
const editorOptions = {
  modules: {
    toolbar: [
      ['bold', 'italic', 'underline'],
      [{ 'list': 'ordered'}, { 'list': 'bullet' }],
      ['image', 'link']
    ]
  },
  placeholder: '请输入内容...',
  theme: 'snow'
}

const htmlContent = ref('<p>初始内容</p>')

// 编辑器实例就绪回调
const onEditorReady = (quill) => {
  console.log('Quill实例:', quill)
}
</script>


图片上传实战(阿里云OSS方案)

// 在editorOptions中扩展图片处理
modules: {
  toolbar: {
    container: [['image']],
    handlers: {
      image: function() {
        const fileInput = document.createElement('input')
        fileInput.type = 'file'
        fileInput.accept = 'image/*'
        fileInput.click()
        
        fileInput.onchange = async () => {
          const file = fileInput.files[0]
          // 调用后端接口获取OSS上传凭证
          const { token, url } = await getOSSToken() 
          
          // 执行上传(伪代码)
          const result = await axios.put(url, file, {
            headers: { 'Content-Type': file.type }
          })
          
          // 获取CDN地址并插入编辑器
          const imageUrl = `https://cdn.yourdomain.com/${file.name}`
          const range = this.quill.getSelection()
          this.quill.insertEmbed(range.index, 'image', imageUrl)
        }
      }
    }
  }
}


高频踩坑解决方案

样式丢失问题

/* 强制覆盖Quill样式作用域 */
.editor-container :deep(.ql-container) {
  height: 400px;
  font-family: 'Microsoft YaHei';
}

自定义字体大小

// 在options中添加
modules: {
  toolbar: [
    [{ 'size': ['small', false, 'large', 'huge'] }]
  ]
}

内容XSS防护

// 安装DOMPurify
npm install dompurify

// 使用前过滤
import DOMPurify from 'dompurify'
const safeHtml = DOMPurify.sanitize(dangerousHtml)


性能优化技巧

异步加载组件(减少首屏体积)

<script setup>
import { defineAsyncComponent } from 'vue'
const QuillEditor = defineAsyncComponent(() => 
  import('@vueup/vue-quill').then(m => m.QuillEditor)
)
</script>

按需引入模块(节省50%体积)

// 在需要使用编辑器的页面动态加载
if (process.client) {
  import('quill/dist/quill.snow.css')
}


完整功能扩展建议

功能推荐方案优势
表格支持quill-table-module支持合并单元格
公式编辑quill-formulaKaTeX集成
代码高亮quill-syntax-highlighter支持50+语言
粘贴格式化quill-paste-smart自动清理Word样式


常见问题排查

工具栏不显示?
→ 检查是否同时引入了snow.css主题样式

中文配置失效?
→ 确认未加载其他Quill实例覆盖配置

图片无法调整大小?
→ 检查是否注册了quill-image-resize-module

最佳实践:封装为可复用组件RichEditor.vue,通过props暴露配置接口,内部处理所有Quill相关逻辑


项目经验总结

数据存储:建议同时保存原始Delta对象和HTML内容

版本控制:锁定Quill版本(避免6.x到7.x的破坏性更新)

移动端适配:添加@touchstart事件防止键盘遮挡

链接: https://fly63.com/article/detial/12764

pell.js_不到200行Js代码如何实现富文本编辑器

前段时间在寻找一些关于富文本编辑器的资料,然后发现了这个名为 Pell 的项目,它是一个所见即所得(WYSIWYG)的文本编辑器,虽然它的功能很简单,但是令人吃惊的是它只有 1kb 大小。

html5中contenteditable属性如果过滤标签,过滤富文本样式

​​在div中使用contenteditable=”true”可以达到模拟输入框的效果,但是当我们复制其他网页内容进去的时候,会发现连带的样式也一起复制进去了。很明显我们不需要复制富文本样式,那么如何过滤这些标签呢?

在Vue2.0中集成UEditor 富文本编辑器

在vue的’项目中遇到了需要使用富文本编辑器的需求,在github上看了很多vue封装的editor插件,很多对图片上传和视频上传的支持并不是很好,最终还是决定使用UEditor。

angular富文本编辑器tinymce-angular

快速使用富文本,上手很迅速.tinymce-angular把tinymce分装成angular的一个组件,安装引入后,添加一个editor标签就能使用,如下安装与引入

Monaco Editor编辑器的使用

vscode是我们经常在用的编辑器,它的前身是微软的一个叫Monaco Workbench的项目,而Monaco Editor就是从这个项目中成长出来的一个web编辑器,他们很大一部分的代码都是共用的

quill 定制富文本编辑器

很多时候 <textarea> 并不能满足我们对文本输入的需求,当我们需要为输入的文本添加格式时,我们需要使用像 quill 这样的富文本编辑器来完成富文本的输入。

编写一个非常简单的 JavaScript 编辑器

当然,我们已经有可以使用的很好的Web编辑器:你只需下载,并插入页面即可。我以前习惯于使用CodeMirror和ACE。例如,我为CodeMirror写了一个插件来支持PlantUML。然而,这些编辑器有一个问题:它们难以扩展和难以理解。

web前端常用的富文本编辑器插件

富文本编辑器是一种可内嵌于浏览器,所见即所得的文本编辑器。它提供类似于Office Word 的编辑功能,方便那些不太懂HTML用户使用,富文本编辑器的应用非常广泛,它的历史与图文网页诞生的历史几乎一样长。

内容以共享、参考、研究为目的,不存在任何商业目的。其版权属原作者所有,如有侵权或违规,请与小编联系!情况属实本人将予以删除!