ueditor源代码重点难点分析

网上好像几乎没有研究ueditor源码的文章,原因可能是ueditor源码太复杂了,接近浏览器代码和word/excel源码。本文分析ueditor源码整体流程逻辑以及重点难点细节。

首先,编辑器是如何实现输入的?本人开始始终不得其解,在源码找不到输入事件绑定的处理函数,后来在白云峰同学的提醒下才顿悟,整个iframe网页就相当于是一个元素:</p> <body class="view" contenteditable="true" spellcheck="false" style="overflow-y: hidden; height: 500px; cursor: text;"> </body> <p>页面调用ueditor: </p> <script id="editor" type="text/plain" style="width:100%;height:500px;" ></script> // iframe的container元素 <p>  var editor = UE.getEditor('editor');</p> <p>多次调用可以多实例运行,每个实例都是单独的,编辑器实例保存在UE实例中,从UE.instants[]也可以获取到每个编辑器实例,0就是第一个实例,以此类推,<br>因此可以不用变量引用编辑器实例:<br>UE.getEditor('editor');<br>  setTimeout(function(){<br>    UE.instants.ueditorInstant0.setContent('<div>欢迎使用编辑器</div>');<br>  },1000);</p> <p>执行ueditor文件之后产生三个全局对象:<br>UEDITORUI - 所有工具按钮插件的api<br>UE - api入口<br>UEDITOR_CONFIG - 配置数据</p> <p>先看ueditor的全局api接口:</p> <p>window.UE = baidu.editor = window.UE || {}; // UE实例提供ueditor的入口接口,也就是api入口,调用UE的方法才创建真正的编辑器实例 </p> <p>var Editor = UE.Editor = function (options) { // 这是编辑器构造函数</p> <p>/* 尝试异步加载后台配置 */<br>me.loadServerConfig(); //所谓异步加载就是用js构造<tag src=url加载文件,正常是直接在网页写<tag src=url 加载文件<br>UE.Editor.prototype.loadServerConfig = function(){<br>//用ajax请求<a href="http://localhost/plugins/ueditor/ueditor/php/controller.php?action=config&&noCache=1525847581688%EF%BC%8C%E8%BF%94%E5%9B%9E%E5%90%8E%E5%8F%B0php%E9%85%8D%E7%BD%AE%E5%8F%82%E6%95%B0%EF%BC%8C%E4%B8%BB%E8%A6%81%E6%98%AF%E6%B6%89%E5%8F%8Aupload%E7%9A%84%E9%85%8D%E7%BD%AE%E5%8F%82%E6%95%B0%EF%BC%8C%E5%85%B6%E5%AE%9E%E5%89%8D%E7%AB%AF%E7%9A%84%E9%85%8D%E7%BD%AE%E6%95%B0%E6%8D%AE%E5%8F%AF%E4%BB%A5%E7%9B%B4%E6%8E%A5%E5%86%99%E4%B8%80%E4%B8%AAjs%E6%96%87%E4%BB%B6%E7%9B%B4%E6%8E%A5%E4%BB%8E%E7%BD%91%E9%A1%B5%E5%86%99">http://localhost/plugins/ueditor/ueditor/php/controller.php?action=config&&noCache=1525847581688,返回后台php配置参数,主要是涉及upload的配置参数,其实前端的配置数据可以直接写一个js文件直接从网页写</a><script src=加载。<br>  element.onload = element.onreadystatechange = function () { // 这是构造<tag src=url加载文件之后再通过onload事件触发执行一个回调<br>}<br>} </p> <p>if(!utils.isEmptyObject(UE.I18N)){ // i18n是语言国际化,就是多语言包<br>//修改默认的语言类型<br>  me.options.lang = checkCurLang(UE.I18N);<br>  UE.plugin.load(me);<br>  langReadied(me);<br>}else{<br>  utils.loadFile(document, {<br>  src: me.options.langPath + me.options.lang + "/" + me.options.lang + ".js", //加载zh-cn.js中英文对照语言包<br>}, function () { // 这个匿名函数回调会执行一次,具体是在哪一次加载文件时执行的不清楚<br>  UE.plugin.load(me); // 这是加载内部插件,执行ueditor文件时会执行UE.plugin.register()注册所有的插件,然后在这里加载所有的插件<br>  UE.plugin = function(){<br>    var _plugins = {};<br>    return {<br>      register : function(pluginName,fn,oldOptionName,afterDisabled){<br>        _plugins[pluginName] = {<br>        optionName : oldOptionName || pluginName,<br>        execFn : fn,<br>//当插件被禁用时执行<br>        afterDisabled : afterDisabled<br>        }<br>      },<br>    load : function(editor){ // 这就是load()函数,加载插件,所有的插件在执行ueditor文件时已经注册<br>      utils.each(_plugins,function(plugin){ //_plugins是执行register方法产生的插件集合<br>        var _export = plugin.execFn.call(editor); //execFn是plugin的构造函数,执行构造函数产生plugin object {}<br>        utils.each(_export,function(v,k){ // 针对plugin的每一个属性处理一次,把plugin的方法函数保存到编辑器实例中<br>          switch(k.toLowerCase()){<br>            case 'commands':<br>              utils.each(v,function(execFn,execName){<br>                editor.commands[execName] = execFn //editor.commands{}含所有的按钮操作指令<br>              });<br>          });<br>          utils.each(UE.plugins,function(plugin){ // 插件好像分两部分有两种写法,这是针对旧写法插件进行处理<br>            plugin.call(editor); //执行插件构造函数<br>          }); </p> <p>      langReadied(me);<br>    });<br>      //loadFile代码:<br>      return function (doc, obj, fn) { // fn就是传入的匿名函数,用<script src=url加载执行js文件之后再执行这个回调函数<br>        doc.getElementsByTagName("head")[0].appendChild(element); // 构造<script src=加载执行zh-cn.js文件<br>      }<br>  }<br>  UE.instants['ueditorInstant' + me.uid] = me; // 如果多实例运行,均存储在UE中,每个实例按id区分,多实例运行可以利用UE.instants[id]找实例,把每个编辑器实例保存在自己定义的全局对象中也可以<br>}</p> <p>Editor.prototype = {<br>  render: function (container) { // container是iframe holder,之前已经构造iframe相关的几个div插入网页,render方法构造iframe代码并且把iframe插入网页生效<br>    var me = this,<br>    options = me.options, // options是实例里面的参数,包含config参数<br>    var html = 'iframe里面的html代码';<br>    container.appendChild(domUtils.createElement(document, 'iframe', { // 插入iframe,并执行以下js代码<br>      editor = window.parent.UE.instants['ueditorInstant0']; // ueditor实例保存在iframe的父窗口也就是当前网页窗口<br>      editor._setup(document);<br>    }));<br>  },<br>  _setup: function (doc) {<br>    doc.body.contentEditable = true; // iframe html相当于一个input<br>  }<br>} </p> <p>先建立一个UE实例放在全局,入口初始化方法是getEditor。</p> <p>再看编辑器初始化入口:</p> <p>UE.getEditor = function (id, opt) {<br>  var editor = instances[id];<br>  if (!editor) {<br>    editor = instances[id] = new UE.ui.Editor(opt); // UE是api入口实例,editor是编辑器实例<br>    editor.render(id); //执行新的render,构造几个/几层container元素,再执行old render,构造iframe代码插入网页<br>  }<br>  return editor;<br>}; </p> <p>UE.ui.Editor = function (options) {<br>  var editor = new UE.Editor(options); // 这是真正的编辑器实例<br>  var oldRender = editor.render; // UE.editor的render方法(构造iframe插入网页)<br>  editor.render = function (holder) { // 重新构造一个render,构造几个容器元素,然后再调old render构造iframe<br>    utils.domReady(function () { //事件触发异步调度执行<br>      editor.langIsReady ? renderUI() : editor.addListener("langReady", renderUI);<br>        function renderUI() { //事件触发异步调度执行<br>          new EditorUI(editor.options); // 没有接收实例,在其它程序位置不能引用这个实例,在实例的方法中用this引用实例,在事件handler中引用实例(实例“复制”到handler方法中),这是创建实例后如何使用实例的高级方法<br>            function EditorUI(options) {<br>              this.initOptions(options);<br>                UIBase.prototype = {<br>                  initOptions:function (options) {<br>                  //把options复制到EditorUI实例中<br>                  }<br>              this.initEditorUI();<br>                EditorUI.prototype = {<br>                  initEditorUI:function () {<br>                    //用addeventlistener绑定鼠标操作事件和处理函数<br>                  }<br>                }<br>          var newDiv = document.createElement('div'); //在这里创建div插入网页替换<script>元素,并且复制css代码<br>          holder.parentNode.insertBefore(newDiv, holder);<br>          newDiv.style.cssText = holder.style.cssText;<br>          holder = newDiv;<br>          holder.innerHTML = 'xxx';<br>          editor.ui.render(holder); //重新构造iframe外层html代码以及iframe元素代码,render方法代码如下:<br>            UIBase.prototype = {<br>              render:function (holder) {<br>            } </p> <p>          opt.initialFrameHeight = opt.minFrameHeight = holder.offset; //是在这里设置跟随页面写的height<br>          oldRender.call(editor, editor.ui.getDom('iframeholder')); //再执行oldrender,构造iframe插入网页<br>          editor.fireEvent("afteruiready"); // 没有on这个事件的,有何用?<br>        });<br>      };<br>      return editor; //如果没有返回语句,产生的实例是new UE.ui.Editor(opt)实例,由于有返回语句,产生的实例是返回的实例new UE.Editor(options)实例<br>  }</p> <p>执行ueditor文件时注册所有的插件,执行UE.getEditor()产生new UE.Editor(options)编辑器实例,初始化编辑器,加载插件,绑定鼠标操作事件handler,构造div和iframe。<br>ueditor的功能组件以plugin插件形式设计,插件代码是ueditor最主要的功能代码,其功能和复杂程度类似word/excel。</p> <p>ueditor就是一个textarea框,输入文字内容,自动产生html元素,插入图片产生img元素,最终产生的数据是html代码串,提交到后台保存到数据库。</p> <p>正常显示时是显示iframe里面的html网页,预览html代码时,是显示一个与iframe平级的div,隐藏iframe元素节点不显示: </p> <div class="CodeMirror-scroll cm-s-default" tabindex="-1" style="position: absolute; left: 0px; top: 0px; width: 100%; height: 100%;"> <p>插入html代码时,先构造一个div,然后用div.innerHTML=插入的html字符串 解析html字符串成为DOM元素对象,再把div.firstChild插入到网页中一个<p>元素里面<br>生效,比如插入<div>hello</div>,显示hello,不会把<div>显示出来。</p> <p>再看结束编辑获取编辑器内容的代码:</p> <p>getContent: function (cmd, fn,notSetCursor,ignoreBlank,formatter) {<br>  var root = UE.htmlparser(me.body.innerHTML,ignoreBlank); // html -> root -> html 解析处理过程非常复杂<br>  return root.toHtml(formatter); </p> <p>    var htmlparser = UE.htmlparser = function (htmlstr,ignoreBlank) { </p> <p>      var re_tag = /<(?:(?:\/([^>]+)>)|(?:!--([\S|\s]*?)-->)|(?:([^\s\/<>]+)\s*((?:(?:"[^"]*")|(?:'[^']*')|[^"'<>])*)\/?>))/g, //html标签的正则匹配表达式,比如<TD vAlign=top background=../AAA.JPG> </p> <p>      htmlstr = htmlstr.replace(new RegExp('[\\r\\t\\n'+(ignoreBlank?'':' ')+']*<\/?(\\w+)\\s*(?:[^>]*)>[\\r\\t\\n'+(ignoreBlank?'':' ')+']*','g'), function(a,b){ // 正则匹配替换 </p> <p>      toHtml:function (formatter) {<br>        var arr = [];<br>        nodeToHtml(this, arr, formatter, 0); </p> <p>          function nodeToHtml(node, arr, formatter, current) {<br>            switch (node.type) {<br>              case 'root':<br>                for (var i = 0, ci; ci = node.children[i++];) {<br>                  nodeToHtml(ci, arr, formatter, current) // 递归子节点 </p> <p>                  return arr.join('') </p> <p>可见获取编辑器的内容就是获取iframe网页的内容body.innerHTML现成的html代码,很简单,但解析处理非常复杂,有内置过滤规则处理,有点类似框架的<br>template/vnode解析处理,要递归解析处理所有的子节点。</p> <p>编辑器头部是工具按钮,都是以插件形式实现的,下面以点击“模板”工具按钮为例分析ueditor的工具按钮插件是如何实现的。</p> <p>点击模板(template)按钮是插入模板,会显示一个弹窗对话框:</p> <div id="edui221" class="edui-dialog edui-for-template edui-default edui-state-centered" style="left: 10px; top: 88px; z-index: 110;"> <p>里面是一个iframe加载一个网页: </p> <iframe id="edui221\_iframe" class="%%-iframe" height="100%" width="100%" frameborder="0" src="https://my.oschina.net/ueditor/dialogs/template/template.html"></iframe> <p>这个网页就是一个列表,选择之后关闭弹窗,把选择的内容插入编辑器中。</p> <p>注意dialog会话弹窗层iframe不在编辑器层iframe里面,而是在当前网页里面,当前网页有几个container容器,其中一个放编辑器iframe,一个放dialog iframe,还有编辑器的头部/底部都是单独的容器,都不在编辑器容器里面。凡是跨iframe都有传递数据问题,因此dialog弹窗也有传递数据问题,后面会分析它如何传递数据。</p> <p>iframe网页会执行internal.js建立环境:</p> <p>dialog = parent.$EDITORUI[window.frameElement.id.replace( /_iframe$/, '' )]; // dialog实例是从父网页获取的,含父网页中编辑器实例<br>editor = dialog.editor; //当前打开dialog的编辑器实例</p> <p>dialog.onok = function () {<br>  me.execCommand( "template", obj ); //执行template命令, obj.html就是选取的template代码,me是editor实例 </p> <p>    //重写execCommand命令,用于处理框选时的处理<br>    var oldExecCommand = me.execCommand;<br>    me.execCommand = function (cmd, datatat) {<br>      result = oldExecCommand.apply(me, arguments); // oldExecCommand代码如下 </p> <p>        execCommand: function (cmdName) {<br>          result = this._callCmdFn('execCommand', arguments); </p> <p>            _callCmdFn: function (fnName, args) {<br>              return cmdFn.apply(this, args); </p> <p>                UE.plugins['template'] = function () {<br>                  UE.commands['template'] = {<br>                    execCommand:function (cmd, obj) { // cmd=template<br>                      obj.html && this.execCommand("inserthtml", obj.html);//再次递归editor实例的execCommand,但这次是执行inserthtml命令,会执行到以下代码 </p> <p>UE.commands['inserthtml'] = {<br>  execCommand: function (command,html,notNeedFilter){ // 把选取的template插入编辑器网页<br>    range = me.selection.getRange(); // 获取编辑器中dialog会话弹窗之前光标选中的区域,也就是template插入的位置 </p> <p>      getRange:function () {<br>        var range = new baidu.editor.dom.Range( me.document ); // 创建range对象,数据结构与js原生selection对象一样<br>        var sel = me.getNative(); // 调window.getSelection()返回点击选取的节点数据,此时已经点击工具按钮,之前点击选取的光标状态已经不在,获取不到点击选取数据,单步看获取的数据是空的,因此要使用之前保存的selection数据。 </p> <p>          getNative:function () {<br>            return domUtils.getWindow( doc ).getSelection();<br>          }, </p> <p>        if ( this._bakRange && domUtils.inDoc( this._bakRange.startContainer, this.document ) ){<br>          return this._bakRange; //之前在编辑器点击选取触发执行getNative保存的selection数据,container=text,offset=1(没有意义)<br>        }<br>      } </p> <p>   //如果当前位置选中了fillchar要干掉,要不会产生空行<br>   if(range.inFillChar()){ // 插入第一个子节点第一次执行时range是#text填充符<br>    child = range.startContainer; // 是text节点<br>    if(domUtils.isFillChar(child)){ // 插入第一个子节点第一次执行时start container是#text填充符<br>      range.setStartBefore(child).collapse(true); //设置container=p,offset=0(#text节点在p中的index),collapse(折叠)意思是设置end=start,如果选中一段再插入就有start container/end container问题。 setStartBefore(child)意思就是要插入到child之前,但要获取child在父节点中的offset,插入时在父节点中按offset再获取child,再插入到child之前<br>domUtils.remove(child); // 删除#text节点,那么在p节点内部offset=0是br节点 </p> <p>    }else if(domUtils.isFillChar(child,true)){<br>      child.nodeValue = child.nodeValue.replace(fillCharReg,'');<br>      range.startOffset--;<br>      range.collapsed && range.collapse(true)<br>    }<br>  }</p> <p>  while ( child = div.firstChild ) { // 递归循环div的子节点把div的子节点一个一个插入(div不插入),如果把div整个插入,就多了div层,其实可以用frag,把frag整个插入即可,但插入第一个子节点时start container是p节点,插入之后要调整start container=body,从第二个子节点开始都是插入body,所以还不能整个一次插入,挺复杂的。 </p> <p>    if(hadBreak){ //第一次执行时hadBreak=0,不执行这段,之后再执行时hadBreak=1,会执行这段,hadBreak表示已经切割container元素,<br>      var p = me.document.createElement('p');<br>      while(child && (child.nodeType == 3 || !dtd.$block[child.tagName])){ // 如果要插入的节点是#text节点则套一层p,为何?<br>        nextNode = child.nextSibling;<br>        p.appendChild(child); //child是引用div子节点,那么div子节点插入到p就从div移动到p,div中已经没有child,所以循环n次之后div就变空了<br>        child = nextNode;<br>      } // 如果是文本节点就插入到p元素里面,如果有一批文本节点就循环全部插入到p元素里面,再把p做为child节点<br>      if(p.firstChild){<br>        child = p //<br>      }<br>    } //第n次执行时插入的node是内容节点,不会外套一层p,这段不起作用 </p> <p>    range.insertNode( child ); // 第一次插入子节点时把node插入到<p>的<br>之前,之后插入到body里面<p>之前 </p> <p>      insertNode:function (node) { // 编辑器头尾有​空格文本节点,第一次执行时是插入填充节点,第n次执行时是插入内容节点<br>        var first = node, length = 1;<br>        var start = this.startContainer, //单步看插入第二个子节点时,是<body>,offset是2指向<p><br>        offset = this.startOffset;<br>        var nextNode = start.childNodes[ offset ]; // <body>​<h1></h1><p><br></p> body[2]=<p><br>        if (nextNode) {<br>          start.insertBefore(node, nextNode);<br>        } else {<br>          start.appendChild(node);<br>        } </p> <p>        return this.setStartBefore(first); // 第一个子节点插入之后,根据第一个子节点调整插入指针,第一个子节点此时还在p中,<br>                          range.startContainer = p<br>                          range.startOffset = 0 (node在p中的index) </p> <p>                        此时p变为<p>node<br></p> </p> <p>    nextNode = child.nextSibling; // child插入之后的nextsibling就是原来的占位节点br </p> <p>    if ( !hadBreak && child.nodeType == domUtils.NODE_ELEMENT && domUtils.isBlockElm( child ) ){ // 第一次循环插入<h1>子节点时hadBreak=0会执行一次 </p> <p>      parent = domUtils.findParent( child,function ( node ){ return domUtils.isBlockElm( node ); } ); // 递归向上找父节点,parent是p<br>      domUtils.breakParent( child, pre || tmp ); // 把p切开变为<p></p>node<p><br></p><br>      //去掉break后前一个多余的节点 <p>|</p> ==> <p></p><div></div><p>|</p><br>      var pre = child.previousSibling;<br>      domUtils.trimWhiteTextNode(pre);<br>      if(!pre.childNodes.length){ // 如果node前面的p是空的则删除,变为node<p><br></p><br>        domUtils.remove(pre);<br>      }<br>      next.appendChild(me.document.createElement('br')); // 在p添加一个br<br>      hadBreak = 1; // 切割元素问题只在第一次循环插入子节点时处理一次<br>    } </p> <p>    if(!div.firstChild && next && domUtils.isBlockElm(next)){ // 如果div变空,就是所有子节点都循环处理完了<br>      range.setStart(next,0).collapse(true); // 把start container设置为插入节点后面的next占位节点(应该是p),offset=0(p里面的第一个子节点),<br>      break;<br>    }<br>    range.setEndAfter( child ).collapse(); //关键在这,此时第一个子节点已经插入到<p>里面,<p>已经分裂成node<p><br></p>,因此node.parentNode=body,<br>container变为body,offset是node在body中的index=2。虽然是setendcontainer,但updatecollapse会更新startcontainer=endcontainer,所以实际上就是设置startcontainer=body,一旦第一个子节点插入成功,后续再插入时都是插入到之前插入的node的nextSibling节点p,offset是p在body里面的index,按offset找p节点,把node插入到p之前(insertBefore)。 </p> <p>}</p> <p>inserthtml命令的函数代码就是把template插入编辑器网页,处理流程逻辑非常复杂深奥,涉及到很细小的细节比如空白换行符处理以及很细微的浏览器兼容性问题。经过长时间细致debug看数据研究源代码,最后发现插入子节点的过程原理如下:</p> <p>假定回车换行,然后插入模板,把模板插入到当前行位置,这是最简单的情况,回车换行时编辑器会自动产生<p><br></p>。</p> <p>插入div的第一个子节点时是插入到<p>中,更准确地说是插入到p中的offset=0位置之前,也就是填充节点之前。</p> <p>插入之后,把<p>节点分裂成两个<p>如下所示:</p> <p></p>node<p><br></p> <p>然后把空的<p>节点也删除,就变成了node<p><br></p>,之后再插入其它子节点时,是插入到<body>中,offset位置是<p>节点在<body>中的index,也就是插入到body中<p>节点之前,每次插入一个node之后,node的nextSibling就是<p>节点占位元素。</p> <p> 这段代码是最复杂的插入程序,插入本来很简单,但编辑器插入非常复杂,因为可以在编辑器点击或选取任何位置区域做为插入位置,那么就复杂了,选取的区域是否要保留?是插入到选取区域的头部还是尾部?如果插入到一个元素的中间,那么元素要被分割成两个元素,而有些元素比如<a>元素是不能分割的。因此插入处理流程逻辑以及细节非常复杂,还涉及到#text不可见文本节点,我们在开发应用时一般不会涉及到这么细节这么复杂的问题。</p> <p>下面是insertHtml程序用到的几段函数代码:</p> <p>根据start container判断当前选区range内容是否占位符:<br>inFillChar : function(){<br>  var start = this.startContainer;<br>  if(this.collapsed && start.nodeType == 3<br>    && start.nodeValue.replace(new RegExp('^' + domUtils.fillChar),'').length + 1 == start.nodeValue.length<br>  //domUtils.fillChar是空格,这个表达式其实意思是找开头是否有空格,那么上述#text文本节点符合这个判断表达式<br>  ){<br>    return true;<br>  }<br>  return false;</p> <p>判断给定的节点是否是一个“填充”节点:<br>isFillChar:function (node,isInStart) {<br>  if(node.nodeType != 3)<br>    return false;<br>  var text = node.nodeValue;<br>  if(isInStart){<br>    return new RegExp('^' + domUtils.fillChar).test(text) // 以空格开头<br>  }<br>  return !text.replace(new RegExp(domUtils.fillChar,'g'), '').length // 在字符串找所有的空格去掉 </p> <p>对于上述#text文本节点, 其nodevalue是"",去掉空格之后长度为0,因此判断为填充节点,返回true。</p> <p>这两个方法都是根据nodetype=3和nodevalue含空格来判断,有何区别?一个是判断range,一个是判断node。</p> <p>如果占位元素是填充节点,就插入到填充节点之前,再删除填充节点,因为如果填充节点是<br>,会换行。</p> <p>将Range开始位置设置到node节点之前:<br>setStartBefore:function (node) {<br>  return this.setStart(node.parentNode, domUtils.getNodeIndex(node)); //返回修改之后的range<br>}, </p> <p>检测节点node在父节点中的索引位置:<br>getNodeIndex:function (node, ignoreTextNode) {<br>  var preNode = node,<br>  i = 0;<br>  while (preNode = preNode.previousSibling) {<br>    if (ignoreTextNode && preNode.nodeType == 3) {<br>      if(preNode.nodeType != preNode.nextSibling.nodeType ){<br>        i++;<br>      }<br>      continue;<br>    }<br>    i++;<br>  }<br>  return i;<br>  }, </p> <p>如果选中一段,再插入,又要保留选中的段,就比较复杂,可以插入到选中段的开头,也可以插入到选中段的尾部,也就是说选中的段可以在插入段的前面或后面。<br>编辑器range含start container和end container,就是选中的段的头尾节点。 </p> <p>collapse:function (toStart) {<br>  var me = this;<br>  if (toStart) { //插入到range的头部<br>    me.endContainer = me.startContainer;<br>    me.endOffset = me.startOffset;<br>  } else { //插入到range的尾部<br>    me.startContainer = me.endContainer;<br>    me.startOffset = me.endOffset;<br>  }<br>  me.collapsed = true;<br>  return me; </p> <p>设置Range的开始容器节点和偏移量<br>* @method setStart<br>* @remind 如果给定的节点是元素节点,那么offset指的是其子元素中索引为offset的元素,<br>* 如果是文本节点,那么offset指的是其文本内容的第offset个字符<br>* @remind 如果提供的容器节点是一个不能包含子元素的节点, 则该选区的开始容器将被设置<br>* 为该节点的父节点, 此时, 其距离开始容器的偏移量也变成了该节点在其父节点<br>* 中的索引<br>setStart:function (node, offset) { // node是p,offset是里面子节点的offset,0是第一个子节点,但也可能是node在父元素中的offset<br>  return setEndPoint(true, node, offset, this);<br>},</p> <p>function setEndPoint(toStart, node, offset, range) {<br>  //如果node是自闭合标签要处理<br>  if (node.nodeType == 1 && (dtd.$empty[node.tagName] || dtd.$nonChild[node.tagName])) {<br>    offset = domUtils.getNodeIndex(node) + (toStart ? 0 : 1);<br>    node = node.parentNode;<br>  }<br>  if (toStart) {<br>    range.startContainer = node;<br>    range.startOffset = offset;<br>    if (!range.endContainer) {<br>      range.collapse(true);<br>    }<br>  } else {<br>    range.endContainer = node;<br>    range.endOffset = offset;<br>    if (!range.startContainer) {<br>      range.collapse(false);<br>    }<br>  }<br>  updateCollapse(range);<br>  return range;</p> <p>下面研究点击对话框“确定”按钮之后是如何处理的?如何能执行dialog.onok?</p> <p>debug看dialog iframe网页代码中“确定”按钮代码是: </p> <div id="edui223\_body" unselectable="on" class="edui-button-body edui-default" onmousedown="return $EDITORUI\["edui223"\].\_onMouseDown(event, this);" onclick="return $EDITORUI\["edui223"\].\_onClick(event, this);"> <div class="edui-box edui-icon edui-default"></div> <div class="edui-box edui-label edui-default">确认</div> </div> <p>点击“确定”按钮是执行$EDITORUI["edui223"]._onClick(event, this),这段代码是如何产生的?</p> <p>dialog插件定义代码:<br>// ui/dialog.js<br>(function (){<br>  Dialog = baidu.editor.ui.Dialog = function (options){<br>    this.initOptions(utils.extend({<br>      onok: function (){},<br>      oncancel: function (){},<br>      onclose: function (t, ok){<br>      return ok ? this.onok() : this.oncancel();<br>    },<br>  },options));<br>  this.initDialog();<br>};<br>Dialog.prototype = {<br>  initDialog: function (){ </p> <p>  },<br>  _hide: function (){<br>    wrapNode.style.display = 'none';<br>  },<br>  open: function (){<br>    this.render();<br>    this.open();<br>  },<br>  close: function (ok){<br>    this._hide();<br>  } </p> <p>debug看工具按钮比如模板按钮是; </p> <div id="edui225\_body" unselectable="on" title="模板" class="edui-button-body edui-default" onmousedown="return $EDITORUI\["edui225"\].\_onMouseDown(event, this);" onclick="return $EDITORUI\["edui225"\].\_onClick(event, this);"> <div class="edui-box edui-icon edui-default"></div> <div class="edui-box edui-label edui-default"></div> </div> <p>按钮html代码是由button对象的代码构造出来的:<br>Button = baidu.editor.ui.Button = function (options){}<br>Button.prototype = {<br>  getHtmlTpl: function (){<br>    return '<div id="##" class="edui-box %%">' +<br>'<div id="##\_state" stateful>' +<br>'<div class="%%-wrap"><div id="##_body" unselectable="on" ' + (this.title ? 'title="' + this.title + '"' : '') +<br>' class="%%-body" onmousedown="return $$._onMouseDown(event, this);" onclick="return $$._onClick(event, this);">'</p> <p>加debug看$$就是$EDITORUI['edui225']。</p> <p>$EDITORUI['edui225']._onClick(event, this)代码是:<br>  _onClick: function (){<br>    if (!this.isDisabled()) {<br>      this.fireEvent('click');<br>      // ueditor自己的事件系统,对应editor.addListener,触发事件就是执行listener<br>      var EventBase = UE.EventBase = function () {};<br>        EventBase.prototype = {  // ueditor自己的逻辑事件系统<br>          addListener:function (types, listener) {</p> <p>            //把listener存储到listeners[]中<br>          },<br>          fireEvent:function () {  //  fireEvent就是到listeners[]中找listener执行<br>            t = listeners[k].apply(this, arguments);<br>            r = t.apply(this, arguments);<br>          }<br>    }<br>   },</p> <p>插件绑定了click事件;<br>UE.plugins['template'] = function () {<br>  this.addListener("click", function (type, evt) { //在template操作过程中并没有执行这个handler<br>    var el = evt.target || evt.srcElement,<br>    range = this.selection.getRange();<br>    var tnode = domUtils.findParent(el, function (node) {<br>    if (node.className && domUtils.hasClass(node, "ue_t")) {<br>      return node;<br>    }<br>  }, true);<br>  tnode && range.selectNode(tnode).shrinkBoundary().select();<br>});</p> <p>工具栏按钮点击事件绑定:<br>var btnCmds = ['undo', 'redo', 'formatmatch',<br>'bold', 'italic', 'underline', 'fontborder', 'touppercase', 'tolowercase',<br>'strikethrough', 'subscript', 'superscript', 'source', 'indent', 'outdent',<br>'blockquote', 'pasteplain', 'pagebreak',<br>'selectall', 'print','horizontal', 'removeformat', 'time', 'date', 'unlink',<br>'insertparagraphbeforetable', 'insertrow', 'insertcol', 'mergeright', 'mergedown', 'deleterow',<br>'deletecol', 'splittorows', 'splittocols', 'splittocells', 'mergecells', 'deletetable', 'drafts']; </p> <p>for (var i = 0, ci; ci = btnCmds[i++];) {<br>  editorui[ci] = function (cmd) {<br>    var ui = new editorui.Button({<br>      onclick:function () {<br>      editor.execCommand(cmd);<br>    },</p> <p>但“模板”按钮不在其中,有dialog的按钮是在这儿定义的:</p> <p>var dialogBtns = {<br>noOk:['searchreplace', 'help', 'spechars', 'webapp','preview'],<br>ok:['attachment', 'anchor', 'link', 'insertimage', 'map', 'gmap', 'insertframe', 'wordimage',<br>'insertvideo', 'insertframe', 'edittip', 'edittable', 'edittd', 'scrawl', 'template', 'music', 'background', 'charts']<br>};</p> <p>var ui = new editorui.Button({<br>  onclick:function () {<br>    if (dialog) {<br>      switch (cmd) {<br>        default:<br>          dialog.render(); </p> <p>UIBase.prototype = {<br>  render:function (holder) {<br>    holder.appendChild(el); //构造dialog el插入网页中占位元素(一个固定的浮动块)中<br>    this.postRender(); </p> <p>      postRender: function (){<br>        this.addListener('show', function (){<br>          me.modalMask.show(this.getDom().style.zIndex - 2);<br>        });<br>        this.buttons[i].postRender(); </p> <p>          postRender: function (){<br>            this.Stateful_postRender(); </p> <p>              Stateful_postRender: function (){<br>                if (this.disabled && !this.hasState('disabled')) {<br>                  this.addState('disabled'); </p> <p>                  this.setDisabled(this.disabled)<br>                },<br>              }<br>          }<br>        dialog.open(); </p> <p>          open: function (){<br>            this.showAtCenter(); // 执行这个方法显示会话弹窗 </p> <p>              showAtCenter: function (){<br>                //设置定位<br>                this._show(); </p> <p>                  _show: function (){<br>                    //dialog和编辑器两个平级浮动块要比z-index,要高过编辑器的zindxe<br>                    this.editor.container.style.zIndex && (this.getDom().style.zIndex = this.editor.container.style.zIndex * 1 + 10);<br>                    this.fireEvent('show');<br>                    baidu.editor.ui.uiUtils.getFixedLayer().style.zIndex = this.getDom().style.zIndex - 4;<br>                  }<br>                }<br>              }<br>            }<br>        }</p> <p>下面来分析一下编辑器初始化代码,因为在编辑器点击一下,然后点击模板按钮插入模板,是要插入到之前点击的位置,那么之前在编辑框内点击时编辑器如何获取位置或selection选取区域以及如何保存是个问题。</p> <p>_setup: function (doc) {<br>  me.selection = new dom.Selection(doc);<br>  this.selection.getNative()<br>  this._initEvents(); </p> <p>    _initEvents: function () {<br>      domUtils.on(doc, ['click', 'contextmenu', 'mousedown', 'keydown', 'keyup', 'keypress', 'mouseup', 'mouseover', 'mouseout', 'selectstart'], me._proxyDomEvent);<br>      domUtils.on(win, ['focus', 'blur'], me._proxyDomEvent); </p> <p>        _proxyDomEvent: function (evt) {<br>          this.fireEvent(evt.type.replace(/^on/, ''), evt)<br>        } </p> <p>      domUtils.on(doc, ['mouseup', 'keydown'], function (evt) {<br>        me._selectionChange(250, evt); </p> <p>          _selectionChange: function (delay, evt) {<br>            me.fireEvent('selectionchange', !!evt);<br>          }<br>      } </p> <p>  //编辑器不能为空内容  if (domUtils.isEmptyNode(me.body)) { <strong>me.body.innerHTML = '<p>' + (browser.ie ? '' : '<br/>') + '</p>';</strong></p> <p> <strong>}</strong>  //如果要求focus, 就把光标定位到内容开始<br>  if (options.focus) {<br>    setTimeout(function () {<br>      me.focus(me.options.focusInEnd);<br>      //如果自动清除开着,就不需要做selectionchange;<br>      !me.options.autoClearinitialContent && me._selectionChange();<br>    }, 0);<br>  }从初始化事件代码看,绑定物理事件清清楚楚,对于mouseup事件,是按selectionchange事件去找handler执行,这个selectionchange事件有几十个handler都要执行,因为源码中有几十个editor.addListener('selectionchange',handler)语句,<br>就不知道是哪个handler是处理range的,代码在哪里?要在89个函数中查找分析哪个函数是响应点击选取处理range的,难度很大,源代码非常复杂深奥高超。</p> <p>经过不懈的努力,还好所幸最后终于发现有一个处理mouseup物理事件的handler代码处理了range:</p> <p>UE.plugins['table'] = function () {<br>  me.ready(function () {<br>    me.addListener("mouseup", mouseUpEvent); </p> <p>      function mouseUpEvent(type, evt) { </p> <p>      range = new dom.Range(me.document);<br>      range.setStart(target, 0).setCursor(false, true); </p> <p>      me._selectionChange(250, evt);  //变化选区<br>        _selectionChange: function (delay, evt) { </p> <p>          me.selection.cache(); // 获取选区保存到cache </p> <p>            /**缓存当前选区的range和选区的开始节点<br>            cache:function () {<br>              this.clear(); // 先清除历史range再保留最近的range<br>              this._cachedRange = this.getRange(); </p> <p>                getRange:function () {<br>                  var sel = me.getNative();<br>                  //由于已经清除历史range,此刻cache是空的,无cache数据可用,则执行下面代码<br>                  if ( sel && sel.rangeCount ) { //根据sel数据设置range数据最后返回range数据<br>                    var firstRange = sel.getRangeAt( 0 );  var lastRange = sel.getRangeAt( sel.rangeCount - 1 );<br>                    range.setStart( firstRange.startContainer, firstRange.startOffset ).setEnd( lastRange.endContainer, lastRange.endOffset );<br>                    if ( range.collapsed && domUtils.isBody( range.startContainer ) && !range.startOffset ) {<br>                      optimze( range );<br>                    }<br>                    return this._bakRange = range;<br>                  }</p> <p>因此,在编辑框内点击或选取时,是执行mouseUpEvent处理range,获取和保存当前点击位置或选取的区域,之后再插入模板时要获取插入位置,就是从cache取这个保存的range数据,插入模板时不可能再调用getRange()获取点击位置或选取区域,因为点击工具按钮之后,之前在编辑框内的点击或选取的光标状态已经改变不存在了。</p> <p>下面看几个ueditor源码中的正则匹配表达式,学习一下正则:</p> <p>var re_tag = /<(?:(?:\/([^>]+)>)|(?:!--([\S|\s]*?)-->)|(?:([^\s\/<>]+)\s*((?:(?:"[^"]*")|(?:'[^']*')|[^"'<>])*)\/?>))/g,</p> <p>匹配以下html标签写法:<br></xxx> //比如</br> </p> <!--xxx--> <p><xxx "xxx" /><br><xxx 'xxx' /><br><xxx xxx /></p> <p>re_attr = /([\w\-:.]+)(?:(?:\s*=\s*(?:(?:"([^"]*)")|(?:'([^']*)')|([^\s>]+)))|(?=\s|$))/g;</p> <p>匹配以下html标签属性写法:<br>xxx:xxx-xxx.xxx = "xxx"<br>xxx = 'xxx'<br>xxx = xxx<br>xxx</p> <p>是不是晕?  ?:可以忽略,就好看一点了。</p> <p>源码中运用正则替换修改字符串的例子:</p> <p>htmlstr = htmlstr.replace(new RegExp('[\\r\\t\\n'+(ignoreBlank?'':' ')+']*<\/?(\\w+)\\s*(?:[^>]*)>[\\r\\t\\n'+(ignoreBlank?'':' ')+']*','g'), function(a,b){<br>以 \n <div >xxx</div > \n 为例,匹配到两次,第一次匹配 \n <div>,第二次匹配 </div> \n,调用function两次,a参数就是匹配的串,b参数是匹配的串里面的子匹配串<br>(\\w+)文字符串,就是div,replace方法里面如果写function,function返回的就是替换内容。</p> <p>return a.replace(new RegExp('^[\\r\\n'+(ignoreBlank?'':' ')+']+'),'').replace(new RegExp('[\\r\\n'+(ignoreBlank?'':' ')+']+$'),'');<br>按pattern找到串之后去掉头尾的换行符返回做为替换内容,结果就是把源字符串中标签头尾的换行符去掉,返回修改之后的字符串。</p> <p>本文到这里差不多就结束了,ueditor的工具按钮都以plugin插件方式定义,机制都一样,只是功能不同,本文不再一一分析,本文只以插入模板这个工具按钮为例进行了重点分析,其它插件应该都是类似的。</p> <p>通过源代码分析学习,本人感觉ueditor是学习网页元素处理的顶峰,而前端框架是学习用对象编程技术实现组件机制和语义化表达式解析的顶峰,webuploader则是学习模块化编程的典范,只不过模块化编程现在已经被放弃了被webpack取代了。</p> <p>本人水平有限,文中错误之处欢迎大家指正和交流。</p>

评论

暂无评论