前言
最近需要項目中需要使用富文本編輯器,對比了常見的幾款之后泪掀,決定采用quill-editor摆寄,需要進(jìn)一步了解的同學(xué)可以移步到官網(wǎng)quill-editor。
quill-editor支持了常用的功能军浆,但是有2點棕洋,需要我們自己定制一下。vue集成quill-editor很簡單乒融,網(wǎng)上有很多介紹掰盘,自行百度下即可。
- 圖片上傳:因為編輯器默認(rèn)是將圖片轉(zhuǎn)成base64存儲的簇抵,而我們實際開發(fā)需要將圖片存在自己的服務(wù)器中庆杜。
- 中文漢化:編輯器默認(rèn)都是英文展示的,在網(wǎng)上也找到了替換成中文的方法碟摆。但是太過于繁瑣晃财,因為這種方式是重寫整個toolbar的div。實際上,我們只需要重寫對應(yīng)的css即可断盛。
直接上代碼
為了使用方便罗洗,自己實現(xiàn)了一個Editor.vue,代碼如下钢猛。
<template>
<div>
<!-- 圖片上傳組件輔助-->
<el-upload
class="avatar-uploader"
:action="serverUrl"
name="img"
:headers="header"
:show-file-list="false"
:on-success="uploadSuccess"
:on-error="uploadError"
:before-upload="beforeUpload">
</el-upload>
<quill-editor
class="editor"
v-model="content"
ref="myQuillEditor"
:options="editorOption"
@blur="onEditorBlur($event)" @focus="onEditorFocus($event)"
@change="onEditorChange($event)">
</quill-editor>
</div>
</template>
<script>
// 工具欄配置
const toolbarOptions = [
["bold", "italic", "underline", "strike"], // 加粗 斜體 下劃線 刪除線
["blockquote", "code-block"], // 引用 代碼塊
[{ header: 1 }, { header: 2 }], // 1伙菜、2 級標(biāo)題
[{ list: "ordered" }, { list: "bullet" }], // 有序、無序列表
[{ script: "sub" }, { script: "super" }], // 上標(biāo)/下標(biāo)
[{ indent: "-1" }, { indent: "+1" }], // 縮進(jìn)
// [{'direction': 'rtl'}], // 文本方向
[{ size: ["small", false, "large", "huge"] }], // 字體大小
[{ header: [1, 2, 3, 4, 5, 6, false] }], // 標(biāo)題
[{ color: [] }, { background: [] }], // 字體顏色命迈、字體背景顏色
[{ font: [] }], // 字體種類
[{ align: [] }], // 對齊方式
["clean"], // 清除文本格式
["link", "image", "video"] // 鏈接贩绕、圖片、視頻
];
import { quillEditor } from "vue-quill-editor";
import "quill/dist/quill.core.css";
import "quill/dist/quill.snow.css";
import "quill/dist/quill.bubble.css";
export default {
props: {
/*編輯器的內(nèi)容*/
value: {
type: String
},
/*圖片大小*/
maxSize: {
type: Number,
default: 4000 //kb
}
},
components: {
quillEditor
},
data() {
return {
content: this.value,
quillUpdateImg: false, // 根據(jù)圖片上傳狀態(tài)來確定是否顯示loading動畫壶愤,剛開始是false,不顯示
editorOption: {
placeholder: "",
theme: "snow", // or 'bubble'
placeholder: "您想說點什么淑倾?",
modules: {
toolbar: {
container: toolbarOptions,
// container: "#toolbar",
handlers: {
image: function(value) {
if (value) {
// 觸發(fā)input框選擇圖片文件
document.querySelector(".avatar-uploader input").click();
} else {
this.quill.format("image", false);
}
},
// link: function(value) {
// if (value) {
// var href = prompt('請輸入url');
// this.quill.format("link", href);
// } else {
// this.quill.format("link", false);
// }
// },
}
}
}
},
serverUrl: "/v1/blog/imgUpload", // 這里寫你要上傳的圖片服務(wù)器地址
header: {
// token: sessionStorage.token
} // 有的圖片服務(wù)器要求請求頭需要有token
};
},
methods: {
onEditorBlur() {
//失去焦點事件
},
onEditorFocus() {
//獲得焦點事件
},
onEditorChange() {
//內(nèi)容改變事件
this.$emit("input", this.content);
},
// 富文本圖片上傳前
beforeUpload() {
// 顯示loading動畫
this.quillUpdateImg = true;
},
uploadSuccess(res, file) {
// res為圖片服務(wù)器返回的數(shù)據(jù)
// 獲取富文本組件實例
let quill = this.$refs.myQuillEditor.quill;
// 如果上傳成功
if (res.code == 200) {
// 獲取光標(biāo)所在位置
let length = quill.getSelection().index;
// 插入圖片 res.url為服務(wù)器返回的圖片地址
quill.insertEmbed(length, "image", res.url);
// 調(diào)整光標(biāo)到最后
quill.setSelection(length + 1);
} else {
this.$message.error("圖片插入失敗");
}
// loading動畫消失
this.quillUpdateImg = false;
},
// 富文本圖片上傳失敗
uploadError() {
// loading動畫消失
this.quillUpdateImg = false;
this.$message.error("圖片插入失敗");
}
}
};
</script>
<style>
.editor {
line-height: normal !important;
height: 800px;
}
.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: '標(biāo)題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: '標(biāo)題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: '標(biāo)題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: '標(biāo)題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: '標(biāo)題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: '標(biāo)題6';
}
.ql-snow .ql-picker.ql-font .ql-picker-label::before,
.ql-snow .ql-picker.ql-font .ql-picker-item::before {
content: '標(biāo)準(zhǔn)字體';
}
.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: '等寬字體';
}
</style>
使用
使用起來,直接用Editor標(biāo)簽即可
<Editor v-model="article.content"/>