1、安装vue-quill-editor模块:$nmp install vue-quill-editor --save
2、安装quill-image-extend-module模块(可选,用于将图片上传到服务器):$nmp install quill-image-extend-module --save
3、自定义中文样式(可选),src/assets/css/global.css:
/* 富文本编辑器 */
.editor {
line-height: normal !important;
}
.ql-snow .ql-tooltip[data-mode=link]::before {
content: "请输入链接地址:";
}
.ql-snow .ql-tooltip.ql-editing a.ql-action::after {
border-right: 0px;
content: '保存';
padding-right: 0px;
}
.ql-snow .ql-tooltip[data-mode=video]::before {
content: "请输入视频地址:";
}
.ql-snow .ql-picker.ql-size .ql-picker-label::before,
.ql-snow .ql-picker.ql-size .ql-picker-item::before {
content: '14px';
}
.ql-snow .ql-picker.ql-size .ql-picker-label[data-value=small]::before,
.ql-snow .ql-picker.ql-size .ql-picker-item[data-value=small]::before {
content: '10px';
}
.ql-snow .ql-picker.ql-size .ql-picker-label[data-value=large]::before,
.ql-snow .ql-picker.ql-size .ql-picker-item[data-value=large]::before {
content: '18px';
}
.ql-snow .ql-picker.ql-size .ql-picker-label[data-value=huge]::before,
.ql-snow .ql-picker.ql-size .ql-picker-item[data-value=huge]::before {
content: '32px';
}
.ql-snow .ql-picker.ql-header .ql-picker-label::before,
.ql-snow .ql-picker.ql-header .ql-picker-item::before {
content: '文本';
}
.ql-snow .ql-picker.ql-header .ql-picker-label[data-value="1"]::before,
.ql-snow .ql-picker.ql-header .ql-picker-item[data-value="1"]::before {
content: '标题1';
}
.ql-snow .ql-picker.ql-header .ql-picker-label[data-value="2"]::before,
.ql-snow .ql-picker.ql-header .ql-picker-item[data-value="2"]::before {
content: '标题2';
}
.ql-snow .ql-picker.ql-header .ql-picker-label[data-value="3"]::before,
.ql-snow .ql-picker.ql-header .ql-picker-item[data-value="3"]::before {
content: '标题3';
}
.ql-snow .ql-picker.ql-header .ql-picker-label[data-value="4"]::before,
.ql-snow .ql-picker.ql-header .ql-picker-item[data-value="4"]::before {
content: '标题4';
}
.ql-snow .ql-picker.ql-header .ql-picker-label[data-value="5"]::before,
.ql-snow .ql-picker.ql-header .ql-picker-item[data-value="5"]::before {
content: '标题5';
}
.ql-snow .ql-picker.ql-header .ql-picker-label[data-value="6"]::before,
.ql-snow .ql-picker.ql-header .ql-picker-item[data-value="6"]::before {
content: '标题6';
}
.ql-snow .ql-picker.ql-font .ql-picker-label::before,
.ql-snow .ql-picker.ql-font .ql-picker-item::before {
content: '标准字体';
}
.ql-snow .ql-picker.ql-font .ql-picker-label[data-value=serif]::before,
.ql-snow .ql-picker.ql-font .ql-picker-item[data-value=serif]::before {
content: '衬线字体';
}
.ql-snow .ql-picker.ql-font .ql-picker-label[data-value=monospace]::before,
.ql-snow .ql-picker.ql-font .ql-picker-item[data-value=monospace]::before {
content: '等宽字体';
}
.ql-editor{
min-height: 200px;
}
4、全局引入quill的css样式和自定义的中文样式,main.js:
// 富文本样式
import 'quill/dist/quill.core.css'
import 'quill/dist/quill.snow.css'
// import 'quill/dist/quill.bubble.css' // 没有用到该主题样式
// 全局样式
import './assets/css/global.css'
5、封装quill的组件,,src/components/quill/Quill.vue:
<template>
<quill-editor class="editor"
v-model="myContent"
ref="myQuillEditor"
:options="editorOption"
@blur="onEditorBlur($event)"
@focus="onEditorFocus($event)"
@change="onEditorChange($event)"
>
</quill-editor>
</template>
<script>
// 图片上传、下载路径
import {uploadUrl, downloadUrl} from '../../network/file'
import {quillEditor, Quill} from 'vue-quill-editor'
import {ImageExtend, QuillWatch} from 'quill-image-extend-module'
Quill.register('modules/ImageExtend', ImageExtend)
// 工具栏配置
const toolbarOptions = [
['bold', 'italic', 'underline', 'strike'], // 加粗 斜体 下划线 删除线 -----['bold', 'italic', 'underline', 'strike']
['blockquote', 'code-block'], // 引用 代码块-----['blockquote', 'code-block']
[{ header: 1 }, { header: 2 }], // 1、2 级标题-----[{ header: 1 }, { header: 2 }]
[{ list: 'ordered' }, { list: 'bullet' }], // 有序、无序列表-----[{ list: 'ordered' }, { list: 'bullet' }]
[{ script: 'sub' }, { script: 'super' }], // 上标/下标-----[{ script: 'sub' }, { script: 'super' }]
[{ indent: '-1' }, { indent: '+1' }], // 缩进-----[{ indent: '-1' }, { indent: '+1' }]
[{'direction': 'rtl'}], // 文本方向-----[{'direction': 'rtl'}]
[{ size: ['small', false, 'large', 'huge'] }], // 字体大小-----[{ size: ['small', false, 'large', 'huge'] }]
[{ header: [1, 2, 3, 4, 5, 6, false] }], // 标题-----[{ header: [1, 2, 3, 4, 5, 6, false] }]
[{ color: [] }, { background: [] }], // 字体颜色、字体背景颜色-----[{ color: [] }, { background: [] }]
[{ font: [] }], // 字体种类-----[{ font: [] }]
[{ align: [] }], // 对齐方式-----[{ align: [] }]
['clean'], // 清除文本格式-----['clean']
['link', 'image'] // 链接、图片、视频-----['link', 'image', 'video']
];
export default {
name: 'Quill',
components: {quillEditor},
props: {
content: {
type: String,
default: ''
}
},
data() {
return {
// 富文本
myContent: this.content,
editorOption: {
placeholder: "请输入文档内容~",
theme: "snow", // or 'bubble'
modules: {
ImageExtend: {
loading: true,
name: 'file',
size: 2, // 可选参数 图片大小,单位为M,1M = 1024kb
action: uploadUrl,
response: (res) => {
// 图片下载路径
let url = `${downloadUrl}?code=${res.data}`
return url
}
},
toolbar: {
container: toolbarOptions,
handlers: {
'image': function () {
QuillWatch.emit(this.quill.id)
}
}
}
}
}
}
},
watch: {
// 监听content值变化, 确保输入框中的数据刷新
content () {
this.myContent = this.content
}
},
methods: {
// 失去焦点事件
onEditorBlur(){
this.$emit('onEditorBlur', this.myContent)
},
// 获得焦点事件
onEditorFocus(){
this.$emit('onEditorFocus', this.myContent)
},
// 内容改变事件
onEditorChange(){
this.$emit('onEditorChange', this.myContent)
}
}
}
</script>
<style lang="less" scoped>
</style>
6、Quill组件的调用:
<template>
<quill :content="addForm.description" @onEditorChange="onEditorChangeAdd"></quill>
</template>
<script>
import Quill from '../../../../components/quill/Quill.vue'
export default {
components: {Quill},
data() {
return {
//表单数据
addForm: {
description: ''
}
}
},
methods: {
// 监听富文本框内容改变
onEditorChangeAdd(content) {
this.addForm.description = content
}
}
}
</script>
7、内容展示:
<template>
<div class="ql-editor" v-html="content"></div>
</template>