如何使用富文本编辑器

1.背景介绍

在做Web应用时,经常会进行富文本编辑,常用的富文本编辑器有很多,比如CuteEditor、CKEditor、NicEditor、KindEditor、UEditor等等。好的富文本编辑器可以让我们用户有更好的体验效果,带来更多的用户好评。在这里为大家推荐百度推出的UEditor,UEditor 是由百度「FEX前端研发团队」开发的所见即所得富文本web编辑器,具有轻量,可定制,注重用户体验等特点,开源基于MIT协议,允许自由使用和修改代码。主要还是大公司的没啥bug省事儿。

2.知识剖析

1、开始使用UEditor

2、定制自己的工具栏

3、UEditor简单初始化设置

知识点1:开始使用UEditor

(1)UEditor目录:

                            下载编辑器并解压,部署包解压后的文件目录结构如下所示

dialogs: 弹出对话框对应的资源和JS文件

lang: 编辑器国际化显示的文件

themes: 样式图片和样式文件

third-party: 第三方插件(包括代码高亮,源码编辑等组件)

ueditor.all.js: 开发版代码合并的结果,目录下所有文件的打包文件

ueditor.config.js: 编辑器的配置文件,建议和编辑器实例化页面置于同一目录

(2)UEditor部署:

在HTML中引入配置文件ueditor.config.js和源码文件ueditor.all.js以及jquery库

(3)实例化UEditor:

至此,UE富文本编辑器已经按照默认配置成功部署

知识点2:定制自己的工具栏

UEditor 工具栏上的按钮列表可以自定义配置,只需要通过修改配置项就可以实现需求

修改配置项的方法:

1. 方法一:修改 ueditor.config.js 里面的 toolbars

2. 方法二:实例化编辑器的时候传入 toolbars 参数

常用功能

知识点3:UEditor简单的初始化设置

常用初始设置:

3.常见问题

问题1:

实例创建后为什么直接执行接口报错?

问题2:

div标签自动转换为p标签

4.解决方案

问题1:

实例创建后为什么直接执行接口报错?

开发者在创建编辑器时后,会执行一些接口或者调用编辑命令,例如

var ue = UE.getEditor('editor');

ue.setContent('初始化的内容');

//或者调用命令

//ue.execCommand('inserthtml','内容');

这些代码看起来没有问题,编辑器实例也能正确拿到,但就是没有效果

其实出现这种问题,其实是大家不了解UEditor的创建原理导致的。因为UEditor的编辑区域使用iframe作为编辑容器。所以当编辑器创建实例后,先会创建一个iframe元素,然后在iframe元素中写入一些脚本,这些脚本会在iframe元素初始化完成时被调用。脚本的作用主要是为编辑器实例赋值iframe中的body,window,document对象的引用。 看到这里,大家就应该明白UEditor的初始化过程其实是个异步过程。

因为是个异步过程。所以场景中的书写方式就会出现问题了。虽然工厂方法getEditor能正确返回编辑器实例,但同步的代码ue.setContent马上就被执行了,因为setContent是在编辑容器中写内容,这时需要用到body,document等元素,但这些元素的引用赋值却在异步中才做的赋值。所以才会出现直接执行setContent时会出现无效的问题。当然有时不同浏览器的效果会出现不同。一些高级的浏览器比如chrome有时是可以的,但大部分ie浏览器都不行。这主要是因为浏览器的性能所致的。

那正确的方式是什么呢?

UEditor为开发者提供了ready接口,他会在编辑器所有的初始化操作都结束时调用。保证你要做的操作能在一个完整的初始化环境中执行。

UE.getEditor('editor').ready(function() {

//this是当前创建的编辑器实例

this.setContent('内容')

})

问题2:

div标签自动转换为p标签

背景:刚开始使用UEditor的开发者,会发现一个现象,粘贴到编辑器中的内容如果带有div标签,待粘贴到编辑器之后,会发现粘贴到编辑器中的div已经被转换为p标签了。

原因:首先这不是一个bug,这是UEditor对于进入编辑器中的数据进行的过滤处理。在UEditor中表示段落的标签是p标签,很多的编辑操作都是基于p标签进行的处理。

解决方案:

UE.getEditor('editorID', {

allowDivTransToP: false

})

5.编码实战

6.扩展思考

怎么给编辑器添加事件

UEditor内置了很多方法;如

ue.isFocus();//判断编辑器是否获得焦点 ;

ue.hasContents();//判断是否有内容

链接:http://fex.baidu.com/ueditor/#api-common常用方法

7.参考文献

参考:http://fex.baidu.com/ueditor/ UEditor文档

8.更多讨论

1.除了ueditor还有其他的富文本编辑器吗?

比较流行的还有新崛起的wangeditor,相比ueditor而言更加轻量,可定制性更强,但是因为是个人开发的,所以bug较多,且不稳定还需要完善。

2.udeitor在angular中的使用?

使用一款叫angular-ueditor的插件,使用时

先引入 UEditor 的 javascript 文件


使用

基础用法

由于继承了NgModelController,必须绑定ngModel


这个插件其实就是一个js文件,只不过他已经帮你封装了ueditor,使用时调用就可以了,所以需要先调用ueditor的文件

3.使用时ueditor里面不能插入input标签?

放在一个div里面,放在input之类的会失效,富文本编辑器,显示的是文本和图片,不能插入web组件input。

富文本编辑器是对某个元素的contenteditable设置为"true",让其编程可编辑的区域;而那些对齐方式(左对齐 右对齐之类)字体样式之类的按钮,其实是调用浏览器提供的方法来设置。

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

推荐阅读更多精彩内容