还在为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>
// 在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-formula | KaTeX集成 |
代码高亮 | quill-syntax-highlighter | 支持50+语言 |
粘贴格式化 | quill-paste-smart | 自动清理Word样式 |
工具栏不显示?
→ 检查是否同时引入了snow.css主题样式
中文配置失效?
→ 确认未加载其他Quill实例覆盖配置
图片无法调整大小?
→ 检查是否注册了quill-image-resize-module
最佳实践:封装为可复用组件RichEditor.vue,通过props暴露配置接口,内部处理所有Quill相关逻辑
前段时间在寻找一些关于富文本编辑器的资料,然后发现了这个名为 Pell 的项目,它是一个所见即所得(WYSIWYG)的文本编辑器,虽然它的功能很简单,但是令人吃惊的是它只有 1kb 大小。
在div中使用contenteditable=”true”可以达到模拟输入框的效果,但是当我们复制其他网页内容进去的时候,会发现连带的样式也一起复制进去了。很明显我们不需要复制富文本样式,那么如何过滤这些标签呢?
在vue的’项目中遇到了需要使用富文本编辑器的需求,在github上看了很多vue封装的editor插件,很多对图片上传和视频上传的支持并不是很好,最终还是决定使用UEditor。
快速使用富文本,上手很迅速.tinymce-angular把tinymce分装成angular的一个组件,安装引入后,添加一个editor标签就能使用,如下安装与引入
vscode是我们经常在用的编辑器,它的前身是微软的一个叫Monaco Workbench的项目,而Monaco Editor就是从这个项目中成长出来的一个web编辑器,他们很大一部分的代码都是共用的
很多时候 <textarea> 并不能满足我们对文本输入的需求,当我们需要为输入的文本添加格式时,我们需要使用像 quill 这样的富文本编辑器来完成富文本的输入。
当然,我们已经有可以使用的很好的Web编辑器:你只需下载,并插入页面即可。我以前习惯于使用CodeMirror和ACE。例如,我为CodeMirror写了一个插件来支持PlantUML。然而,这些编辑器有一个问题:它们难以扩展和难以理解。
富文本编辑器是一种可内嵌于浏览器,所见即所得的文本编辑器。它提供类似于Office Word 的编辑功能,方便那些不太懂HTML用户使用,富文本编辑器的应用非常广泛,它的历史与图文网页诞生的历史几乎一样长。
内容以共享、参考、研究为目的,不存在任何商业目的。其版权属原作者所有,如有侵权或违规,请与小编联系!情况属实本人将予以删除!