【成都小课堂122期】如何使用富文本编辑器

大家好,我是IT修真院成都分院第五期的学员,一枚正直纯洁善良的web程序员

今天给大家分享一下,修真院官网js任务10,如何使用富文本编辑器

1.背景介绍

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

2.知识剖析

1、开始使用UEditor

2、定制自己的工具栏

3、UEditor简单初始化设置

知识点1:开始使用UEditor

(1)UEditor目录:

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

【成都小课堂122期】如何使用富文本编辑器_第1张图片

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

【成都小课堂122期】如何使用富文本编辑器_第2张图片

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

【成都小课堂122期】如何使用富文本编辑器_第3张图片

常用功能

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

常用初始设置:

【成都小课堂122期】如何使用富文本编辑器_第4张图片

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 文件


【成都小课堂122期】如何使用富文本编辑器_第5张图片

使用

基础用法

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


【成都小课堂122期】如何使用富文本编辑器_第6张图片

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

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

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

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

PPT链接

视频链接

技能树.IT修真院

“我们相信人人都可以成为一个工程师,现在开始,找个师兄,带你入门,掌控自己学习的节奏,学习的路上不再迷茫”。

这里是技能树.IT修真院,成千上万的师兄在这里找到了自己的学习路线,学习透明化,成长可见化,师兄1对1免费指导。快来与我一起学习吧 !

或者你可以直接点击此链接:邀请码链接

你可能感兴趣的:(【成都小课堂122期】如何使用富文本编辑器)