在 Vue 項(xiàng)目中引入 tinymce 富文本編輯器的完整代碼

更新時(shí)間：2018年05月04日 08:33:40 作者：WiseWrong

這篇文章主要介紹了在 Vue 項(xiàng)目中引入 tinymce 富文本編輯器的實(shí)例代碼,非常不錯(cuò)，具有一定的參考借鑒價(jià)值，需要的朋友可以參考下

項(xiàng)目中原本使用的富文本編輯器是 wangEditor，這是一個(gè)很輕量、簡潔編輯器

但是公司的業(yè)務(wù)升級(jí)，想要一個(gè)功能更全面的編輯器，我找了好久，目前常見的編輯器有這些：

UEditor：百度前端的開源項(xiàng)目，功能強(qiáng)大，基于 jQuery，但已經(jīng)沒有再維護(hù)，而且限定了后端代碼，修改起來比較費(fèi)勁

bootstrap-wysiwyg：微型，易用，小而美，只是 Bootstrap + jQuery...

kindEditor：功能強(qiáng)大，代碼簡潔，需要配置后臺(tái)，而且好久沒見更新了

wangEditor：輕量、簡潔、易用，但是升級(jí)到 3.x 之后，不便于定制化開發(fā)。不過作者很勤奮，廣義上和我是一家人，打個(gè)call

quill：本身功能不多，不過可以自行擴(kuò)展，api 也很好懂，如果能看懂英文的話...

summernote：沒深入研究，UI挺漂亮，也是一款小而美的編輯器，可是我需要大的

在有這么參考的情況下，我最終還是選擇了 tinymce 這個(gè)不搭梯子連官網(wǎng)都打不開的編輯器（簡直是自討苦吃），主要因?yàn)閮牲c(diǎn)：

1. GitHub 上星星很多，功能也齊全；

2. 唯一一個(gè)從 word 粘貼過來還能保持絕大部分格式的編輯器；

3. 不需要找后端人員掃碼改接口，前后端分離；

4. 說好的兩點(diǎn)呢！

一、資源下載

tinymce 官方為 vue 項(xiàng)目提供了一個(gè)組件 tinymce-vue

npm install @tinymce/tinymce-vue -S

在 vscode、webstorm 的終端運(yùn)行這段代碼可能會(huì)報(bào)錯(cuò)，最好使用操作系統(tǒng)自帶的命令行工具

如果有購買 tinymce 的服務(wù)，可以參考 tinymce-vue 的說明，通過 api-key 直接使用 tinymce

像我這樣沒購買的，還是要老老實(shí)實(shí)下載 tinymce

npm install tinymce -S

安裝之后，在 node_modules 中找到 tinymce/skins 目錄，然后將 skins 目錄拷貝到 static 目錄下

// 如果是使用 vue-cli 3.x 構(gòu)建的 typescript 項(xiàng)目，就放到 public 目錄下，文中所有 static 目錄相關(guān)都這樣處理

tinymce 默認(rèn)是英文界面，所以還需要下載一個(gè)中文語言包（記得搭梯子！搭梯子！搭梯子?。?/p>

然后將這個(gè)語言包放到 static 目錄下，為了結(jié)構(gòu)清晰，我包了一層 tinymce 目錄

二、初始化

在頁面中引入以下文件

import tinymce from 'tinymce/tinymce'
import 'tinymce/themes/modern/theme'
import Editor from '@tinymce/tinymce-vue'

tinymce-vue 是一個(gè)組件，需要在 components 中注冊(cè)，然后直接使用

這里的 init 是 tinymce 初始化配置項(xiàng)，后面會(huì)講到一些關(guān)鍵的 api，完整 api 可以參考官方文檔

編輯器需要一個(gè) skin 才能正常工作，所以要設(shè)置一個(gè) skin_url 指向之前復(fù)制出來的 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 項(xiàng)目，將 url 中的 static 去掉，即 skin_url: '/tinymce/skins/lightgray'

同時(shí)在 mounted 中也需要初始化一次：

如果在這里傳入上面的 init 對(duì)象，并不能生效，但什么參數(shù)都不傳也會(huì)報(bào)錯(cuò)，所以這里傳入一個(gè)空對(duì)象

三、擴(kuò)展插件

完成了上面的初始化之后，就已經(jīng)能正常運(yùn)行編輯器了，但只有一些基本功能

tinymce 通過添加插件 plugins 的方式來添加功能

比如要添加一個(gè)上傳圖片的功能，就需要用到 image 插件，添加超鏈接需要用到 link 插件

同時(shí)還需要在頁面引入這些插件：

添加了插件之后，默認(rèn)會(huì)在工具欄 toolbar 上添加對(duì)應(yīng)的功能按鈕，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: '請(qǐng)輸入內(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>