在vue的’項目中遇到了需要使用富文本編輯器的需求,在github上看了很多vue封裝的editor插件,很多對圖片上傳和視頻上傳的支持並不是很好,最終還是決定使用UEditor。 這類的文章網上有很多,我進行了摸索、手寫代碼、彙總、排版,形成了這篇文章。 下載對應的UEditor源碼 首先,去官網 ...
在vue的’項目中遇到了需要使用富文本編輯器的需求,在github上看了很多vue封裝的editor插件,很多對圖片上傳和視頻上傳的支持並不是很好,最終還是決定使用UEditor。
這類的文章網上有很多,我進行了摸索、手寫代碼、彙總、排版,形成了這篇文章。
下載對應的UEditor源碼
首先,去官網上下載UEditor的源碼,根據你後臺語言的不同下載對應的版本(PHP、Asp、.Net、Jsp),下載地址。
下載之後,把資源放到 /static/ue/
靜態目錄下。文檔結構如下:
(我把UEditor放到了static
靜態目錄下麵,這裡的文件不會被webpack
打包,當然你也可以選擇性地放進src中)
編輯 UEditor 編輯器 配置文件
我們打開 ueditor.config.js
,修改其中的window.UEDITOR_HOME_UR
配置,如下:
window.UEDITOR_HOME_URL = "/static/UE/"; //指定編輯器資源文件根目錄
var URL = window.UEDITOR_HOME_URL || getUEBasePath();
ueditor.config.js
文件有很多配置,可以在這裡進行一些初始化的全局配置,比如編輯器的預設寬高等:
,initialFrameWidth:1000 //初始化編輯器寬度,預設1000
,initialFrameHeight:320 //初始化編輯器高度,預設320
其他的參數配置,在該文件中有詳細列出,或者參考官方文檔 http://fex.baidu.com/ueditor/
將編輯器集成到系統中
打開 /src/main.js 文件,插入下麵的代碼:
//ueditor
import '../static/UE/ueditor.config.js'
import '../static/UE/ueditor.all.min.js'
import '../static/UE/lang/zh-cn/zh-cn.js'
import '../static/UE/ueditor.parse.min.js'
開發公共組件 UE.vue
我們在 /src/components/
目錄下創建 UE.vue
文件,作為我們的編輯器組件文件。
下麵代碼提供簡單功能,具體使用根據需求完善該組件即可。
<template>
<div>
<script id="editor" type="text/plain"></script>
</div>
</template>
<script>
export default {
name: 'ue',
data () {
return {
editor: null
}
},
props: {
value: '',
config: {}
},
mounted () {
this.editor = window.UE.getEditor('editor', this.config);
this.editor.addListener('ready', () => {
this.editor.setContent(this.value)
})
},
methods: {
getUEContent () {
return this.editor.getContent()
}
},
destroyed () {
this.editor.destroy()
}
}
</script>
組件暴露了兩個介面:
value
是編輯器的文字
config
是編輯器的配置參數
在其他頁面中使用該組件
簡單地創建一個需要UEditor的頁面,再該頁面中使用剛纔封裝好的UE.vue組件:
<template>
<div>
<Uediter :value="ueditor.value" :config="ueditor.config" ref="ue"></Uediter>
<button @click="returnContent">顯示編輯器內容</el-button>
<div>{{dat.content}}</div>
</div>
</template>
<script>
import Uediter from '@/components/UE.vue';
export default {
data () {
return {
dat: {
content: ''
},
ueditor: {
value: '編輯器預設文字',
config: {
initialFrameWidth: 800,
initialFrameHeight: 320
}
}
}
},
methods: {
returnContent () {
this.dat.content = this.$refs.ue.getUEContent()
}
},
components: {
Uediter
},
}
</script>
效果如下:
What's more: 服務端需要做的配置
配置完上述內容後,控制台可能會出現"後臺配置項返回格式出錯,上傳功能將不能正常使用!"的報錯,
我們在編輯器中上傳圖片或者視頻,也會出現響應的報錯,這是因為沒有配置伺服器的請求介面,在ueditor.config.js中,對serverUrl進行配置:
// 伺服器統一請求介面路徑
, serverUrl: 'http://172.16.254.49:83/File/UEditor' //地址管你們後端要去