Vue3中使用vue-quill-editor富文本编辑器的完整指南

更新日期: 2025-06-17阅读: 27标签: 富文本

vue3项目中集成富文本编辑器时,vue-quill-editor是一个优秀的选择。它基于强大的Quill.js,专为Vue3设计,提供了开箱即用的富文本编辑功能。下面我们一步步实现集成过程。


安装与基础配置

首先安装必要依赖:

npm install vue-quill-editor@beta quill

在组件中引入并使用:

<template>
  <div class="editor-container">
    <quill-editor 
      v-model:content="content" 
      contentType="html"
      :options="editorOptions"
    />
  </div>
</template>

<script setup>
import { ref } from 'vue';
import { QuillEditor } from 'vue-quill-editor';
import 'quill/dist/quill.snow.css';

const content = ref('<p>初始编辑内容</p>');

const editorOptions = ref({
  modules: {
    toolbar: [
      ['bold', 'italic', 'underline'],
      [{ list: 'ordered' }, { list: 'bullet' }],
      ['link', 'image']
    ]
  },
  placeholder: '请输入内容...',
});
</script>

<style scoped>
.editor-container {
  max-width: 800px;
  margin: 20px auto;
}
</style>


关键功能实现

获取编辑器内容

const getEditorContent = () => {
  console.log(content.value); // 获取HTML格式内容
};

图片上传处理

editorOptions.value.modules.toolbar.handlers = {
  image: function() {
    const input = document.createElement('input');
    input.type = 'file';
    input.accept = 'image/*';
    input.click();
    
    input.onchange = async () => {
      const file = input.files[0];
      const formData = new FormData();
      formData.append('image', file);
      
      // 替换为实际api地址
      const { url } = await uploadApi(formData); 
      const quill = this.quill;
      const range = quill.getSelection();
      quill.insertEmbed(range.index, 'image', url);
    };
  }
}


常见问题解决

样式丢失
确保在组件中导入Quill样式:

import 'quill/dist/quill.snow.css';

TypeScript类型报错
安装类型声明包:

npm install @types/quill -D

工具栏自定义
通过配置toolbar数组控制显示项:

toolbar: [
  ['bold', 'italic'], 
  ['blockquote', 'code-block'],
  [{ 'color': [] }, { 'background': [] }]
]


最佳实践建议

在组件销毁时手动清除编辑器实例:

import { onUnmounted } from 'vue';

onUnmounted(() => {
  if (window.Quill) {
    delete window.Quill;
  }
});

对于移动端适配,添加响应式样式:

@media (max-width: 768px) {
  .ql-toolbar {
    flex-wrap: wrap;
    height: auto !important;
  }
}

vue-quill-editor在Vue3中表现稳定,通过合理配置可以满足博客系统、CMS后台、评论模块等场景的需求。实际项目中建议结合具体业务需求扩展自定义模块,例如添加视频嵌入支持或代码语法高亮功能。遇到特殊需求时,查阅Quill.js官方文档通常能找到解决方案。

本文提供的方法已在Vue3.3+环境中验证,vue-quill-editor版本为6.0.0-beta.7。根据项目需要可调整工具栏配置,平衡功能丰富性与用户体验。

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

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用户使用,富文本编辑器的应用非常广泛,它的历史与图文网页诞生的历史几乎一样长。

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

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

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