2020-03-03 Vue快速部署UEditor富文本编辑器

情景:

1、UEditor 依然是国内使用频率极高的所见即所得编辑器而 Vue 又有着广泛的使用,所以将两者结合使用,是很多 Vue 项目开发者的切实需求。
2、目前没有发现满足这种需求,而使用又很方便的 repo、有的可能也只是简单的暴露一个 UEditor 的实例,仍然需要开发者手动去调用 getContent,setContent,而通过 v-model 绑定数据也是很多人期待的方式。

于是,就有前人封装了双向绑定的UEditor 组件,使用起来便捷。UEditor 官方不再积极维护,并且作者也将持续优化和修复UEditor 停更带来的一些问题。

插件地址(有详细说明):https://github.com/HaoChuan9421/vue-ueditor-wrap

1.快速安装:

npm i vue-ueditor-wrap --save
#或者
yarn add vue-ueditor-wrap --save

2.下载UEditor对应的后端文件(上传文件相关)及插件配置文件

https://github.com/HaoChuan9421/vue-ueditor-wrap/tree/master/assets/downloads
将下载的压缩包解压并重命名为 UEditor(只需要选择一个你需要的版本,比如 utf8-php),放入你项目的 static 目录下。
如果你使用的是 vue-cli 3.x,可以把 UEditor 文件夹放入项目的 public 目录下。
如果你使用的是webpack自己搭建的框架,暂时还没有告诉webpack做个static是静态资源文件目录,不需要被编译打包,只需要拷贝到生产环境中,可以在webpack配置下插件:

  plugins: [
    new CopyWebpackPlugin(
       [
         {
            from: 'static',
            to: './static'
         }
       ]
    )
 ]

3.引入VueUeditorWrap组件

import VueUeditorWrap from 'vue-ueditor-wrap' // ES6 Module
// 或者
const VueUeditorWrap = require('vue-ueditor-wrap') // CommonJS

你也可以通过直接引入 CDN 链接的方式来使用,它会暴露一个全局的 VueUeditorWrap 变量(具体如何使用你可以阅读作者的这篇博客或参考这个仓库)。

4.注册组件

components: {
  VueUeditorWrap
}
// 或者在 main.js 里将它注册为全局组件
Vue.component('vue-ueditor-wrap', VueUeditorWrap)
<script src="https://cdn.jsdelivr.net/npm/vue-ueditor-wrap@latest/lib/vue-ueditor-wrap.min.js"></script>

5.v-model绑定数据

<vue-ueditor-wrap v-model="msg" :config="myConfig"></vue-ueditor-wrap>
data () {
  return {
    msg: '<h2><img src="http://img.baidu.com/hi/jx2/j_0003.gif"/>Vue + UEditor + v-model双向绑定</h2>',
    myConfig: {
      // 编辑器不自动被内容撑高
      autoHeightEnabled: false,
      // 初始容器高度
      initialFrameHeight: 240,
      // 初始容器宽度
      initialFrameWidth: '100%',
      // 上传文件接口(这个地址是我为了方便各位体验文件上传功能搭建的临时接口,请勿在生产环境使用!!!)
      serverUrl: 'http://35.201.165.105:8000/controller.php',
      // UEditor 资源文件的存放路径,如果你使用的是 vue-cli 生成的项目,通常不需要设置该选项,vue-ueditor-wrap 会自动处理常见的情况,如果需要特殊配置,参考下方的常见问题2
      UEDITOR_HOME_URL: '/static/UEditor/'
    }
  }
}

6.效果

image.png

7.配置拓展(源码分析,二次开发)

通过查看作者封装的组件源码:node_modules\vue-ueditor-wrap\src\components\vue-ueditor-wrap.vue
我们可以发现作者是通过查询UEditor文件目录并调用了ueditor.config.js和ueditor.all.min.js文件
这也解释了为什么要在static创建UEditor文件目录的原因
查找静态文件夹下名称为UEditor文件夹路径

调用ueditor.config.js

调用ueditor.all.min.js
因此我们可以对ueditor.config.js和ueditor.all.min这两个文件进行修改和定制:
(一)字体种类的添加:

ueditor编辑器默认只提供了11中字体,而实际的应用中,这些字体还是太少,无法满足各种需求,所以需要进行字体种类的添加,
具体需要同步修改三个文件:ueditor.config.js、zh-cn.js、en.js,在fontfamily处添加需要的字体类型即可,操作如下:


ueditor.config.js

zh-cn.js

en.js
(二)修改字号显示方式为中文word字号显示方式 :

1、打开ueditor.config.js,搜索“'fontsize':”,定位到如下代码:

    // 'fontsize': [10, 11, 12, 14, 16, 18, 20, 24, 36]

2、在注释项下添加如下代码

        'fontsize': [
             { name: '\u516d\u53f7', val: 10},
             { name: '\u5c0f\u4e94', val: 12},
             { name: '\u4e94\u53f7', val: 14},
             { name: '\u5c0f\u56db', val: 16},
             { name: '\u56db\u53f7', val: 18},
             { name: '\u5c0f\u4e09', val: 20},
             { name: '\u4e09\u53f7', val: 21},
             { name: '\u5c0f\u4e8c', val: 24},
             { name: '\u4e8c\u53f7', val: 29},
             { name: '\u5c0f\u4e00', val: 32},
             { name: '\u4e00\u53f7', val: 34},
             { name: '\u5c0f\u521d', val: 48},
             { name: '\u521d\u53f7', val: 56}
         ]

P.S:由于fontsize配置项接收的只有数字,没有接收name、val这样的对象集合,我们需要去修改方法中的源码
并且由于WEB字号低于10没有什么使用价值,仅添加10px以上的字体,名称可以自己定义,只要把中文转为UNICODE就行了(貌似不转换直接用中文字符串也可以)。

3.打开ueditor.all.js,搜索“editorui.fontsize”,定位到如下代码:

    editorui.fontsize = function (editor, list, title) {
      title = editor.options.labelMap['fontsize'] || editor.getLang("labelMap.fontsize") || '';
      list = list || editor.options['fontsize'] || [];
      if (!list.length) return;
      var items = [];
      for (var i = 0; i < list.length; i++) {
        var sizename = list[i].name;
        var size = list[i].val + 'px';
        items.push({
          label: sizename,
          value: size,
          theme: editor.options.theme,
          renderLabelHtml: function () {
            return '<div class="edui-label %%-label" style="line-height:1;font-size:' +
              this.value + '">' + (this.label || '') + '</div>';
          }
        });
      }

将这段代码:

for (var i = 0; i < list.length; i++) {
            var size = list[i] + 'px';
            items.push({
                label:size,
                value:size,

改为:

for (var i = 0; i < list.length; i++) {
            var sizename = list[i].name;
            var size = list[i].val + 'px';
            items.push({
                label:sizename,
                value:size,

可以看到思路就在于把原来以像素字号表示的简单的fontsize属性细化,模仿了font-family的键值对书写方式,添加name和val两个属性,再在下方的ui代码拼接的地方将细化后的sizename和name值分别输出。

【注意】:作者在UEditor插件中默认引入的是ueditor.all.min.js,但这是压缩过的代码,不方便编辑。我们可以把ueditor.all.js重命名为ueditor.all.min.js

这样在实际生成的编辑器实例中即可看到生效


字号效果

8.更多配置项说明

完整配置选项查看 ueditor.config.js 源码或 官方文档

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

推荐阅读更多精彩内容