在 Vue 項目中引入 tinymce 富文本編輯器的完整代碼
項目中原本使用的富文本編輯器是 wangEditor,這是一個很輕量、簡潔編輯器
但是公司的業(yè)務升級,想要一個功能更全面的編輯器,我找了好久,目前常見的編輯器有這些:
UEditor:百度前端的開源項目,功能強大,基于 jQuery,但已經(jīng)沒有再維護,而且限定了后端代碼,修改起來比較費勁
bootstrap-wysiwyg:微型,易用,小而美,只是 Bootstrap + jQuery...
kindEditor:功能強大,代碼簡潔,需要配置后臺,而且好久沒見更新了
wangEditor:輕量、簡潔、易用,但是升級到 3.x 之后,不便于定制化開發(fā)。不過作者很勤奮,廣義上和我是一家人,打個call
quill:本身功能不多,不過可以自行擴展,api 也很好懂,如果能看懂英文的話...
summernote:沒深入研究,UI挺漂亮,也是一款小而美的編輯器,可是我需要大的
在有這么參考的情況下,我最終還是選擇了 tinymce 這個不搭梯子連官網(wǎng)都打不開的編輯器(簡直是自討苦吃),主要因為兩點:
1. GitHub 上星星很多,功能也齊全;
2. 唯一一個從 word 粘貼過來還能保持絕大部分格式的編輯器;
3. 不需要找后端人員掃碼改接口,前后端分離;
4. 說好的兩點呢!
一、資源下載
tinymce 官方為 vue 項目提供了一個組件 tinymce-vue
npm install @tinymce/tinymce-vue -S
在 vscode、webstorm 的終端運行這段代碼可能會報錯,最好使用操作系統(tǒng)自帶的命令行工具
如果有購買 tinymce 的服務,可以參考 tinymce-vue 的說明,通過 api-key 直接使用 tinymce
像我這樣沒購買的,還是要老老實實下載 tinymce
npm install tinymce -S
安裝之后,在 node_modules 中找到 tinymce/skins 目錄,然后將 skins 目錄拷貝到 static 目錄下
// 如果是使用 vue-cli 3.x 構建的 typescript 項目,就放到 public 目錄下,文中所有 static 目錄相關都這樣處理
tinymce 默認是英文界面,所以還需要下載一個中文語言包(記得搭梯子!搭梯子!搭梯子!)
然后將這個語言包放到 static 目錄下,為了結構清晰,我包了一層 tinymce 目錄
二、初始化
在頁面中引入以下文件
import tinymce from 'tinymce/tinymce' import 'tinymce/themes/modern/theme' import Editor from '@tinymce/tinymce-vue'
tinymce-vue 是一個組件,需要在 components 中注冊,然后直接使用
這里的 init 是 tinymce 初始化配置項,后面會講到一些關鍵的 api,完整 api 可以參考官方文檔
編輯器需要一個 skin 才能正常工作,所以要設置一個 skin_url 指向之前復制出來的 skin 文件
init: { language_url: '/static/tinymce/zh_CN.js', language: 'zh_CN', skin_url: '/static/tinymce/skins/lightgray', height: 300 }
// vue-cli 3.x 創(chuàng)建的 typescript 項目,將 url 中的 static 去掉,即 skin_url: '/tinymce/skins/lightgray'
同時在 mounted 中也需要初始化一次:
如果在這里傳入上面的 init 對象,并不能生效,但什么參數(shù)都不傳也會報錯,所以這里傳入一個空對象
三、擴展插件
完成了上面的初始化之后,就已經(jīng)能正常運行編輯器了,但只有一些基本功能
tinymce 通過添加插件 plugins 的方式來添加功能
比如要添加一個上傳圖片的功能,就需要用到 image 插件,添加超鏈接需要用到 link 插件
同時還需要在頁面引入這些插件:
添加了插件之后,默認會在工具欄 toolbar 上添加對應的功能按鈕,toolbar 也可以自定義
貼一下完整的組件代碼:
<template> <div class='tinymce'> <h1>tinymce</h1> <editor id='tinymce' v-model='tinymceHtml' :init='init'></editor> <div v-html='tinymceHtml'></div> </div> </template> <script> import tinymce from 'tinymce/tinymce' import 'tinymce/themes/modern/theme' import Editor from '@tinymce/tinymce-vue' import 'tinymce/plugins/image' import 'tinymce/plugins/link' import 'tinymce/plugins/code' import 'tinymce/plugins/table' import 'tinymce/plugins/lists' import 'tinymce/plugins/contextmenu' import 'tinymce/plugins/wordcount' import 'tinymce/plugins/colorpicker' import 'tinymce/plugins/textcolor' export default { name: 'tinymce', data () { return { tinymceHtml: '請輸入內(nèi)容', init: { language_url: '/static/tinymce/zh_CN.js', language: 'zh_CN', skin_url: '/static/tinymce/skins/lightgray', height: 300, plugins: 'link lists image code table colorpicker textcolor wordcount contextmenu', toolbar: 'bold italic underline strikethrough | fontsizeselect | forecolor backcolor | alignleft aligncenter alignright alignjustify | bullist numlist | outdent indent blockquote | undo redo | link unlink image code | removeformat', branding: false } } }, mounted () { tinymce.init({}) }, components: {Editor} } </script>
四、上傳圖片
tinymce 提供了 images_upload_url 等 api 讓用戶配置上傳圖片的相關參數(shù)
但為了在不麻煩后端的前提下適配自家的項目,還是得用 images_upload_handler 來自定義一個上傳方法
這個方法會提供三個參數(shù):blobInfo, success, failure
其中 blobinfo 是一個對象,包含上傳文件的信息:
success 和 failure 是函數(shù),上傳成功的時候向 success 傳入一個圖片地址,失敗的時候向 failure 傳入報錯信息
總結
以上所述是小編給大家介紹的在 Vue 項目中引入 tinymce 富文本編輯器的完整代碼,希望對大家有所幫助,如果大家有任何疑問請給我留言,小編會及時回復大家的。在此也非常感謝大家對腳本之家網(wǎng)站的支持!
相關文章
Vuex報錯之[vuex] unknown mutation type: han
這篇文章主要介紹了Vuex報錯之[vuex] unknown mutation type: handlePower問題及解決方案,具有很好的參考價值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2023-07-07vue-cli腳手架打包靜態(tài)資源請求出錯的原因與解決
這篇文章主要給大家介紹了關于vue-cli腳手架打包靜態(tài)資源請求出錯的原因與解決方法,文中通過示例代碼介紹的非常詳細,對大家學習或者使用vue-cli具有一定的參考學習價值,需要的朋友們下面來一起學習學習吧2019-06-06Vue生態(tài)系統(tǒng)工具庫Vueuse的使用示例詳解
Vueuse 是一個功能強大的 Vue.js 生態(tài)系統(tǒng)工具庫,它提供了一系列的可重用的 Vue 組件和函數(shù),本文將介紹 Vueuse 的主要特點和用法,以及它在 Vue.js 開發(fā)中的作用和優(yōu)勢,感興趣的可以了解下2024-02-02