Vue环境下tinymce简易教程(优化图片上传+powerpaste插件配置指南+主题切换与生成)

环境

VUE webpack tinymce4

额外插件

  1. 用于优化本地图片上传的第三方插件:tinymce-imageupload
  2. 用于加强word源复制粘帖的官方插件(这是收费插件,我这里不提供资源,只是教大家怎么配置):wordpress

开撸

安装tinymce-vue

npm install @tinymce/tinymce-vue -S

安装tinymce 4.x.x

npm install tinymce@4.5.10 -S

安装好之后,需要将node_modules目录下面的tinymce/skins目录放到一个可以访问到的地方(一般来说是static目录,也可以是CDN之类的,反正能访问到就行)

<u>特别注意:本文内容是基于tinymce4所搭建的,现在最新的已经是5.x.x的版本了,结构目录有所改变,需要调整skin_url和导入对应的主题。</u>

安装中文语言包

官网语言包下载地址
选择你想要的语言下载即可(别跟我说不认识Chinese (China)
下载后将得到zh_CN.js文件(以简体中文为例),同样,放到一个你能访问到的地方(static目录或CDN)

引入依赖项

import tinymce from 'tinymce/tinymce';
import 'tinymce/themes/modern/theme';   //  具体有有些默认主题,可以在`node_modules`的`tinymce`下找到(这个据我所知,也是必须要引入的)
import Editor from '@tinymce/tinymce-vue';

初始化编辑器

添加配置对象:

content: '',
editorInit: {
  language: 'zh_CN',    //  指定语言
  language_url: '/static/tinymce/zh_CN.js', //  指定语言包地址
  skin_url: '/static/tinymce4/skins/lightgray', //  指定主题地址(必须项,否则编辑器不能成功渲染出来)
  height: 300
}

在templete中添加一个Editor元素

<editor v-model='content' :init='editorInit'></editor>

完成!应该就可以看到页面能成功将编辑器渲染出来了。

添加插件

tinymce已自带了很多常用插件,但是很多默认是不启用的,需要主动引用并配置才行,这里我们以添加全屏插件fullscreen为例:

  1. 引入
import 'tinymce/plugins/fullscreen';

editorInit中配置

editorInit: {
  ...
  plugins: "fullscreen",    //  多个插件,用空格分隔
  ...
}

常用配置

editorInit: {
  ...
  statusbar: false, //  是否显示底部状态栏
  menubar: false,   //  配置菜单栏(设置为false则隐藏)
  toolbar: "fullscreen | bold italic",   //  工具之间用空格分隔,| 表示显示一个分块符
  //    editor为当前编辑器的实例对象
  setup: function(editor) {
    //  这里为给编辑器绑定一个单击事件
    editor.on('click', function(e) {
      console.log('Editor was clicked');
    });
  }
  }
  ...
}

支持粘帖图片

  1. 引入
import 'tinymce/plugins/paste'
  1. 添加配置
editorInit: {
  ...
  paste_data_images: true,  //  设置为允许粘帖图片
  //    上传方式1:填写images_upload_url和images_upload_base_path
  images_upload_url: '/upload', //  图片上传地址
  images_upload_base_path: '/some/basepath',
  //    上传方式2(建议这种):自定义上传逻辑
  images_upload_handler: function (blobInfo, success, failure) {
  }
  ...
}

优化图片上传

其实我觉得开启支持粘帖图片和powerpaste之后,就不需要这个了。如果有这方面的需求,可以参考这个。安装比较简单,给个github地址,自己看下吧,和普通plugins基本无异。
https://github.com/x-shadow-x/tinymce-imageupload
效果图:

image

PS:这个插件在tinymce5上无法使用,而且配置上不是那么的灵活,如果想用,建议基于改插件,做一些修改。

添加powerpaste插件

  1. 需要自行下载好对应版本的powerpaste(实在找不到可以私信我),我下载的是powerpast4.0.1-317
    image
  2. 放到一个一个你能访问到的地方
  3. 很重要的一步,我看到网上很多“教程”说如果是用npm安装tinymce不能使用powerpaste,其实呢,只要花点心思读读官方文档,就可以发现,其实是可以的,只要利用external_plugins配置一下就OJBK了
editorInit: {
  ...
  //    添加扩展插件
  external_plugins: {
    'powerpaste': '/static/tinymce/powerpaste/plugin.min.js'
  }
  powerpaste_word_import: 'propmt',// 参数可以是propmt, merge, clear,效果自行切换对比
  powerpaste_html_import: 'propmt',// propmt, merge, clear
  powerpaste_allow_local_images: true,
  ...
}
  1. powerpaste详细配置项可以再参考powerpaste插件使用手册
  2. 添加好之后,当从word复制内容到tinymce时,便会提示是否要保留格式:


    image

PS:如果是从WPS复制带有图片的内容,会无法成功粘帖图片,从office复制是可以的。

切换/生成主题

主题生成网站:http://skin.tiny.cloud/

image

下载下来的主题怎么用?
很简单,用skin_url配置一下目录地址就OK了

editorInit: {
  ...
  skin_url: '/static/tinymce4/skins/myskin',
  ...
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,602评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,442评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,878评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,306评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,330评论 5 373
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,071评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,382评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,006评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,512评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,965评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,094评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,732评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,283评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,286评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,512评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,536评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,828评论 2 345

推荐阅读更多精彩内容