百度编辑器UEditor的插件开发

作者:  最后修改:2013年12月11日  浏览数:1930

1. 概述

  UEditor是由百度web前端研发部开发的所见即所得富文本web编辑器,具有轻量、可定制、注重用户体验等特点,开源基于BSD协议,允许自由使用和修改代码。

2. 下载UEditor

  截至2013.11.27,最新版本为1.3.5,下面是具体的相关文档的下载地址:

  百度官网下载地址:http://ueditor.baidu.com/website/download.html#ueditor

  官方文档资料地址: http://ueditor.baidu.com/website/document.html

  官方API地址:http://ueditor.baidu.com/doc/

3. 源码包文件说明

  从官网上下载完整源码包,解压到任意目录,解压后的源码目录结构如下所示:

  • _examples:编辑器的示例页面

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

  • themes:样式图片和样式文件

  • editor.config.js:编辑器的配置文件

  • editor.api.js:开发版的所有js文件导入

  • editor.all.js:使用版的所有js文件

  • lang:语言文件

  • jsp、net、php:涉及到服务器端操作的文件

  • third-party:第三方插件

4. 部署和使用

  UEditor可供普通用户使用,同时UEditor的插件机制也为二次开发者提供了自定义插件的开发。

  1) 在项目的任一文件夹中建立一个用于存放UEditor相关资源和文件的目录。

  2)创建简单的编辑器实例,首先在html页面中准备一个dom容器,容器可以是<textarea id="editor"></textarea>或<div id="editor"></div>,也可以是<script type="text/plain" id="editor"></script>标签。

  3)引入相关文件

  4)创建编辑器

  说明:使用<textarea> 和 <script type="text/plain"> 标签做渲染容器,可以在容器中设置编辑器初始化的内容,如:

  <textarea id="editor">编辑器初始化的内容</textarea>;

  <script type="text/plain" id="myEditor">编辑器初始化的内容</script>;

  但是如果使用div作为渲染容器,就不可以在标签里设置初始值,但可通过在创建编辑器的时候配置initialContent参数来设置初始值。

5. 自定义插件的开发

5.1 UEditor的整体架构

  UEditor的架构设计采用了传统的分层架构模式,从低到高依次分为核心层、命令插件层和UI层这样三个低耦合的层次。

  1) 核心层提供了编辑器底层的一些方法和概念,如DOM树操作、Selection、Range等;

  2) 在核心层之上覆盖的是命令插件层;

  3) 在命令插件层之上则是UI层。

5.2 UEditor的插件机制

  从根本上来说,除了核心提供的几个编辑器底层封装类之外,UEditor的全部功能都是通过外挂插件或者是命令(实质上也可以看成特殊的插件)来实现的。UEditor中插件的实质是在编辑器实例下面绑定的一个以插件名字命名的函数,然后通过编辑器实例化过程去执行这个函数,并将实例对象传递到插件内部作为其this对象来完成所有的功能操作。

5.3 自定义插件的开发

  1) editor.config.js配置文件中的toolbars项添加插件名,如分页插件:zpagebreak,toolbars:[[..,'zpagebreak']];

  2) editor.config.js配置文件中的labelMap项添加鼠标移入插件提示文字:labelMap:{..,'zpagebreak':'分页'};

  3) 在_src/ui/editorui.js文件中的命令按钮项btnCmds添加插件名:btnCmds = [..,'zpagebreak'];;

  4) 插件内部结构

  5) 插件具体写法

  //editor.selection.getRange() 获取选取

  //editor类,此类用于初始化的一些设置,比如获取内容,设置高宽,设置 编辑器内容等等。

  //domUtils类,Dom操作工具包。

  //  utils类,静态工具函数包

  //browser类,此类用于检测浏览器。

  //EventBase类,此类用基础事件的注册类,比如鼠标,键盘事件等。

  //ajax类,此类用于ajax工具类。

  示例1:命令式插件1(分页)                

  分页命令插件的执行主体用到的方法大体如下:

  1) 获取选区


  2) 往选区插入分页标识:   

  3)根据分页标识分割内容  

  4)销毁编辑器      

  5)给插件按钮设置样式(每个工具栏按钮都会有一个’edui-for-‘加插件名的样式类名,如分页命名插件的样式类名:edui-for-zpagebreak)。

  示例2:命令式插件2(插入批注)

  插入批注命令插件用到的方法大体如下:

  1) 创建要插入的字符串   

  2)代码视图和设计视图切换时进行相应元素节点的替换

  3)设计视图转为源码视图的规则

  // 源码视图转为设计视图的规则     

4)给插件对象添加样式规则

  5)给插件按钮设置样式

  示例3:弹出框式插件(插入图片)

  弹出框式插件的执行主体用到的方法大体如下:

  1)实例化弹出框对象dialog,以及相关配置

  注:其中dialog宽高配置项由于开发包并未提供,所以需要用户自行扩展,更改源文件_src/ui/dialog.js,此处省略。

  2)给插件按钮设置样式

6. 其他常用方法

6.1 获取工具栏对象

6.2 销毁编辑器

6.3 删除所有编辑器实例

6.4  监听编辑器实例myEditor的focus事件

6.5 让编辑器选区中的节点被选中