From 0f49506bcf561bf63b0f122f84d0f6536806672e Mon Sep 17 00:00:00 2001 From: Jinqn <459452372@qq.com> Date: Wed, 21 Aug 2013 18:45:50 +0800 Subject: [PATCH 01/81] [fix]by Jinqn --- _src/core/EventBase.js | 102 +++++++++++++++++++++++++++++++---------- 1 file changed, 79 insertions(+), 23 deletions(-) diff --git a/_src/core/EventBase.js b/_src/core/EventBase.js index 35d3b1c74..5c0980cb0 100644 --- a/_src/core/EventBase.js +++ b/_src/core/EventBase.js @@ -1,19 +1,48 @@ /** + * UE采用的事件基类 * @file - * @name UE.EventBase - * @short EventBase - * @import editor.js,core/utils.js - * @desc UE采用的事件基类,继承此类的对应类将获取addListener,removeListener,fireEvent方法。 + * @module UE + * @class EventBase + * @since 1.2.6.1 + */ + +/** + * UEditor公用空间,UEditor所有的功能都挂载在该空间下 + * @unfile + * @module UE + */ + +/** + * UE采用的事件基类,继承此类的对应类将获取addListener,removeListener,fireEvent方法。 * 在UE中,Editor以及所有ui实例都继承了该类,故可以在对应的ui对象以及editor对象上使用上述方法。 + * @unfile + * @module UE + * @class EventBase */ -var EventBase = UE.EventBase = function () {}; + +/** + * 通过此构造器,子类可以继承EventBase获取事件监听的方法 + * @constructor + * @example + * ```javascript + * UE.EventBase.call(editor); + * ``` + */ + +var EventBase = UE.EventBase = function () { +}; EventBase.prototype = { + + /** * 注册事件监听器 - * @name addListener - * @grammar editor.addListener(types,fn) //types为事件名称,多个可用空格分隔 + * @method addListener + * @param { String } types 监听的事件名称,同时监听多个事件使用空格分隔 + * @param { Function } fn 监听的事件被触发时,会执行该回调函数 + * @waining 事件被触发时,监听的函数假如返回的值恒等于true,回调函数的队列中后面的函数将不执行 * @example + * ```javascript * editor.addListener('selectionchange',function(){ * console.log("选区已经变化!"); * }) @@ -25,35 +54,59 @@ EventBase.prototype = { * } * console.log(this.getContent) // this是注册的事件的编辑器实例 * }) + * ``` + * @see UE.EventBase:fireEvent(String) */ - addListener:function (types, listener) { + addListener: function (types, listener) { types = utils.trim(types).split(' '); for (var i = 0, ti; ti = types[i++];) { getListener(this, ti, true).push(listener); } }, + + /** * 移除事件监听器 - * @name removeListener - * @grammar editor.removeListener(types,fn) //types为事件名称,多个可用空格分隔 + * @method removeListener + * @param { String } types 移除的事件名称,同时移除多个事件使用空格分隔 + * @param { Function } fn 移除监听事件的函数引用 * @example + * ```javascript * //changeCallback为方法体 * editor.removeListener("selectionchange",changeCallback); + * ``` */ - removeListener:function (types, listener) { + removeListener: function (types, listener) { types = utils.trim(types).split(' '); for (var i = 0, ti; ti = types[i++];) { utils.removeItem(getListener(this, ti) || [], listener); } }, + + + /** + * 触发事件 + * @method fireEvent + * @param { String } types 触发的事件名称,同时触发多个事件使用空格分隔 + * @remind 该方法会触发addListener + * @return { * } 返回触发事件的队列中,最后执行的回调函数的返回值 + * @example + * ```javascript + * editor.fireEvent("selectionchange"); + * ``` + */ + /** * 触发事件 - * @name fireEvent - * @grammar editor.fireEvent(types) //types为事件名称,多个可用空格分隔 + * @method fireEvent + * @param { String } types 触发的事件名称,同时触发多个事件使用空格分隔 + * @param { *... } options 第二项开始的参数会传给触发的回调函数 * @example + * ```javascript * editor.fireEvent("selectionchange"); + * ``` */ - fireEvent:function () { + fireEvent: function () { var types = arguments[0]; types = utils.trim(types).split(' '); for (var i = 0, ti; ti = types[i++];) { @@ -62,9 +115,9 @@ EventBase.prototype = { if (listeners) { k = listeners.length; while (k--) { - if(!listeners[k])continue; + if (!listeners[k])continue; t = listeners[k].apply(this, arguments); - if(t === true){ + if (t === true) { return t; } if (t !== undefined) { @@ -79,19 +132,22 @@ EventBase.prototype = { return r; } }; + /** * 获得对象所拥有监听类型的所有监听器 + * @unfile + * @module UE + * @since 1.2.6.1 + * @method getListener * @public - * @function - * @param {Object} obj 查询监听器的对象 - * @param {String} type 事件类型 - * @param {Boolean} force 为true且当前所有type类型的侦听器不存在时,创建一个空监听器数组 - * @returns {Array} 监听器数组 + * @param { Object } obj 查询监听器的对象 + * @param { String } type 事件类型 + * @param { Boolean } force 为true且当前所有type类型的侦听器不存在时,创建一个空监听器数组 + * @return { Array } 监听器数组 */ function getListener(obj, type, force) { var allListeners; type = type.toLowerCase(); return ( ( allListeners = ( obj.__allListeners || force && ( obj.__allListeners = {} ) ) ) && ( allListeners[type] || force && ( allListeners[type] = [] ) ) ); -} - +} \ No newline at end of file From ea125ec7dc82db4b4fc1c1af1046c3fa3a9f8dab Mon Sep 17 00:00:00 2001 From: Jinqn <459452372@qq.com> Date: Thu, 22 Aug 2013 13:28:05 +0800 Subject: [PATCH 02/81] [fix]by Jinqn --- _src/core/Editor.js | 740 +++++++++++++++++++++++++++++++++----------- 1 file changed, 562 insertions(+), 178 deletions(-) diff --git a/_src/core/Editor.js b/_src/core/Editor.js index 2cc367d7e..f4f477e3f 100644 --- a/_src/core/Editor.js +++ b/_src/core/Editor.js @@ -1,18 +1,33 @@ /** + * 编辑器主类,包含编辑器提供的大部分公用接口 * @file - * @name UE.Editor - * @short Editor - * @import editor.js,core/utils.js,core/EventBase.js,core/browser.js,core/dom/dtd.js,core/dom/domUtils.js,core/dom/Range.js,core/dom/Selection.js,plugins/serialize.js - * @desc 编辑器主类,包含编辑器提供的大部分公用接口 + * @module UE + * @class Editor + * @since 1.2.6.1 */ + +/** + * UEditor公用空间,UEditor所有的功能都挂载在该空间下 + * @unfile + * @module UE + */ + +/** + * UEditor的核心类,为用户提供与编辑器交互的接口。 + * @unfile + * @module UE + * @class Editor + */ + (function () { var uid = 0, _selectionChangeTimer; + /** + * 获取编辑器的html内容,赋值到编辑器所在表单的textarea文本域里面 * @private - * @ignore - * @param form 编辑器所在的form元素 - * @param editor 编辑器实例对象 + * @method setValue + * @param { Editor } editor 编辑器事例 */ function setValue(form, editor) { var textarea; @@ -41,7 +56,14 @@ (editor.options.allHtmlEnabled ? editor.getAllHtml() : editor.getContent(null, null, true)) : '' } - function loadPlugins(me){ + + /** + * 初始化插件 + * @private + * @method loadPlugins + * @param { Editor } editor 编辑器事例 + */ + function loadPlugins(me) { //初始化插件 for (var pi in UE.plugins) { UE.plugins[pi].call(me); @@ -50,21 +72,67 @@ me.fireEvent("langReady"); } - function checkCurLang(I18N){ - for(var lang in I18N){ + + /** + * 获取语言包里面的第一个 + * @private + * @method checkCurLang + * @param { PlainObject } I18N 编辑器事例 + */ + function checkCurLang(I18N) { + for (var lang in I18N) { return lang } } + + + /** + * 编辑器准备就绪后会触发该事件 + * @module UE + * @class Editor + * @event ready + * @example + * ```javascript + * editor.addListener( 'ready', function( editor ) { + * editor.execCommand( 'focus' ); + * } ); + * ``` + */ + /** - * UEditor编辑器类 - * @name Editor - * @desc 创建一个跟编辑器实例 - * - ***container*** 编辑器容器对象 - * - ***iframe*** 编辑区域所在的iframe对象 - * - ***window*** 编辑区域所在的window - * - ***document*** 编辑区域所在的document对象 - * - ***body*** 编辑区域所在的body对象 - * - ***selection*** 编辑区域的选区对象 + * 每当编辑器内部选区发生改变后, 将触发该事件 + * @event selectionchange + * @warning 该事件的触发非常频繁,不建议在该事件的处理过程中做重量级的处理 + * @example + * ```javascript + * editor.addListener( 'selectionchange', function( editor ) { + * + * editor.execCommand( 'bold' ); + * + * } + */ + + /** + * 以默认参数构建一个编辑器实例 + * @constructor + * @example + * ```javascript + * var editor = new UE.Editor(); + * editor.execCommand('blod'); + * ``` + * @see UE.Config + */ + + /** + * 以给定的参数集合创建一个编辑器对象,对于未指定的参数,将应用默认参数。 + * @constructor + * @param { PlainObject } setting 创建编辑器的参数 + * @example + * ```javascript + * var editor = new UE.Editor(); + * editor.execCommand('blod'); + * ``` + * @see UE.Config */ var Editor = UE.Editor = function (options) { var me = this; @@ -79,7 +147,7 @@ me.setOpt({ isShow: true, initialContent: '', - initialStyle:'', + initialStyle: '', autoClearinitialContent: false, iframeCssUrl: me.options.UEDITOR_HOME_URL + 'themes/iframe.css', textarea: 'editorValue', @@ -99,14 +167,14 @@ allHtmlEnabled: false, scaleEnabled: false, tableNativeEditInFF: false, - autoSyncData : true + autoSyncData: true }); - if(!utils.isEmptyObject(UE.I18N)){ + if (!utils.isEmptyObject(UE.I18N)) { //修改默认的语言类型 me.options.lang = checkCurLang(UE.I18N); loadPlugins(me) - }else{ + } else { utils.loadFile(document, { src: me.options.langPath + me.options.lang + "/" + me.options.lang + ".js", tag: "script", @@ -120,17 +188,22 @@ UE.instants['ueditorInstant' + me.uid] = me; }; Editor.prototype = { + + /** - * 当编辑器ready后执行传入的fn,如果编辑器已经完成ready,就马上执行fn,fn的中的this是编辑器实例。 - * 大部分的实例接口都需要放在该方法内部执行,否则在IE下可能会报错。 - * @name ready - * @grammar editor.ready(fn) fn是当编辑器渲染好后执行的function + * 编辑器对外提供的监听ready事件的接口, 通过调用该方法,达到的效果与监听ready事件是一致的 + * @method ready + * @param { Function } fn 编辑器ready之后所执行的回调, 如果在注册事件之前编辑器已经ready,将会 + * 立即触发该回调。 + * @see UE.Editor.event:ready * @example - * var editor = new UE.ui.Editor(); - * editor.render("myEditor"); - * editor.ready(function(){ - * editor.setContent("欢迎使用UEditor!"); - * }) + * ```javascript + * editor.ready( function( editor ) { + * + * editor.setContent('初始化完毕'); + * + * } ); + * ``` */ ready: function (fn) { var me = this; @@ -138,10 +211,31 @@ me.isReady ? fn.apply(me) : me.addListener('ready', fn); } }, + + + /** + * 以attributeName - attributeValue的方式设置编辑器的配置项,以覆盖编辑器的默认选项值 + * @method setOpt + * @warning 该方法仅供编辑器构造函数调用,其他任何方法不能调用。 + * @param { String } key 编辑器的可接受的选项名称 + * @param { * } val 该选项可接受的值 + * @example + * ```javascript + * editor.setOpt( 'initContent', '欢迎使用编辑器' ); + * ``` + */ + /** - * 为编辑器设置默认参数值。若用户配置为空,则以默认配置为准 - * @grammar editor.setOpt(key,value); //传入一个键、值对 - * @grammar editor.setOpt({ key:value}); //传入一个json对象 + * 以key-value集合的方式设置编辑器的配置项,以覆盖编辑器的默认选项值 + * @method setOpt + * @warning 该方法仅供编辑器构造函数调用,其他任何方法不能调用。 + * @param { PlainObject } settings 编辑器的可接受的选项的key-value集合 + * @example + * ```javascript + * editor.setOpt( { + * 'initContent': '欢迎使用编辑器' + * } ); + * ``` */ setOpt: function (key, val) { var obj = {}; @@ -152,10 +246,15 @@ } utils.extend(this.options, obj, true); }, + + /** * 销毁编辑器实例对象 - * @name destroy - * @grammar editor.destroy(); + * @method destroy + * @example + * ```javascript + * editor.destroy(); + * ``` */ destroy: function () { @@ -185,83 +284,92 @@ } UE.delEditor(key); }, + /** - * 渲染编辑器的DOM到指定容器,必须且只能调用一次 - * @name render - * @grammar editor.render(containerId); //可以指定一个容器ID - * @grammar editor.render(containerDom); //也可以直接指定容器对象 + * 渲染编辑器的DOM到指定容器 + * @method render + * @param { String } containerId 指定一个容器ID + * @warning 必须且只能调用一次 + */ + + /** + * 渲染编辑器的DOM到指定容器 + * @method render + * @param { Element } containerDom 直接指定容器对象 + * @warning 必须且只能调用一次 */ render: function (container) { var me = this, options = me.options, - getStyleValue=function(attr){ - return parseInt(domUtils.getComputedStyle(container,attr)); + getStyleValue = function (attr) { + return parseInt(domUtils.getComputedStyle(container, attr)); }; if (utils.isString(container)) { container = document.getElementById(container); } if (container) { - if(options.initialFrameWidth){ + if (options.initialFrameWidth) { options.minFrameWidth = options.initialFrameWidth - }else{ + } else { options.minFrameWidth = options.initialFrameWidth = container.offsetWidth; } - if(options.initialFrameHeight){ + if (options.initialFrameHeight) { options.minFrameHeight = options.initialFrameHeight - }else{ + } else { options.initialFrameHeight = options.minFrameHeight = container.offsetHeight; } - container.style.width = /%$/.test(options.initialFrameWidth) ? '100%' : options.initialFrameWidth- - getStyleValue("padding-left")- getStyleValue("padding-right") +'px'; - container.style.height = /%$/.test(options.initialFrameHeight) ? '100%' : options.initialFrameHeight - - getStyleValue("padding-top")- getStyleValue("padding-bottom") +'px'; + container.style.width = /%$/.test(options.initialFrameWidth) ? '100%' : options.initialFrameWidth - + getStyleValue("padding-left") - getStyleValue("padding-right") + 'px'; + container.style.height = /%$/.test(options.initialFrameHeight) ? '100%' : options.initialFrameHeight - + getStyleValue("padding-top") - getStyleValue("padding-bottom") + 'px'; container.style.zIndex = options.zIndex; - var html = ( ie && browser.version < 9 ? '' : '') + - '' + - '' + - ( options.iframeCssUrl ? '' : '' ) + - (options.initialStyle ? '' : '') + - '' + - ''; + var html = ( ie && browser.version < 9 ? '' : '') + + '' + + '' + + ( options.iframeCssUrl ? '' : '' ) + + (options.initialStyle ? '' : '') + + '' + + ''; container.appendChild(domUtils.createElement(document, 'iframe', { id: 'ueditor_' + me.uid, width: "100%", height: "100%", frameborder: "0", - src: 'javascript:void(function(){document.open();' + (options.customDomain && document.domain != location.hostname ? 'document.domain="' + document.domain + '";' : '') + + src: 'javascript:void(function(){document.open();' + (options.customDomain && document.domain != location.hostname ? 'document.domain="' + document.domain + '";' : '') + 'document.write("' + html + '");document.close();}())' })); container.style.overflow = 'hidden'; //解决如果是给定的百分比,会导致高度算不对的问题 - setTimeout(function(){ - if( /%$/.test(options.initialFrameWidth)){ + setTimeout(function () { + if (/%$/.test(options.initialFrameWidth)) { options.minFrameWidth = options.initialFrameWidth = container.offsetWidth; container.style.width = options.initialFrameWidth + 'px'; } - if(/%$/.test(options.initialFrameHeight)){ + if (/%$/.test(options.initialFrameHeight)) { options.minFrameHeight = options.initialFrameHeight = container.offsetHeight; container.style.height = options.initialFrameHeight + 'px'; } }) } }, + /** * 编辑器初始化 + * @method _setup * @private - * @ignore - * @param {Element} doc 编辑器Iframe中的文档对象 + * @param { Element } doc 编辑器Iframe中的文档对象 */ _setup: function (doc) { @@ -291,11 +399,11 @@ for (var form = this.iframe.parentNode; !domUtils.isBody(form); form = form.parentNode) { if (form.tagName == 'FORM') { me.form = form; - if(me.options.autoSyncData){ - domUtils.on(me.window,'blur',function(){ - setValue(form,me); + if (me.options.autoSyncData) { + domUtils.on(me.window, 'blur', function () { + setValue(form, me); }); - }else{ + } else { domUtils.on(form, 'submit', function () { setValue(this, me); }); @@ -388,17 +496,25 @@ !options.isShow && me.setHide(); options.readonly && me.setDisabled(); }, + /** - * 同步编辑器的数据,为提交数据做准备,主要用于你是手动提交的情况 - * @name sync - * @grammar editor.sync(); //从编辑器的容器向上查找,如果找到就同步数据 - * @grammar editor.sync(formID); //formID制定一个要同步数据的form的id,编辑器的数据会同步到你指定form下 - * @desc - * 后台取得数据得键值使用你容器上得''name''属性,如果没有就使用参数传入的''textarea'' + * 同步编辑器的数据,为提交数据做准备,主要用于是手动提交的情况 + * 后台取得数据的键值使用你容器上的name属性,如果没有就使用参数传入的textarea属性 + * 获取要同步的表单,从编辑器的容器向上查找要同步数据的form,如果找到就同步数据 + * @method sync * @example + * ```javascript * editor.sync(); * form.sumbit(); //form变量已经指向了form元素 - * + * ``` + */ + + /** + * 同步编辑器的数据,为提交数据做准备,主要用于是手动提交的情况 + * 后台取得数据的键值使用你容器上的name属性,如果没有就使用参数传入的textarea属性 + * 根据传入表单id参数,获取要同步数据的form + * @method sync + * @param { String } formID 指定一个要同步数据的form的id,编辑器的数据会同步到你指定form下 */ sync: function (formId) { var me = this, @@ -408,12 +524,17 @@ }, true); form && setValue(form, me); }, + /** * 设置编辑器高度 - * @name setHeight - * @grammar editor.setHeight(number); //纯数值,不带单位 + * @method setHeight + * @param { Number } number 设置的高度值,纯数值,不带单位 + * @example + * ```javascript + * editor.setHeight(number); + * ``` */ - setHeight: function (height,notSetHeight) { + setHeight: function (height, notSetHeight) { if (height !== parseInt(this.iframe.parentNode.style.height)) { this.iframe.parentNode.style.height = height + 'px'; } @@ -422,6 +543,28 @@ this.body.style.height = height + 'px'; }, + /** + * 添加命令的快捷键 + * @method addshortcutkey + * @param { PlainObject } keyset 命令和快捷键的键值对对象,多个按钮的快捷键用“+”分隔 + * @example + * ```javascript + * editor.addshortcutkey({ + * "Bold" : "ctrl+66",//^B + * "Italic" : "ctrl+73", //^I + * }); + * ``` + */ + /** + * 添加命令的快捷键 + * @method addshortcutkey + * @param { String } cmd 触发快捷键时,响应的命令 + * @param { String } keys 快捷键的字符串,多个按钮用“+”分隔 + * @example + * ```javascript + * editor.addshortcutkey("Underline", "ctrl+85"); //^U + * ``` + */ addshortcutkey: function (cmd, keys) { var obj = {}; if (keys) { @@ -431,6 +574,12 @@ } utils.extend(this.shortcutkeys, obj) }, + + /** + * 对编辑器设置keydown事件监听,绑定快捷键和命令,当快捷键组合触发成功,会响应对应的命令 + * @method _bindshortcutKeys + * @private + */ _bindshortcutKeys: function () { var me = this, shortcutkeys = this.shortcutkeys; me.addListener('keydown', function (type, e) { @@ -447,7 +596,7 @@ ) || keyCode == RegExp.$1 ) { - if (me.queryCommandState(i,param) != -1) + if (me.queryCommandState(i, param) != -1) me.execCommand(i, param); domUtils.preventDefault(e); } @@ -457,19 +606,38 @@ } }); }, + + + /** + * 获取编辑器的内容 + * @method getContent + * @warning 该方法获取到的是经过编辑器内置的过滤规则进行过滤后得到的内容 + * @return { String } 编辑器的内容字符串, 如果编辑器的内容为空, 则返回空字符串 + * @example + * ```javascript + * var content = editor.getContent(); + * ``` + */ + /** - * 获取编辑器内容 - * @name getContent - * @grammar editor.getContent() => String //若编辑器中只包含字符"<p><br /></p/>"会返回空。 - * @grammar editor.getContent(fn) => String + * 获取编辑器的内容。 可以通过参数定义编辑器内置的判空规则 + * @method getContent + * @param { Function } fn 自定的判空规则, 要求该方法返回一个boolean类型的值, + * 代表当前编辑器的内容是否空, + * 如果返回true, 则该方法将直接返回空字符串;如果返回false,则编辑器将返回 + * 经过内置过滤规则处理后的内容。 + * @remind 该方法在处理包含有初始化内容的时候能起到很好的作用。 + * @warning 该方法获取到的是经过编辑器内置的过滤规则进行过滤后得到的内容 + * @return { String } 编辑器的内容字符串 * @example - * getContent默认是会现调用hasContents来判断编辑器是否为空,如果是,就直接返回空字符串 - * 你也可以传入一个fn来接替hasContents的工作,定制判断的规则 - * editor.getContent(function(){ - * return false //编辑器没有内容 ,getContent直接返回空 - * }) + * ```javascript + * // editor 是一个编辑器的实例 + * var content = editor.getContent( function ( editor ) { + * return editor.body.innerHTML === '欢迎使用UEditor'; + * } ); + * ``` */ - getContent: function (cmd, fn,notSetCursor,ignoreBlank,formatter) { + getContent: function (cmd, fn, notSetCursor, ignoreBlank, formatter) { var me = this; if (cmd && utils.isFunction(cmd)) { fn = cmd; @@ -479,15 +647,20 @@ return ''; } me.fireEvent('beforegetcontent'); - var root = UE.htmlparser(me.body.innerHTML,ignoreBlank); + var root = UE.htmlparser(me.body.innerHTML, ignoreBlank); me.filterOutputRule(root); me.fireEvent('aftergetcontent', cmd); return root.toHtml(formatter); }, + /** * 取得完整的html代码,可以直接显示成完整的html文档 - * @name getAllHtml - * @grammar editor.getAllHtml() => String + * @method getAllHtml + * @return { String } 编辑器的内容html文档字符串 + * @eaxmple + * ```javascript + * editor.getAllHtml(); + * ``` */ getAllHtml: function () { var me = this, @@ -508,10 +681,15 @@ + (headHtmlForIE9 || me.document.getElementsByTagName('head')[0].innerHTML) + headHtml.join('\n') + '' + '' + me.getContent(null, null, true) + ''; }, + /** * 得到编辑器的纯文本内容,但会保留段落格式 - * @name getPlainTxt - * @grammar editor.getPlainTxt() => String + * @method getPlainTxt + * @return { String } 编辑器带段落格式的纯文本内容字符串 + * @example + * ```javascript + * editor.getPlainTxt(); + * ``` */ getPlainTxt: function () { var reg = new RegExp(domUtils.fillChar, 'g'), @@ -528,8 +706,12 @@ /** * 获取编辑器中的纯文本内容,没有段落格式 - * @name getContentTxt - * @grammar editor.getContentTxt() => String + * @method getContentTxt + * @return { String } 编辑器不带段落格式的纯文本内容字符串 + * @example + * ```javascript + * editor.getContentTxt(); + * ``` */ getContentTxt: function () { var reg = new RegExp(domUtils.fillChar, 'g'); @@ -538,15 +720,35 @@ }, /** - * 将html设置到编辑器中, 如果是用于初始化时给编辑器赋初值,则必须放在ready方法内部执行 - * @name setContent - * @grammar editor.setContent(html) + * 获取编辑器的内容 + * @method getContent + * @warning 该方法获取到的是经过编辑器内置的过滤规则进行过滤后得到的内容 + * @return { String } 编辑器的内容字符串, 如果编辑器的内容为空, 则返回空字符串 + * @example + * ```javascript + * var content = editor.getContent(); + * ``` + */ + + /** + * 获取编辑器的内容。 可以通过参数定义编辑器内置的判空规则 + * @method getContent + * @param { Function } fn 自定的判空规则, 要求该方法返回一个boolean类型的值, + * 代表当前编辑器的内容是否空, + * 如果返回true, 则该方法将直接返回空字符串;如果返回false,则编辑器将返回 + * 经过内置过滤规则处理后的内容。 + * @remind 该方法在处理包含有初始化内容的时候能起到很好的作用。 + * @warning 该方法获取到的是经过编辑器内置的过滤规则进行过滤后得到的内容 + * @return { String } 编辑器的内容字符串 * @example - * var editor = new UE.ui.Editor() - * editor.ready(function(){ - * //需要ready后执行,否则可能报错 - * editor.setContent("欢迎使用UEditor!"); - * }) + * ```javascript + * // editor 是一个编辑器的实例 + * var content = editor.getContent( function ( editor ) { + * + * return editor.body.innerHTML === '欢迎使用UEditor'; + * + * } ); + * ``` */ setContent: function (html, isAppendTo, notFireSelectionchange) { var me = this; @@ -560,9 +762,10 @@ me.body.innerHTML = (isAppendTo ? me.body.innerHTML : '') + html; - function isCdataDiv(node){ + function isCdataDiv(node) { return node.tagName == 'DIV' && node.getAttribute('cdata_tag'); } + //给文本或者inline节点套p标签 if (me.options.enterTag == 'p') { @@ -606,15 +809,28 @@ if (browser.gecko && (geckoSel = this.selection.getNative())) { geckoSel.removeAllRanges(); } - if(me.options.autoSyncData){ - me.form && setValue(me.form,me); + if (me.options.autoSyncData) { + me.form && setValue(me.form, me); } }, + /** + * 让编辑器获得焦点,默认focus到编辑器头部 + * @method focus + * @example + * ```javascript + * editor.focus() + * ``` + */ + /** * 让编辑器获得焦点,toEnd确定focus位置 - * @name focus - * @grammar editor.focus([toEnd]) //默认focus到编辑器头部,toEnd为true时focus到内容尾部 + * @method focus + * @param { Boolean } toEnd 默认focus到编辑器头部,toEnd为true时focus到内容尾部 + * @example + * ```javascript + * editor.focus(true) + * ``` */ focus: function (toEnd) { try { @@ -632,8 +848,8 @@ /** * 初始化UE事件及部分事件代理 + * @method _initEvents * @private - * @ignore */ _initEvents: function () { var me = this, @@ -692,18 +908,21 @@ // } // }()); }, + /** * 触发事件代理 + * @method _proxyDomEvent * @private - * @ignore + * @return { * } fireEvent的返回值 + * @see UE.EventBase:fireEvent(String) */ _proxyDomEvent: function (evt) { return this.fireEvent(evt.type.replace(/^on/, ''), evt); }, /** * 变化选区 + * @method _selectionChange * @private - * @ignore */ _selectionChange: function (delay, evt) { var me = this; @@ -759,6 +978,15 @@ } }, delay || 50); }, + + /** + * 执行编辑命令 + * @method _callCmdFn + * @private + * @param { String } fnName 函数名称 + * @param { * } args 传给命令函数的参数 + * @return { * } 返回命令函数运行的返回值 + */ _callCmdFn: function (fnName, args) { var cmdName = args[0].toLowerCase(), cmd, cmdFn; @@ -774,8 +1002,12 @@ /** * 执行编辑命令cmdName,完成富文本编辑效果 - * @name execCommand - * @grammar editor.execCommand(cmdName) => {*} + * @method execCommand + * @return { * } 返回命令函数运行的返回值 + * @example + * ```javascript + * editor.execCommand(cmdName); + * ``` */ execCommand: function (cmdName) { cmdName = cmdName.toLowerCase(); @@ -787,7 +1019,7 @@ } if (!cmd.notNeedUndo && !me.__hasEnterExecCommand) { me.__hasEnterExecCommand = true; - if (me.queryCommandState.apply(me,arguments) != -1) { + if (me.queryCommandState.apply(me, arguments) != -1) { me.fireEvent('beforeexeccommand', cmdName); result = this._callCmdFn('execCommand', arguments); !me._ignoreContentChange && me.fireEvent('contentchange'); @@ -801,14 +1033,18 @@ !me._ignoreContentChange && me._selectionChange(); return result; }, + /** * 根据传入的command命令,查选编辑器当前的选区,返回命令的状态 - * @name queryCommandState - * @grammar editor.queryCommandState(cmdName) => (-1|0|1) - * @desc - * * ''-1'' 当前命令不可用 - * * ''0'' 当前命令可用 - * * ''1'' 当前命令已经执行过了 + * @method queryCommandState + * @return { Number } number 返回放前命令的状态 + * 返回 -1 当前命令不可用 + * 返回 0 当前命令可用 + * 返回 1 当前命令已经执行过了 + * @example + * ```javascript + * editor.queryCommandState(cmdName) => (-1|0|1) + * ``` */ queryCommandState: function (cmdName) { return this._callCmdFn('queryCommandState', arguments); @@ -816,22 +1052,35 @@ /** * 根据传入的command命令,查选编辑器当前的选区,根据命令返回相关的值 - * @name queryCommandValue + * @method queryCommandValue + * @remind 只有部分插件有此方法 + * @return { * } 返回每个命令特定的当前状态值 * @grammar editor.queryCommandValue(cmdName) => {*} */ queryCommandValue: function (cmdName) { return this._callCmdFn('queryCommandValue', arguments); }, + /** - * 检查编辑区域中是否有内容,若包含tags中的节点类型,直接返回true - * @name hasContents - * @desc - * 默认有文本内容,或者有以下节点都不认为是空 + * 检查编辑区域中是否有内容 + * @method hasContents + * @remind 默认有文本内容,或者有以下节点都不认为是空 * {table:1,ul:1,ol:1,dl:1,iframe:1,area:1,base:1,col:1,hr:1,img:1,embed:1,input:1,link:1,meta:1,param:1} - * @grammar editor.hasContents() => (true|false) - * @grammar editor.hasContents(tags) => (true|false) //若文档中包含tags数组里对应的tag,直接返回true + * @return { Boolean } 检查有内容返回true,否则返回false + * @example + * ```javascript + * editor.hasContents() + * ``` + */ + + /** + * 检查编辑区域中是否有内容,若包含参数tags中的节点类型,直接返回true + * @method hasContents + * @return { Boolean } 若文档中包含tags数组里对应的tag,返回true,否则返回false * @example - * editor.hasContents(['span']) //如果编辑器里有这些,不认为是空 + * ```javascript + * editor.hasContents(['span']); + * ``` */ hasContents: function (tags) { if (tags) { @@ -856,17 +1105,28 @@ } return false; }, + /** * 重置编辑器,可用来做多个tab使用同一个编辑器实例 - * @name reset - * @desc - * * 清空编辑器内容 - * * 清空回退列表 - * @grammar editor.reset() + * @method reset + * @remind 此方法会清空编辑器内容,清空回退列表 + * @example + * ```javascript + * editor.reset() + * ``` */ reset: function () { this.fireEvent('reset'); }, + + /** + * 设置当前编辑区域可以编辑 + * @method setEnabled + * @example + * ```javascript + * editor.setEnabled() + * ``` + */ setEnabled: function () { var me = this, range; if (me.body.contentEditable == 'false') { @@ -887,14 +1147,44 @@ me.fireEvent('selectionchange'); } }, + /** * 设置当前编辑区域可以编辑 - * @name enable - * @grammar editor.enable() + * @method enable + * @return { * } 返回setEnabled方法的返回值 + * @example + * ```javascript + * editor.enable() + * ``` + * @see UE.Editor:setEnabled() */ enable: function () { return this.setEnabled(); }, + + /** 设置当前编辑区域不可编辑 + * @method setDisabled + */ + + /** 设置当前编辑区域不可编辑,except中的命令除外 + * @method setDisabled + * @param { String } except 例外命令的字符串 + * @remind 即使设置了disable,此处配置的例外命令仍然可以执行 + * @example + * ```javascript + * editor.setDisabled('bold'); //禁用工具栏中除加粗之外的所有功能 + * ``` + */ + + /** 设置当前编辑区域不可编辑,except中的命令除外 + * @method setDisabled + * @param { Array } except 字符串数组,数组中的命令仍然可以执行 + * @remind 即使设置了disable,此处配置的例外命令仍然可以执行 + * @example + * ```javascript + * editor.setDisabled(['bold','insertimage']); //禁用工具栏中除加粗和插入图片之外的所有功能 + * ``` + */ setDisabled: function (except) { var me = this; except = except ? utils.isArray(except) ? except : [except] : []; @@ -913,22 +1203,42 @@ me.fireEvent('selectionchange'); } }, + + /** 设置当前编辑区域不可编辑 + * @method disable + * @see UE.Editor:setEnabled() + */ + /** 设置当前编辑区域不可编辑,except中的命令除外 - * @name disable - * @grammar editor.disable() - * @grammar editor.disable(except) //例外的命令,也即即使设置了disable,此处配置的命令仍然可以执行 + * @method disable + * @param { String } except 例外命令的字符串 + * @remind 即使设置了disable,此处配置的例外命令仍然可以执行 * @example - * //禁用工具栏中除加粗和插入图片之外的所有功能 - * editor.disable(['bold','insertimage']);//可以是单一的String,也可以是Array + * ```javascript + * editor.disable('bold'); //禁用工具栏中除加粗之外的所有功能 + * ``` + * @see UE.Editor:setEnabled(String) + */ + + /** 设置当前编辑区域不可编辑,except中的命令除外 + * @method disable + * @param { Array } except 字符串数组,数组中的命令仍然可以执行 + * @remind 即使设置了disable,此处配置的例外命令仍然可以执行 + * @example + * ```javascript + * editor.disable(['bold','insertimage']); //禁用工具栏中除加粗和插入图片之外的所有功能 + * ``` + * @see UE.Editor:setEnabled(Array) */ disable: function (except) { return this.setDisabled(except); }, + /** * 设置默认内容 - * @ignore + * @method _setDefaultContent * @private - * @param {String} cont 要存入的内容 + * @param { String } cont 要存入的内容 */ _setDefaultContent: function () { function clear() { @@ -950,10 +1260,12 @@ me.addListener('firstBeforeExecCommand focus', clear); } }(), + /** - * show方法的兼容版本 + * 显示编辑器,show方法的兼容版本 + * @method setShow * @private - * @ignore + * @param { String } cont 要存入的内容 */ setShow: function () { var me = this, range = me.selection.getRange(); @@ -971,20 +1283,26 @@ }, 100); me.container.style.display = ''; } - }, + /** * 显示编辑器 - * @name show - * @grammar editor.show() + * @method show + * @param { String } cont 要存入的内容 + * @example + * ```javascript + * editor.show() + * ``` + * @see UE.Editor:setShow(String) */ show: function () { return this.setShow(); }, + /** - * hide方法的兼容版本 + * 隐藏编辑器,hide方法的兼容版本 + * @method setHide * @private - * @ignore */ setHide: function () { var me = this; @@ -993,20 +1311,29 @@ } me.container.style.display = 'none' }, + /** * 隐藏编辑器 - * @name hide - * @grammar editor.hide() + * @method hide + * @example + * ```javascript + * editor.hide() + * ``` + * @see UE.Editor:setHide() */ hide: function () { return this.setHide(); }, + /** - * 根据制定的路径,获取对应的语言资源 - * @name getLang - * @grammar editor.getLang(path) => (JSON|String) 路径根据的是lang目录下的语言文件的路径结构 + * 根据指定的路径,获取对应的语言资源 + * @method getLang + * @param { String } path 路径根据的是lang目录下的语言文件的路径结构 + * @return { PlainObject | String } 根据路径返回语言资源的Json格式对象或者语言字符串 * @example - * editor.getLang('contextMenu.delete') //如果当前是中文,那返回是的是删除 + * ```javascript + * editor.getLang('contextMenu.delete'); //如果当前是中文,那返回是的是'删除' + * ``` */ getLang: function (path) { var lang = UE.I18N[this.options.lang]; @@ -1020,15 +1347,41 @@ } return lang; }, + + /** + * 计算编辑器当前html内容的长度 + * @method getContentLength + * @return { Number } 返回计算的长度 + * @example + * ```javascript + * editor.getContentLength() + * ``` + */ + + /** + * 计算编辑器当前存文本内容的长度 + * @method getContentLength + * @param { Boolean } ingoneHtml + * @return { Number } 返回计算的长度,内容中有hr/img/iframe标签,长度加1 + * @example + * ```javascript + * editor.getContentLength(true) + * ``` + */ + /** * 计算编辑器当前内容的长度 - * @name getContentLength - * @grammar editor.getContentLength(ingoneHtml,tagNames) => + * @method getContentLength + * @param { Boolean } ingoneHtml + * @param { Array } tagNames + * @return { Number } 返回计算的长度,内容中有hr/img/iframe标签或者参数tagNames中的标签,长度加1 * @example - * editor.getLang(true) + * ```javascript + * editor.getContentLength(true, ['em','strong']) + * ``` */ getContentLength: function (ingoneHtml, tagNames) { - var count = this.getContent(false,false,true).length; + var count = this.getContent(false, false, true).length; if (ingoneHtml) { tagNames = (tagNames || []).concat([ 'hr', 'img', 'iframe']); count = this.getContentTxt().replace(/[\t\r\n]+/g, '').length; @@ -1038,31 +1391,62 @@ } return count; }, + + /** + * 添加输入过滤规则 + * @method addInputRule + * @param { PlainObject } rule 要添加的过滤规则 + * @example + * ```javascript + * editor.addOutputRule(rule); + * ``` + */ addInputRule: function (rule) { this.inputRules.push(rule); }, + + /** + * 根据输入过滤规则,过滤编辑器内容 + * @method filterInputRule + * @param { Element } root 要过滤的文档节点 + * @example + * ```javascript + * editor.filterInputRule(editor.body); + * ``` + */ filterInputRule: function (root) { for (var i = 0, ci; ci = this.inputRules[i++];) { ci.call(this, root) } }, + + /** + * 添加输出过滤规则 + * @method addOutputRule + * @param { PlainObject } rule 要添加的过滤规则 + * @example + * ```javascript + * editor.addOutputRule(rule); + * ``` + */ addOutputRule: function (rule) { this.outputRules.push(rule) }, + + /** + * 根据输出过滤规则,过滤编辑器内容 + * @method filterOutputRule + * @param { Element } root 要过滤的文档节点 + * @example + * ```javascript + * editor.filterOutputRule(editor.body); + * ``` + */ filterOutputRule: function (root) { for (var i = 0, ci; ci = this.outputRules[i++];) { ci.call(this, root) } } - /** - * 得到dialog实例对象 - * @name getDialog - * @grammar editor.getDialog(dialogName) => Object - * @example - * var dialog = editor.getDialog("insertimage"); - * dialog.open(); //打开dialog - * dialog.close(); //关闭dialog - */ }; utils.inherits(Editor, EventBase); })(); From e0d54a07afb90c99170c1c5c936bc5b3ef721554 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E8=AE=B8=E6=81=92?= Date: Fri, 23 Aug 2013 14:02:33 +0800 Subject: [PATCH 03/81] [fixed] by xuheng --- _src/core/Editor.js | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/_src/core/Editor.js b/_src/core/Editor.js index f4f477e3f..087546235 100644 --- a/_src/core/Editor.js +++ b/_src/core/Editor.js @@ -1395,10 +1395,14 @@ /** * 添加输入过滤规则 * @method addInputRule - * @param { PlainObject } rule 要添加的过滤规则 + * @param { Function } rule 要添加的过滤规则 * @example * ```javascript - * editor.addOutputRule(rule); + * editor.addOutputRule(function(root){ + * $.each(root.getNodesByTagName('p'),function(i,node){ + * node.tagName="div"; + * }); + * }); * ``` */ addInputRule: function (rule) { From 7cdaab83ece2aed015454467733046a38041d197 Mon Sep 17 00:00:00 2001 From: hancong03 <121371790@qq.com> Date: Mon, 26 Aug 2013 13:29:14 +0800 Subject: [PATCH 04/81] =?UTF-8?q?=E6=96=87=E6=A1=A3=E6=9B=B4=E6=96=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- _src/core/ajax.js | 96 ++- _src/core/browser.js | 185 ++++-- _src/core/domUtils.js | 1361 +++++++++++++++++++++++++++++++++++------ 3 files changed, 1380 insertions(+), 262 deletions(-) diff --git a/_src/core/ajax.js b/_src/core/ajax.js index a5a354663..c3f6d3da4 100644 --- a/_src/core/ajax.js +++ b/_src/core/ajax.js @@ -1,17 +1,16 @@ /** * @file - * @name UE.ajax - * @short Ajax - * @desc UEditor内置的ajax请求模块 - * @import core/utils.js - * @user: taoqili - * @date: 11-8-18 - * @time: 下午3:18 + * @module UE.ajax + * @since 1.2.6.1 + */ + +/** + * 提供对ajax请求的支持 + * @module UE.ajax */ UE.ajax = function() { - /** - * 创建一个ajaxRequest对象 - */ + + //创建一个ajaxRequest对象 var fnStr = 'XMLHttpRequest()'; try { new ActiveXObject("Msxml2.XMLHTTP"); @@ -26,7 +25,7 @@ UE.ajax = function() { var creatAjaxRequest = new Function('return new ' + fnStr); - /** + /* * 将json参数转化成适合ajax提交的参数列表 * @param json */ @@ -46,30 +45,63 @@ UE.ajax = function() { return { - /** - * @name request - * @desc 发出ajax请求,ajaxOpt中默认包含method,timeout,async,data,onsuccess以及onerror等六个,支持自定义添加参数 - * @grammar UE.ajax.request(url,ajaxOpt); + /** + * 根据给定的参数项,向指定的url发起一个ajax请求。 ajax请求完成后,会根据请求结果调用相应回调: 如果请求 + * 成功, 则调用onsuccess回调, 失败则调用 onerror 回调 + * @method request + * @param { URLString } url ajax请求的url地址 + * @param { PlainObject } ajaxOptions ajax请求选项的key-value对象,支持的选项如下: * @example - * UE.ajax.request('http://www.xxxx.com/test.php',{ - * //可省略,默认POST - * method:'POST', - * //可以自定义参数 - * content:'这里是提交的内容', - * //也可以直接传json,但是只能命名为data,否则当做一般字符串处理 - * data:{ - * name:'UEditor', - * age:'1' - * } - * onsuccess:function(xhr){ - * console.log(xhr.responseText); + * ```javascript + * //向sayhello.php发起一个异步的Ajax GET请求, 请求超时时间为10s, 请求完成后执行相应的回调。 + * UE.ajax.requeset( 'sayhello.php', { + * + * //请求方法。可选值: 'GET', 'POST',默认值是'POST' + * method: 'GET', + * + * //超时时间。 默认为5000, 单位是ms + * timeout: 10000, + * + * //是否是异步请求。 true为异步请求, false为同步请求 + * async: true, + * + * //请求携带的数据。如果请求为GET请求, data会经过stringify后附加到请求url之后。 + * data: { + * name: 'ueditor' + * }, + * + * //请求成功后的回调, 该回调接受当前的XMLHttpRequest对象作为参数。 + * onsuccess: function ( xhr ) { + * console.log( xhr.responseText ); * }, - * onerror:function(xhr){ - * console.log(xhr.responseText); + * + * //请求失败或者超时后的回调。 + * onerror: function ( xhr ) { + * alert( 'Ajax请求失败' ); * } - * }) - * @param ajaxOptions - */ + * + * } ); + * ``` + */ + + /** + * 根据给定的参数项发起一个ajax请求, 参数项里必须包含一个url地址。 ajax请求完成后,会根据请求结果调用相应回调: 如果请求 + * 成功, 则调用onsuccess回调, 失败则调用 onerror 回调。 + * @method request + * @warning 如果在参数项里未提供一个key为“url”的地址值,则该请求将直接退出。 + * @param { PlainObject } ajaxOptions ajax请求选项的key-value对象,支持的选项如下: + * @example + * ```javascript + * + * //向sayhello.php发起一个异步的Ajax POST请求, 请求超时时间为5s, 请求完成后不执行任何回调。 + * UE.ajax.requeset( 'sayhello.php', { + * + * //请求的地址, 该项是必须的。 + * url: 'sayhello.php' + * + * } ); + * ``` + */ request:function(url, ajaxOptions) { var ajaxRequest = creatAjaxRequest(), //是否超时 diff --git a/_src/core/browser.js b/_src/core/browser.js index ecb749e96..843fcecf7 100644 --- a/_src/core/browser.js +++ b/_src/core/browser.js @@ -1,53 +1,85 @@ /** + * 浏览器判断模块 * @file - * @name UE.browser - * @short Browser - * @desc UEditor中采用的浏览器判断模块 + * @module UE.browser + * @since 1.2.6.1 + */ + +/** + * 提供浏览器检测的模块 + * @unfile + * @module UE.browser */ var browser = UE.browser = function(){ var agent = navigator.userAgent.toLowerCase(), opera = window.opera, browser = { + /** - * 检测浏览器是否为IE - * @name ie - * @grammar UE.browser.ie => true|false + * @property {boolean} ie 检测当前浏览器是否为IE + * @example + * ```javascript + * if ( UE.browser.ie ) { + * console.log( '当前浏览器是IE' ); + * } + * ``` */ ie : !!window.ActiveXObject, /** - * 检测浏览器是否为Opera - * @name opera - * @grammar UE.browser.opera => true|false + * @property {boolean} opera 检测当前浏览器是否为Opera + * @example + * ```javascript + * if ( UE.browser.opera ) { + * console.log( '当前浏览器是Opera' ); + * } + * ``` */ opera : ( !!opera && opera.version ), /** - * 检测浏览器是否为webkit内核 - * @name webkit - * @grammar UE.browser.webkit => true|false + * @property {boolean} webkit 检测当前浏览器是否是webkit内核的浏览器 + * @example + * ```javascript + * if ( UE.browser.webkit ) { + * console.log( '当前浏览器是webkit内核浏览器' ); + * } + * ``` */ webkit : ( agent.indexOf( ' applewebkit/' ) > -1 ), /** - * 检测浏览器是否为mac系统下的浏览器 - * @name mac - * @grammar UE.browser.mac => true|false + * @property {boolean} mac 检测当前浏览器是否是运行在mac平台下 + * @example + * ```javascript + * if ( UE.browser.mac ) { + * console.log( '当前浏览器运行在mac平台下' ); + * } + * ``` */ mac : ( agent.indexOf( 'macintosh' ) > -1 ), /** - * 检测浏览器是否处于怪异模式 - * @name quirks - * @grammar UE.browser.quirks => true|false + * @property {boolean} quirks 检测当前浏览器是否处于“怪异模式”下 + * @example + * ```javascript + * if ( UE.browser.quirks ) { + * console.log( '当前浏览器运行处于“怪异模式”' ); + * } + * ``` */ quirks : ( document.compatMode == 'BackCompat' ) }; + /** - * 检测浏览器是否处为gecko内核 - * @name gecko - * @grammar UE.browser.gecko => true|false - */ + * @property {boolean} gecko 检测当前浏览器内核是否是gecko内核 + * @example + * ```javascript + * if ( UE.browser.gecko ) { + * console.log( '当前浏览器内核是gecko内核' ); + * } + * ``` + */ browser.gecko =( navigator.product == 'Gecko' && !browser.webkit && !browser.opera ); var version = 0; @@ -56,37 +88,63 @@ var browser = UE.browser = function(){ if ( browser.ie ){ version = parseFloat( agent.match( /msie (\d+)/ )[1] ); /** - * 检测浏览器是否为 IE9 模式 - * @name ie9Compat - * @grammar UE.browser.ie9Compat => true|false + * @property { boolean } ie9Compat 检测浏览器模式是否为 IE9 兼容模式 + * @warning 如果浏览器不是IE, 则该值为undefined + * @example + * ```javascript + * if ( UE.browser.ie9Compat ) { + * console.log( '当前浏览器运行在IE9兼容模式下' ); + * } + * ``` */ browser.ie9Compat = document.documentMode == 9; + /** - * 检测浏览器是否为 IE8 浏览器 - * @name ie8 - * @grammar UE.browser.ie8 => true|false + * @property { boolean } ie8 检测浏览器是否是IE8浏览器 + * @warning 如果浏览器不是IE, 则该值为undefined + * @example + * ```javascript + * if ( UE.browser.ie8 ) { + * console.log( '当前浏览器是IE8浏览器' ); + * } + * ``` */ browser.ie8 = !!document.documentMode; /** - * 检测浏览器是否为 IE8 模式 - * @name ie8Compat - * @grammar UE.browser.ie8Compat => true|false + * @property { boolean } ie8Compat 检测浏览器模式是否为 IE8 兼容模式 + * @warning 如果浏览器不是IE, 则该值为undefined + * @example + * ```javascript + * if ( UE.browser.ie8Compat ) { + * console.log( '当前浏览器运行在IE8兼容模式下' ); + * } + * ``` */ browser.ie8Compat = document.documentMode == 8; /** - * 检测浏览器是否运行在 兼容IE7模式 - * @name ie7Compat - * @grammar UE.browser.ie7Compat => true|false + * @property { boolean } ie7Compat 检测浏览器模式是否为 IE7 兼容模式 + * @warning 如果浏览器不是IE, 则该值为undefined + * @example + * ```javascript + * if ( UE.browser.ie7Compat ) { + * console.log( '当前浏览器运行在IE7兼容模式下' ); + * } + * ``` */ browser.ie7Compat = ( ( version == 7 && !document.documentMode ) || document.documentMode == 7 ); /** - * 检测浏览器是否IE6模式或怪异模式 - * @name ie6Compat - * @grammar UE.browser.ie6Compat => true|false + * @property { boolean } ie6Compat 检测浏览器模式是否为 IE6 模式 或者怪异模式 + * @warning 如果浏览器不是IE, 则该值为undefined + * @example + * ```javascript + * if ( UE.browser.ie6Compat ) { + * console.log( '当前浏览器运行在IE6模式或者怪异模式下' ); + * } + * ``` */ browser.ie6Compat = ( version < 7 || browser.quirks ); @@ -101,18 +159,30 @@ var browser = UE.browser = function(){ version = geckoRelease[0] * 10000 + ( geckoRelease[1] || 0 ) * 100 + ( geckoRelease[2] || 0 ) * 1; } } + /** - * 检测浏览器是否为chrome - * @name chrome - * @grammar UE.browser.chrome => true|false + * @property { Number } chrome 检测当前浏览器是否为Chrome, 如果是,则返回Chrome的大版本号 + * @warning 如果浏览器不是chrome, 则该值为undefined + * @example + * ```javascript + * if ( UE.browser.chrome ) { + * console.log( '当前浏览器是Chrome' ); + * } + * ``` */ if (/chrome\/(\d+\.\d)/i.test(agent)) { browser.chrome = + RegExp['\x241']; } + /** - * 检测浏览器是否为safari - * @name safari - * @grammar UE.browser.safari => true|false + * @property { Number } safari 检测当前浏览器是否为Safari, 如果是,则返回Safari的大版本号 + * @warning 如果浏览器不是safari, 则该值为undefined + * @example + * ```javascript + * if ( UE.browser.safari ) { + * console.log( '当前浏览器是Safari' ); + * } + * ``` */ if(/(\d+\.\d)?(?:\.\d)?\s+safari\/?(\d+\.\d+)?/i.test(agent) && !/chrome/i.test(agent)){ browser.safari = + (RegExp['\x241'] || RegExp['\x242']); @@ -128,27 +198,28 @@ var browser = UE.browser = function(){ version = parseFloat( agent.match( / applewebkit\/(\d+)/ )[1] ); /** - * 浏览器版本判断 - * IE系列返回值为5,6,7,8,9,10等 - * gecko系列会返回10900,158900等. - * webkit系列会返回其build号 (如 522等). - * @name version - * @grammar UE.browser.version => number + * @property { Number } version 检测当前浏览器版本号 + * @remind + * * @example - * if ( UE.browser.ie && UE.browser.version == 6 ){ - * alert( "Ouch!居然是万恶的IE6!" ); - * } + * ```javascript + * console.log( '当前浏览器版本号是: ' + UE.browser.version ); + * ``` */ browser.version = version; /** - * 是否是兼容模式的浏览器 - * @name isCompatible - * @grammar UE.browser.isCompatible => true|false + * @property { boolean } isCompatible 检测当前浏览器是否能够与UEditor良好兼容 * @example - * if ( UE.browser.isCompatible ){ - * alert( "你的浏览器相当不错哦!" ); + * ```javascript + * if ( UE.browser.isCompatible ) { + * console.log( '浏览器与UEditor能够良好兼容' ); * } + * ``` */ browser.isCompatible = !browser.mobile && ( diff --git a/_src/core/domUtils.js b/_src/core/domUtils.js index 7eb91d6e7..97c09cacd 100644 --- a/_src/core/domUtils.js +++ b/_src/core/domUtils.js @@ -1,9 +1,8 @@ /** + * Dom操作工具包 * @file - * @name UE.dom.domUtils - * @short DomUtils - * @import editor.js, core/utils.js,core/browser.js,core/dom/dtd.js - * @desc UEditor封装的底层dom操作库 + * @module UE.dom.domUtils + * @since 1.2.6.1 */ function getDomNode(node, start, ltr, startFromChild, fn, guard) { var tmpNode = startFromChild && node[start], @@ -69,19 +68,44 @@ var domUtils = dom.domUtils = { }, /** * 获取节点A相对于节点B的位置关系 - * @name getPosition - * @grammar UE.dom.domUtils.getPosition(nodeA,nodeB) => Number + * @method getPosition + * @param { DomNode } nodeA 需要查询位置关系的节点A + * @param { DomNode } nodeB 需要查询位置关系的节点B + * @return { Number } 节点A与节点B的关系 * @example - * switch (returnValue) { - * case 0: //相等,同一节点 - * case 1: //无关,节点不相连 - * case 2: //跟随,即节点A头部位于节点B头部的后面 - * case 4: //前置,即节点A头部位于节点B头部的前面 - * case 8: //被包含,即节点A被节点B包含 - * case 10://组合类型,即节点A满足跟随节点B且被节点B包含。实际上,如果被包含,必定跟随,所以returnValue事实上不会存在8的情况。 - * case 16://包含,即节点A包含节点B - * case 20://组合类型,即节点A满足前置节点A且包含节点B。同样,如果包含,必定前置,所以returnValue事实上也不会存在16的情况 - * } + * ```javascript + * //output: 20 + * var position = UE.dom.domUtils.getPosition( document.documentElement, document.body ); + * + * switch ( position ) { + * + * case 0: + * console.log('相等,同一节点'); + * break; + * case 1: + * console.log('无关,节点不相连'); + * break; + * case 2: + * console.log('跟随,即节点A头部位于节点B头部的后面'); + * break; + * case 4; + * console.log('前置,即节点A头部位于节点B头部的前面'); + * break; + * case 8: + * console.log('被包含,即节点A被节点B包含'); + * break; + * case 10: + * console.log('组合类型,即节点A满足跟随节点B且被节点B包含。'); + * break; + * case 16: + * console.log('包含,即节点A包含节点B'); + * break; + * case 20: + * console.log('组合类型,即节点A满足前置节点A且包含节点B。'); + * break; + * + * } + * ``` */ getPosition:function (nodeA, nodeB) { // 如果两个节点是同一个节点 @@ -132,9 +156,18 @@ var domUtils = dom.domUtils = { }, /** - * 返回节点node在父节点中的索引位置 - * @name getNodeIndex - * @grammar UE.dom.domUtils.getNodeIndex(node) => Number //索引值从0开始 + * 检测节点node在父节点中的索引位置, 忽略文本节点 + * @method getNodeIndex + * @param { DomNode } node 需要检测的节点对象 + * @return { Number } 该节点在父节点中的位置 + */ + + /** + * 检测节点node在父节点中的索引位置, 根据给定的ignoreTextNode参数决定是否要忽略文本节点 + * @method getNodeIndex + * @param { DomNode } node 需要检测的节点对象 + * @param { Boolean } ignoreTextNode 是否忽略文本节点 + * @return { Number } 该节点在父节点中的位置 */ getNodeIndex:function (node, ignoreTextNode) { var preNode = node, @@ -153,18 +186,93 @@ var domUtils = dom.domUtils = { /** * 检测节点node是否在节点doc的树上,实质上是检测是否被doc包含 - * @name inDoc - * @grammar UE.dom.domUtils.inDoc(node,doc) => true|false + * @method inDoc + * @param { DomNode } node 需要检测的节点对象 + * @param { DomNode } doc 需要检测的节点对象 + * @return { Boolean } doc节点是否包含node节点 */ inDoc:function (node, doc) { return domUtils.getPosition(node, doc) == 10; }, + + /** + * 查找node节点的父节点,查找的过程中不包含自身节点。 + * @method findParent + * @param { DomNode } node 需要查找的节点 + * @return { DomNode | Null } 如果该节点有父节点就返回该父节点, 否则返回NULL + * @warning 查找的终点是到body节点为止 + * @example + * ```javascript + * //因为查找的终点是body标签,所以查找body的父节点将返回NULL + * var parentNode = UE.dom.domUtils.findParent( document.body ); + * //output: true + * console.log( parentNode === null ) + * ``` + * @example + * ```javascript + * var parentNode = UE.dom.domUtils.findParent( document.body.firstChild ); + * //output: BODY + * console.log( parentNode.tagName ); + * ``` + */ + /** - * 查找node节点的祖先节点 - * @name findParent - * @grammar UE.dom.domUtils.findParent(node) => Element // 直接返回node节点的父节点 - * @grammar UE.dom.domUtils.findParent(node,filterFn) => Element //filterFn为过滤函数,node作为参数,返回true时才会将node作为符合要求的节点返回 - * @grammar UE.dom.domUtils.findParent(node,filterFn,includeSelf) => Element //includeSelf指定是否包含自身 + * 根据给定的过滤规则filterFn, 查找符合该过滤规则的node节点的祖先节点, + * 查找的过程中不包含自身节点。 + * @method findParent + * @param { DomNode } node 需要查找的节点 + * @param { Function } filterFn 自定义的过滤方法。 + * @warning 查找的终点是到body节点为止 + * @remind 自定义的过滤方法filterFn接受一个DomNode对象作为参数, 该对象代表当前执行检测的节点。 如果该 + * 节点满足过滤条件, 则要求返回true, 否则, 请返回false。 + * @return { DomNode | Null } 如果找到符合过滤条件的节点, 就返回该节点, 否则返回NULL + * @example + * ```javascript + * var filterNode = UE.dom.domUtils.findParent( document.body.firstChild, function ( node ) { + * + * //由于查找的终点是body节点, 所以永远也不会匹配当前过滤器的条件, 即这里永远会返回false + * return node.tagName === "HTML"; + * + * } ); + * + * //output: true + * console.log( filterNode === null ); + * ``` + */ + + /** + * 根据给定的过滤规则filterFn, 查找符合该过滤规则的node节点的祖先节点, + * 查找的过程中根据includeSelf的值决定是否包含自身节点。 + * @method findParent + * @param { DomNode } node 需要查找的节点 + * @param { Function } filterFn 自定义的过滤方法。 + * @param { Boolean } includeSelf 查找过程是否包含自身 + * @warning 查找的终点是到body节点为止 + * @remind 自定义的过滤方法filterFn接受一个DomNode对象作为参数, 该对象代表当前执行检测的节点。 如果该 + * 节点满足过滤条件, 则要求返回true, 否则, 请返回false。 + * @remind 如果includeSelf为true, 则过滤器第一次执行时的参数会是节点本身。 + * 反之, 过滤器第一次执行时的参数将是该节点的父节点。 + * @return { DomNode | Null } 如果找到符合过滤条件的节点, 就返回该节点, 否则返回NULL + * @example + * ```html + * + * + *
+ *
+ * + * + * + * ``` */ findParent:function (node, filterFn, includeSelf) { if (node && !domUtils.isBody(node)) { @@ -178,12 +286,64 @@ var domUtils = dom.domUtils = { } return null; }, + /** - * 通过tagName查找node节点的祖先节点 - * @name findParentByTagName - * @grammar UE.dom.domUtils.findParentByTagName(node,tagNames) => Element //tagNames支持数组,区分大小写 - * @grammar UE.dom.domUtils.findParentByTagName(node,tagNames,includeSelf) => Element //includeSelf指定是否包含自身 - * @grammar UE.dom.domUtils.findParentByTagName(node,tagNames,includeSelf,excludeFn) => Element //excludeFn指定例外过滤条件,返回true时忽略该节点 + * 查找node的节点名为tagName的祖先节点, 查找过程中不包含node节点自身 + * @method findParentByTagName + * @param { DomNode } node 需要查找的节点对象 + * @param { Array } tagNames 需要查找的父节点的名称数组 + * @warning 查找的终点是到body节点为止 + * @return { DomNode | NULL } 如果找到符合条件的节点, 则返回该节点, 否则返回NULL + * @example + * ```javascript + * var node = UE.dom.domUtils.findParentByTagName( document.getElementsByTagName("div")[0], [ "BODY" ] ); + * //output: BODY + * console.log( node.tagName ); + * ``` + */ + + /** + * 查找node的节点名为tagName的祖先节点, 查找过程中根据includeSelf的值决定是否包含node节点自身 + * @method findParentByTagName + * @param { DomNode } node 需要查找的节点对象 + * @param { Array } tagNames 需要查找的父节点的名称数组 + * @param { Boolean } includeSelf 查找过程是否包含node节点自身 + * @warning 查找的终点是到body节点为止 + * @return { DomNode | NULL } 如果找到符合条件的节点, 则返回该节点, 否则返回NULL + * @example + * ```javascript + * var queryTarget = document.getElementsByTagName("div")[0]; + * var node = UE.dom.domUtils.findParentByTagName( queryTarget, [ "DIV" ], true ); + * //output: true + * console.log( queryTarget === node ); + * ``` + */ + + /** + * 查找node的节点名为tagName的祖先节点,并且该祖先节点不满足excludeFn过滤器的过滤要求, + * 查找过程中根据includeSelf的值决定是否包含node节点自身, + * @method findParentByTagName + * @param { DomNode } node 需要查找的节点对象 + * @param { Array } tagNames 需要查找的父节点的名称数组 + * @param { Boolean } includeSelf 查找过程是否包含node节点自身 + * @param { Function } excludeFn 查找过程中应用的过滤器, 如果该过滤器对给定的节点返回true, + * 则该节点将被排除在查询结果之外。 + * @remind 查找过滤器excludeFn要求对不应该被匹配的节点应该返回true + * @warning 查找的终点是到body节点为止 + * @return { DomNode | NULL } 如果找到符合条件的节点, 则返回该节点, 否则返回NULL + * @example + * ```javascript + * var queryTarget = document.getElementsByTagName("div")[0]; + * + * //需要查找的节点和过滤器的过滤条件刚好冲突, 执行结果将永远为NULL + * var node = UE.dom.domUtils.findParentByTagName( queryTarget, [ "DIV" ], false, function ( node ) { + * + * return node.tagName.toLowerCase() === 'div'; + * + * } ); + * //output: true + * console.log( queryTarget === null ); + * ``` */ findParentByTagName:function (node, tagNames, includeSelf, excludeFn) { tagNames = utils.listToMap(utils.isArray(tagNames) ? tagNames : [tagNames]); @@ -191,6 +351,7 @@ var domUtils = dom.domUtils = { return tagNames[node.tagName] && !(excludeFn && excludeFn(node)); }, includeSelf); }, + /** * 查找节点node的祖先节点集合 * @name findParents @@ -209,18 +370,50 @@ var domUtils = dom.domUtils = { /** * 在节点node后面插入新节点newNode - * @name insertAfter - * @grammar UE.dom.domUtils.insertAfter(node,newNode) => newNode + * @method insertAfter + * @param { DomNode } node 目标节点 + * @param { DomNode } newNode 新插入的节点, 该节点将置于目标节点之后 + * @return { DomNode } 新插入的节点 */ insertAfter:function (node, newNode) { return node.parentNode.insertBefore(newNode, node.nextSibling); }, /** - * 删除节点node,并根据keepChildren指定是否保留子节点 - * @name remove - * @grammar UE.dom.domUtils.remove(node) => node - * @grammar UE.dom.domUtils.remove(node,keepChildren) => node + * 删除节点node及其下属的所有节点 + * @method remove + * @param { DomNode } node 需要删除的节点对象 + * @return { DomNode } 返回刚删除的节点对象 + * @example + * ```html + *
+ *
你好
+ *
+ * + * ``` + */ + + /** + * 删除节点node,并根据keepChildren的值决定是否保留子节点 + * @method remove + * @param { DomNode } node 需要删除的节点对象 + * @param { Boolean } keepChildren 是否需要保留子节点 + * @return { DomNode } 返回刚删除的节点对象 + * @example + * ```html + *
+ *
你好
+ *
+ * + * ``` */ remove:function (node, keepChildren) { var parent = node.parentNode, @@ -236,36 +429,61 @@ var domUtils = dom.domUtils = { return node; }, - /** + /* * 取得node节点在dom树上的下一个节点,即多叉树遍历 - * @name getNextDomNode - * @grammar UE.dom.domUtils.getNextDomNode(node) => Element - * @example */ getNextDomNode:function (node, startFromChild, filterFn, guard) { return getDomNode(node, 'firstChild', 'nextSibling', startFromChild, filterFn, guard); }, + /** - * 检测节点node是否属于bookmark节点 - * @name isBookmarkNode - * @grammar UE.dom.domUtils.isBookmarkNode(node) => true|false + * 检测节点node是否属是UEditor定义的bookmark节点 + * @method isBookmarkNode + * @param { DomNode } node 需要检测的节点对象 + * @return { Boolean } 是否是bookmark节点 + * @example + * ```html + * + * + * ``` */ isBookmarkNode:function (node) { return node.nodeType == 1 && node.id && /^_baidu_bookmark_/i.test(node.id); }, + /** - * 获取节点node所在的window对象 - * @name getWindow - * @grammar UE.dom.domUtils.getWindow(node) => window对象 + * 获取节点node所属的window对象 + * @method getWindow + * @param { DomNode } node 节点对象 + * @return { Window } 当前节点所属的window对象 + * @example + * ```javascript + * //output: true + * console.log( UE.dom.domUtils.getWindow( document.body ) === window ); + * ``` */ getWindow:function (node) { var doc = node.ownerDocument || node; return doc.defaultView || doc.parentWindow; }, + /** - * 得到nodeA与nodeB公共的祖先节点 - * @name getCommonAncestor - * @grammar UE.dom.domUtils.getCommonAncestor(nodeA,nodeB) => Element + * 获取离nodeA与nodeB最近的公共的祖先节点 + * @method getCommonAncestor + * @param { DomNode } nodeA 第一个节点 + * @param { DomNode } nodeB 第二个节点 + * @remind 如果给定的两个节点是同一个节点, 将直接返回该节点。 + * @return { DomNode | NULL } 如果未找到公共节点, 返回NULL, 否则返回最近的公共祖先节点。 + * @example + * ```javascript + * var commonAncestor = UE.dom.domUtils.getCommonAncestor( document.body, document.body.firstChild ); + * //output: true + * console.log( commonAncestor.tagName.toLowerCase() === 'body' ); + * ``` */ getCommonAncestor:function (nodeA, nodeB) { if (nodeA === nodeB) @@ -290,7 +508,8 @@ var domUtils = dom.domUtils = { return i == 0 ? null : parentsA[i - 1]; }, - /** + + /* * 清除node节点左右兄弟为空的inline节点 * @name clearEmptySibling * @grammar UE.dom.domUtils.clearEmptySibling(node) @@ -313,10 +532,22 @@ var domUtils = dom.domUtils = { !ignoreNext && clear(node.nextSibling, 'nextSibling'); !ignorePre && clear(node.previousSibling, 'previousSibling'); }, + /** - * 将一个文本节点node拆分成两个文本节点,offset指定拆分位置 - * @name split - * @grammar UE.dom.domUtils.split(node,offset) => TextNode //返回从切分位置开始的后一个文本节点 + * 将一个文本节点textNode拆分成两个文本节点,offset指定拆分位置 + * @method split + * @param { DomNode } textNode 需要拆分的文本节点对象 + * @param { int } offset 需要拆分的位置, 位置计算从0开始 + * @return { DomNode } 拆分后形成的新节点 + * @example + * ```html + *
abcdef
+ * + * ``` */ split:function (node, offset) { var doc = node.ownerDocument; @@ -335,17 +566,38 @@ var domUtils = dom.domUtils = { }, /** - * 检测节点node是否为空节点(包括空格、换行、占位符等字符) - * @name isWhitespace - * @grammar UE.dom.domUtils.isWhitespace(node) => true|false + * 检测文本节点textNode是否为空节点(包括空格、换行、占位符等字符) + * @method isWhitespace + * @param { DomNode } node 需要检测的节点对象 + * @return { Boolean } 检测的节点是否为空 + * @example + * ```html + *
+ * + *
+ * + * ``` */ isWhitespace:function (node) { return !new RegExp('[^ \t\n\r' + domUtils.fillChar + ']').test(node.nodeValue); }, + /** * 获取元素element相对于viewport的位置坐标 - * @name getXY - * @grammar UE.dom.domUtils.getXY(element) => Object //返回坐标对象{x:left,y:top} + * @method getXY + * @param { DomNode } element 需要计算位置的节点对象 + * @return { PlainObject } 返回形如{x:left,y:top}的一个key-value映射对象, 其中键x代表水平偏移距离, + * y代表垂直偏移距离。 + * + * @example + * ```javascript + * var location = UE.dom.domUtils.getXY( document.getElementById("test") ); + * //output: test的坐标为: 12, 24 + * console.log( 'test的坐标为: ', location.x, ',', location.y ); + * ``` */ getXY:function (element) { var x = 0, y = 0; @@ -356,18 +608,33 @@ var domUtils = dom.domUtils = { } return { 'x':x, 'y':y}; }, + /** * 为元素element绑定原生DOM事件,type为事件类型,handler为处理函数 - * @name on - * @grammar UE.dom.domUtils.on(element,type,handler) //type支持数组传入 + * @method on + * @param { DomNode } element 需要绑定事件的节点对象 + * @param { String } type 绑定的事件类型 + * @param { Function } handler 事件处理器 * @example + * ```javascript * UE.dom.domUtils.on(document.body,"click",function(e){ * //e为事件对象,this为被点击元素对戏那个 - * }) + * }); + * ``` + */ + + /** + * 为元素element绑定原生DOM事件,type为事件类型,handler为处理函数 + * @method on + * @param { DomNode } element 需要绑定事件的节点对象 + * @param { Array } type 绑定的事件类型数组 + * @param { Function } handler 事件处理器 * @example + * ```javascript * UE.dom.domUtils.on(document.body,["click","mousedown"],function(evt){ * //evt为事件对象,this为被点击元素对象 - * }) + * }); + * ``` */ on:function (element, type, handler) { var types = utils.isArray(type) ? type : [type], @@ -400,10 +667,33 @@ var domUtils = dom.domUtils = { } element = null; }, + + /** + * 解除DOM事件绑定 + * @method un + * @param { DomNode } element 需要解除事件绑定的节点对象 + * @param { String } type 需要接触绑定的事件类型 + * @param { Function } handler 对应的事件处理器 + * @example + * ```javascript + * UE.dom.domUtils.un(document.body,"click",function(evt){ + * //evt为事件对象,this为被点击元素对象 + * }); + * ``` + */ + /** - * 解除原生DOM事件绑定 - * @name un - * @grammar UE.dom.donUtils.un(element,type,handler) //参见on + * 解除DOM事件绑定 + * @method un + * @param { DomNode } element 需要解除事件绑定的节点对象 + * @param { Array } type 需要接触绑定的事件类型数组 + * @param { Function } handler 对应的事件处理器 + * @example + * ```javascript + * UE.dom.domUtils.un(document.body, ["click","mousedown"],function(evt){ + * //evt为事件对象,this为被点击元素对象 + * }); + * ``` */ un:function (element, type, handler) { var types = utils.isArray(type) ? type : [type], @@ -430,11 +720,29 @@ var domUtils = dom.domUtils = { /** * 比较节点nodeA与节点nodeB是否具有相同的标签名、属性名以及属性值 - * @name isSameElement - * @grammar UE.dom.domUtils.isSameElement(nodeA,nodeB) => true|false + * @method isSameElement + * @param { DomNode } nodeA 需要比较的节点 + * @param { DomNode } nodeB 需要比较的节点 + * @return { Boolean } 两个节点是否具有相同的标签名、属性名以及属性值 * @example - * ssss and bbbbb => true - * ssss and bbbbb => false + * ```html + * ssss + * bbbbb + * ssss + * bbbbb + * + * + * ``` */ isSameElement:function (nodeA, nodeB) { if (nodeA.tagName != nodeB.tagName) { @@ -486,9 +794,30 @@ var domUtils = dom.domUtils = { }, /** - * 判断节点nodeA与节点nodeB的元素属性是否一致 - * @name isSameStyle - * @grammar UE.dom.domUtils.isSameStyle(nodeA,nodeB) => true|false + * 判断节点nodeA与节点nodeB的元素的style属性是否一致 + * @method isSameStyle + * @param { DomNode } nodeA 需要比较的节点 + * @param { DomNode } nodeB 需要比较的节点 + * @return { Boolean } 两个节点是否具有相同的style属性值 + * @example + * ```html + * ssss + * bbbbb + * ssss + * bbbbb + * + * + * ``` */ isSameStyle:function (nodeA, nodeB) { var styleA = nodeA.style.cssText.replace(/( ?; ?)/g, ';').replace(/( ?: ?)/g, ':'), @@ -523,23 +852,54 @@ var domUtils = dom.domUtils = { } return true; }, + /** - * 检查节点node是否为块元素 - * @name isBlockElm - * @grammar UE.dom.domUtils.isBlockElm(node) => true|false + * 检查节点node是否为block元素 + * @method isBlockElm + * @param { DomNode } node 需要检测的节点对象 + * @return { Boolean } 是否是block元素节点 + * @warning 该方法的判断规则如下: 如果该元素原本是block元素, 则不论该元素当前的css样式是什么都会返回true; + * 否则,检测该元素的css样式, 如果该元素当前是block元素, 则返回true。 其余情况下都返回false。 + * @example + * ```html + * + * + *
+ * + * + * ``` */ isBlockElm:function (node) { return node.nodeType == 1 && (dtd.$block[node.tagName] || styleBlock[domUtils.getComputedStyle(node, 'display')]) && !dtd.$nonChild[node.tagName]; }, + /** * 检测node节点是否为body节点 - * @name isBody - * @grammar UE.dom.domUtils.isBody(node) => true|false + * @method isBody + * @param { DomElement } node 需要检测的dom元素 + * @return { Boolean } 给定的元素是否是body元素 + * @example + * ```javascript + * //output: true + * console.log( UE.dom.domUtils.isBody( document.body ) ); + * ``` */ isBody:function (node) { return node && node.nodeType == 1 && node.tagName.toLowerCase() == 'body'; }, - /** + + /* * 以node节点为中心,将该节点的指定祖先节点parent拆分成2块 * @name breakParent * @grammar UE.dom.domUtils.breakParent(node,parent) => node @@ -582,7 +942,8 @@ var domUtils = dom.domUtils = { domUtils.remove(parent); return node; }, - /** + + /* * 检查节点node是否是空inline节点 * @name isEmptyInlineElement * @grammar UE.dom.domUtils.isEmptyInlineElement(node) => 1|0 @@ -614,9 +975,25 @@ var domUtils = dom.domUtils = { }, /** - * 删除node节点下的左右空白文本子节点 - * @name trimWhiteTextNode - * @grammar UE.dom.domUtils.trimWhiteTextNode(node) + * 删除node节点下首尾两端的空白文本子节点 + * @method trimWhiteTextNode + * @param { DomElement } node 需要执行删除操作的元素对象 + * @example + * ```html + *
+ *
+ *
+ * + * + * ``` */ trimWhiteTextNode:function (node) { function remove(dir) { @@ -629,11 +1006,9 @@ var domUtils = dom.domUtils = { remove('lastChild'); }, - /** + /* * 合并node节点下相同的子节点 - * @name mergeChild - * @desc - * UE.dom.domUtils.mergeChild(node,tagName) //tagName要合并的子节点的标签 + * @method mergeChild * @example *

xxaaxx

* ==> UE.dom.domUtils.mergeChild(node,'span') @@ -676,7 +1051,7 @@ var domUtils = dom.domUtils = { } }, - /** + /* * 原生方法getElementsByTagName的封装 * @name getElementsByTagName * @grammar UE.dom.domUtils.getElementsByTagName(node,tagName) => Array //节点集合数组 @@ -698,12 +1073,33 @@ var domUtils = dom.domUtils = { return arr; }, + /** - * 将节点node合并到父节点上 - * @name mergeToParent - * @grammar UE.dom.domUtils.mergeToParent(node) + * 将节点node提取到父节点上 + * @method mergeToParent + * @param { DomElement } node 需要提取的元素对象 * @example - * xxx ==> xxx + * ```html + *
+ *
+ * + *
+ *
+ * + * + * ``` */ mergeToParent:function (node) { var parent = node.parentNode; @@ -733,14 +1129,60 @@ var domUtils = dom.domUtils = { parent = parent.parentNode; } }, + /** * 合并节点node的左右兄弟节点 - * @name mergeSibling - * @grammar UE.dom.domUtils.mergeSibling(node) - * @grammar UE.dom.domUtils.mergeSibling(node,ignorePre) //ignorePre指定是否忽略左兄弟 - * @grammar UE.dom.domUtils.mergeSibling(node,ignorePre,ignoreNext) //ignoreNext指定是否忽略右兄弟 + * @method mergeSibling + * @param { DomElement } node 需要合并的目标节点 + * @example + * ```html + * xxxxoooxxxx + * + * + * ``` + */ + + /** + * 合并节点node的左右兄弟节点, 可以根据给定的条件选择是否忽略合并左节点。 + * @method mergeSibling + * @param { DomElement } node 需要合并的目标节点 + * @param { Boolean } ignorePre 是否忽略合并左节点 + * @example + * ```html + * xxxxoooxxxx + * + * + * ``` + */ + + /** + * 合并节点node的左右兄弟节点,可以根据给定的条件选择是否忽略合并左右节点。 + * @method mergeSibling + * @param { DomElement } node 需要合并的目标节点 + * @param { Boolean } ignorePre 是否忽略合并左节点 + * @param { Boolean } ignoreNext 是否忽略合并右节点 + * @remind 如果同时忽略左右节点, 则该操作什么也不会做 * @example - * xxxxoooxxxx ==> xxxxoooxxxx + * ```html + * xxxxoooxxxx + * + * + * ``` */ mergeSibling:function (node, ignorePre, ignoreNext) { function merge(rtl, start, node) { @@ -762,8 +1204,13 @@ var domUtils = dom.domUtils = { /** * 设置节点node及其子节点不会被选中 - * @name unSelectable - * @grammar UE.dom.domUtils.unSelectable(node) + * @method unSelectable + * @param { DomElement } node 需要执行操作的dom元素 + * @remind 执行该操作后的节点, 将不能被鼠标选中 + * @example + * ```javascript + * UE.dom.domUtils.unSelectable( document.body ); + * ``` */ unSelectable:ie || browser.opera ? function (node) { //for ie9 @@ -792,17 +1239,47 @@ var domUtils = dom.domUtils = { node.style.webkitUserSelect = node.style.KhtmlUserSelect = 'none'; }, + /** - * 删除节点node上的属性attrNames,attrNames为属性名称数组 - * @name removeAttributes - * @grammar UE.dom.domUtils.removeAttributes(node,attrNames) + * 删除节点node上的指定属性名称的属性 + * @method removeAttributes + * @param { String } attrNames 可以是空格隔开的多个属性名称,该操作将会依次删除相应的属性 * @example - * //Before remove - * xxxxx - * //Remove - * UE.dom.domUtils.removeAttributes(node,["id","name"]); - * //After remove - * xxxxx + * ```html + *
+ * xxxxx + *
+ * + * + * ``` + */ + + /** + * 删除节点node上的指定属性名称的属性 + * @method removeAttributes + * @param { Array } attrNames 需要删除的属性名数组 + * @example + * ```html + *
+ * xxxxx + *
+ * + * + * ``` */ removeAttributes:function (node, attrNames) { attrNames = utils.isArray(attrNames) ? attrNames : utils.trim(attrNames).replace(/[ ]{2,}/g,' ').split(' '); @@ -819,18 +1296,53 @@ var domUtils = dom.domUtils = { node.removeAttribute(ci); } }, + /** * 在doc下创建一个标签名为tag,属性为attrs的元素 - * @name createElement - * @grammar UE.dom.domUtils.createElement(doc,tag,attrs) => Node //返回创建的节点 + * @method createElement + * @param { DomDocument } doc 新创建的元素属于该document节点创建 + * @param { String } tagName 需要创建的元素的标签名 + * @param { PlainObject } attrs 新创建的元素的属性key-value集合 + * @return { DomElement } 新创建的元素对象 + * @example + * ```javascript + * var ele = UE.dom.domUtils.createElement( document, 'div', { + * id: 'test' + * } ); + * + * //output: DIV + * console.log( ele.tagName ); + * + * //output: test + * console.log( ele.id ); + * + * ``` */ createElement:function (doc, tag, attrs) { return domUtils.setAttributes(doc.createElement(tag), attrs) }, + /** * 为节点node添加属性attrs,attrs为属性键值对 - * @name setAttributes - * @grammar UE.dom.domUtils.setAttributes(node,attrs) => node + * @method setAttributes + * @param { DomElement } node 需要设置属性的元素对象 + * @param { KeyValueMap } attrs 需要设置的属性名-值对 + * @return { DomElement } 设置属性的元素对象 + * @example + * ```html + * + * + * + * */ setAttributes:function (node, attrs) { for (var attr in attrs) { @@ -859,12 +1371,26 @@ var domUtils = dom.domUtils = { }, /** - * 获取元素element的计算样式 - * @name getComputedStyle - * @grammar UE.dom.domUtils.getComputedStyle(element,styleName) => String //返回对应样式名称的样式值 + * 获取元素element经过计算后的样式值 + * @method getComputedStyle + * @param { DomElement } element 需要获取样式的元素对象 + * @param { String } styleName 需要获取的样式名 + * @return { String } 获取到的样式值 * @example - * getComputedStyle(document.body,"font-size") => "15px" - * getComputedStyle(form,"color") => "#ffccdd" + * ```html + * + * + * + * + * + * ``` */ getComputedStyle:function (element, styleName) { //一下的属性单独处理 @@ -900,16 +1426,45 @@ var domUtils = dom.domUtils = { return utils.transUnitToPx(utils.fixColor(styleName, value)); }, /** - * 在元素element上删除classNames,支持同时删除多个 - * @name removeClasses - * @grammar UE.dom.domUtils.removeClasses(element,classNames) + * 删除元素element指定的className + * @method removeClasses + * @param { DomElement } ele 需要删除class的元素节点 + * @param { String } classNames 需要删除的className, 多个className之间以空格分开 + * @example + * ```html + * xxx + * + * + * ``` + */ + + /** + * 删除元素element指定的className + * @method removeClasses + * @param { DomElement } ele 需要删除class的元素节点 + * @param { Array } classNames 需要删除的className数组 * @example - * //执行方法前的dom结构 - * xxx - * //执行方法 - * UE.dom.domUtils.removeClasses(element,["test1","test3"]) - * //执行方法后的dom结构 - * xxx + * ```html + * xxx + * + * + * ``` */ removeClasses:function (elm, classNames) { classNames = utils.isArray(classNames) ? classNames : @@ -924,11 +1479,49 @@ var domUtils = dom.domUtils = { domUtils.removeAttributes(elm,['class']); } }, + + /** + * 给元素element添加className + * @method addClass + * @param { DomNode } ele 需要增加className的元素 + * @param { String } classNames 需要添加的className, 多个className之间以空格分割 + * @remind 相同的类名不会被重复添加 + * @example + * ```html + * + * + * + * ``` + */ + /** - * 判断元素element是否包含样式类名className,支持以空格分开的多个类名,多个类名顺序不同也可以比较 - * @name hasClass - * @grammar UE.dom.domUtils.hasClass(element,className) =>true|false + * 判断元素element是否包含给定的样式类名className + * @method hasClass + * @param { DomNode } ele 需要检测的元素 + * @param { Array } classNames 需要检测的className数组 + * @return { Boolean } 元素是否包含所有给定的className + * @example + * ```html + * + * + * + * ``` */ hasClass:function (element, className) { if(utils.isRegExp(className)){ @@ -959,14 +1591,37 @@ var domUtils = dom.domUtils = { /** * 阻止事件默认行为 - * @param {Event} evt 需要组织的事件对象 + * @method preventDefault + * @param { Event } evt 需要阻止默认行为的事件对象 + * @example + * ```javascript + * UE.dom.domUtils.preventDefault( evt ); + * ``` */ preventDefault:function (evt) { evt.preventDefault ? evt.preventDefault() : (evt.returnValue = false); }, + /** - * 删除元素element的样式 - * @grammar UE.dom.domUtils.removeStyle(element,name) 删除的样式名称 + * 删除元素element指定的样式 + * @method removeStyle + * @param { DomElement } element 需要删除样式的元素 + * @param { String } styleName 需要删除的样式名 + * @example + * ```html + * + * + * + * ``` */ removeStyle:function (element, name) { if(browser.ie ){ @@ -988,19 +1643,60 @@ var domUtils = dom.domUtils = { domUtils.removeAttributes(element, ['style']); } }, + /** - * 获取元素element的某个样式值 - * @name getStyle - * @grammar UE.dom.domUtils.getStyle(element,name) => String + * 获取元素element的style属性的指定值 + * @method getStyle + * @param { DomElement } element 需要获取属性值的元素 + * @param { String } styleName 需要获取的style的名称 + * @warning 该方法仅获取元素style属性中所标明的值 + * @return { String } 该元素包含指定的style属性值 + * @example + * ```html + *
+ * + * + * ``` */ getStyle:function (element, name) { var value = element.style[ utils.cssStyleToDomStyle(name) ]; return utils.fixColor(name, value); }, + + /** * 为元素element设置样式属性值 - * @name setStyle - * @grammar UE.dom.domUtils.setStyle(element,name,value) + * @method setStyle + * @param { DomElement } element 需要设置样式的元素 + * @param { String } styleName 样式名 + * @param { String } styleValue 样式值 + * @example + * ```html + *
+ * + * + * ``` */ setStyle:function (element, name, value) { element.style[utils.cssStyleToDomStyle(name)] = value; @@ -1008,10 +1704,31 @@ var domUtils = dom.domUtils = { this.removeAttributes(element,'style') } }, + /** - * 为元素element设置样式属性值 - * @name setStyles - * @grammar UE.dom.domUtils.setStyle(element,styles) //styles为样式键值对 + * 为元素element设置多个样式属性值 + * @method setStyles + * @param { DomElement } element 需要设置样式的元素 + * @param { KeyValueMap } styles 样式名值对 + * @example + * ```html + *
+ * + * + * ``` */ setStyles:function (element, styles) { for (var name in styles) { @@ -1020,9 +1737,9 @@ var domUtils = dom.domUtils = { } } }, + /** * 删除_moz_dirty属性 - * @function */ removeDirtyAttr:function (node) { for (var i = 0, ci, nodes = node.getElementsByTagName('*'); ci = nodes[i++];) { @@ -1030,12 +1747,50 @@ var domUtils = dom.domUtils = { } node.removeAttribute('_moz_dirty'); }, + + /** + * 获取子节点的数量 + * @method getChildCount + * @param { DomElement } node 需要检测的元素 + * @return { Number } 给定的node元素的子节点数量 + * @example + * ```html + *
+ * + *
+ * + * + * ``` + */ + /** - * 返回子节点的数量 - * @function - * @param {Node} node 父节点 - * @param {Function} fn 过滤子节点的规则,若为空,则得到所有子节点的数量 - * @return {Number} 符合条件子节点的数量 + * 根据给定的过滤规则, 获取符合条件的子节点的数量 + * @method getChildCount + * @param { DomElement } node 需要检测的元素 + * @param { Function } fn 过滤器, 要求对符合条件的子节点返回true, 反之则要求返回false + * @return { Number } 符合过滤条件的node元素的子节点数量 + * @example + * ```html + *
+ * + *
+ * + * + * ``` */ getChildCount:function (node, fn) { var count = 0, first = node.firstChild; @@ -1052,20 +1807,31 @@ var domUtils = dom.domUtils = { }, /** - * 判断是否为空节点 - * @function - * @param {Node} node 节点 - * @return {Boolean} 是否为空节点 + * 判断给定节点是否为空节点 + * @method isEmptyNode + * @param { DomNode } node 需要检测的节点对象 + * @return { Boolean } 节点是否为空 + * @example + * ```javascript + * UE.dom.domUtils.isEmptyNode( document.body ); + * ``` */ isEmptyNode:function (node) { return !node.firstChild || domUtils.getChildCount(node, function (node) { return !domUtils.isBr(node) && !domUtils.isBookmarkNode(node) && !domUtils.isWhitespace(node) }) == 0 }, + /** - * 清空节点所有的className - * @function - * @param {Array} nodes 节点数组 + * 清空给定节点所有的className + * @method clearSelectedArr + * @param { Array } nodes 需要清空className的节点的数组集合 + * @example + * ```javascript + * + * UE.dom.domUtils.clearSelectedArr( [ document.body, document.body.firstChild ] ); + * + * ``` */ clearSelectedArr:function (nodes) { var node; @@ -1073,9 +1839,10 @@ var domUtils = dom.domUtils = { domUtils.removeAttributes(node, ['class']); } }, - /** - * 将显示区域滚动到显示节点的位置 - * @function + + /* + * 将显示区域滚动到指定节点的位置 + * @method scrollToView * @param {Node} node 节点 * @param {window} win window对象 * @param {Number} offsetTop 距离上方的偏移量 @@ -1114,17 +1881,28 @@ var domUtils = dom.domUtils = { win.scrollTo(0, offset + (offset < 0 ? -20 : 20)); } }, + /** - * 判断节点是否为br - * @function - * @param {Node} node 节点 + * 判断给定节点是否为br + * @method isBr + * @param { DomNode } node 需要判断的节点对象 + * @return { Boolean } 给定的节点是否是br节点 */ isBr:function (node) { return node.nodeType == 1 && node.tagName == 'BR'; }, + + /** + * 判断给定的节点是否是一个“填充”节点 + * @param { DomNode } node 需要判断的节点 + * @param { Boolean } isInStart 是否从节点内容的开始位置匹配 + * @returns { Boolean } 节点是否是填充节点 + */ isFillChar:function (node,isInStart) { return node.nodeType == 3 && !node.nodeValue.replace(new RegExp((isInStart ? '^' : '' ) + domUtils.fillChar), '').length }, + + isStartInblock:function (range) { var tmpRange = range.cloneRange(), flag = 0, @@ -1178,6 +1956,28 @@ var domUtils = dom.domUtils = { } return flag && !domUtils.isBody(tmpRange.startContainer) ? 1 : 0; }, + + /** + * 判断给定的元素是否是一个空元素 + * @param { DomElement } node 需要判断的元素 + * @return { Boolean } 是否是空元素 + * @example + * ```html + *
+ * + * + * ``` + */ + + /** + * 根据指定的判断规则判断给定的元素是否是一个空元素 + * @param { DomElement } node 需要判断的元素 + * @param { RegExp } reg 对内容执行判断的正则表达式对象 + * @return { Boolean } 是否是空元素 + */ isEmptyBlock:function (node,reg) { if(node.nodeType != 1) return 0; @@ -1193,6 +1993,32 @@ var domUtils = dom.domUtils = { return 1; }, + /** + * 移动元素使得该元素的位置移动指定的偏移量的距离 + * @method setViewportOffset + * @param { DomElement } element 需要设置偏移量的元素 + * @param { KeyValueMap } offset 偏移量, 形如{ left: 100, top: 50 }的一个键值对, 表示该元素将在 + * 现有的位置上向水平方向偏移offset.left的距离, 在竖直方向上偏移 + * offset.top的距离 + * @example + * ```html + *
+ * + * + * ``` + */ setViewportOffset:function (element, offset) { var left = parseInt(element.style.left) | 0; var top = parseInt(element.style.top) | 0; @@ -1206,11 +2032,98 @@ var domUtils = dom.domUtils = { element.style.top = top + offsetTop + 'px'; } }, + + /** + * 用“填充字符”填充节点 + * @method fillNode + * @param { DomDocument } doc 填充的节点所在的docment对象 + * @param { DomNode } node 需要填充的节点对象 + * @example + * ```html + *
+ * + * + * ``` + */ fillNode:function (doc, node) { var tmpNode = browser.ie ? doc.createTextNode(domUtils.fillChar) : doc.createElement('br'); node.innerHTML = ''; node.appendChild(tmpNode); }, + + /** + * 把节点src的所有子节点追加到另一个节点tag上去 + * @method moveChild + * @param { DomNode } src 源节点, 该节点下的所有子节点将被移除 + * @param { DomNode } tag 目标节点, 从源节点移除的子节点将被追加到该节点下 + * @example + * ```html + *
+ * + *
+ *
+ *
+ *
+ * + * + * ``` + */ + + /** + * 把节点src的所有子节点移动到另一个节点tag上去, 可以通过dir参数控制附加的行为是“追加”还是“插入顶部” + * @method moveChild + * @param { DomNode } src 源节点, 该节点下的所有子节点将被移除 + * @param { DomNode } tag 目标节点, 从源节点移除的子节点将被附加到该节点下 + * @param { Boolean } dir 附加方式, 如果为true, 则附加进去的节点将被放到目标节点的顶部, 反之,则放到末尾 + * @example + * ```html + *
+ * + *
+ *
+ *
+ *
+ * + * + * ``` + */ moveChild:function (src, tag, dir) { while (src.firstChild) { if (dir && tag.firstChild) { @@ -1220,27 +2133,129 @@ var domUtils = dom.domUtils = { } } }, - //判断是否有额外属性 + + /** + * 判断节点的标签上是否不存在任何属性 + * @method hasNoAttributes + * @param { DomNode } node 需要检测的节点对象 + * @return { Boolean } 节点是否不包含任何属性 + * @example + * ```html + *
xxxx
+ * + * + * ``` + */ hasNoAttributes:function (node) { return browser.ie ? /^<\w+\s*?>/.test(node.outerHTML) : node.attributes.length == 0; }, - //判断是否是编辑器自定义的参数 + + /** + * 检测节点是否是UEditor所使用的辅助节点 + * @method isCustomeNode + * @param { DomNode } node 需要检测的节点 + * @remind 辅助节点是指编辑器要完成工作临时添加的节点, 在输出的时候将会从编辑器内移除, 不会影响最终的结果。 + * @return { Boolean } 给定的节点是否是一个辅助节点 + */ isCustomeNode:function (node) { return node.nodeType == 1 && node.getAttribute('_ue_custom_node_'); }, + + /** + * 检测节点的标签是否是给定的标签 + * @method isTagNode + * @param { DomNode } node 需要检测的节点对象 + * @param { String } tagName 标签 + * @return { Boolean } 节点的标签是否是给定的标签 + * @example + * ```html + *
+ * + * + * ``` + */ isTagNode:function (node, tagName) { return node.nodeType == 1 && new RegExp('^' + node.tagName + '$','i').test(tagName) }, + + /** + * 给定一个节点数组,在通过指定的过滤器过滤后, 获取其中满足过滤条件的第一个节点 + * @method filterNodeList + * @param { Array } nodeList 需要过滤的节点数组 + * @param { Function } fn 过滤器, 对符合条件的节点, 执行结果返回true, 反之则返回false + * @return { DomNode | NULL } 如果找到符合过滤条件的节点, 则返回该节点, 否则返回NULL + * @example + * ```javascript + * var divNodes = document.getElementsByTagName("div"); + * divNodes = [].slice.call( divNodes, 0 ); + * + * //output: null + * console.log( UE.dom.domUtils.filterNodeList( divNodes, function ( node ) { + * return node.tagName.toLowerCase() !== 'div'; + * } ) ); + * ``` + */ + + /** + * 给定一个节点数组nodeList和一组标签名tagNames, 获取其中能够匹配标签名的节点集合中的第一个节点 + * @method filterNodeList + * @param { Array } nodeList 需要过滤的节点数组 + * @param { String } tagNames 需要匹配的标签名, 多个标签名之间用空格分割 + * @return { DomNode | NULL } 如果找到标签名匹配的节点, 则返回该节点, 否则返回NULL + * @example + * ```javascript + * var divNodes = document.getElementsByTagName("div"); + * divNodes = [].slice.call( divNodes, 0 ); + * + * //output: null + * console.log( UE.dom.domUtils.filterNodeList( divNodes, 'a span' ) ); + * ``` + */ + /** - * 对于nodelist用filter进行过滤 - * @name filterNodeList - * @since 1.2.4+ - * @grammar UE.dom.domUtils.filterNodeList(nodelist,filter,onlyFirst) => 节点 + * 给定一个节点数组,在通过指定的过滤器过滤后, 如果参数forAll为true, 则会返回所有满足过滤 + * 条件的节点集合, 否则, 返回满足条件的节点集合中的第一个节点 + * @method filterNodeList + * @param { Array } nodeList 需要过滤的节点数组 + * @param { Function } fn 过滤器, 对符合条件的节点, 执行结果返回true, 反之则返回false + * @param { Boolean } forAll 是否返回整个节点数组, 如果该参数为false, 则返回节点集合中的第一个节点 + * @return { Array | DomNode | NULL } 如果找到符合过滤条件的节点, 则根据参数forAll的值决定返回满足 + * 过滤条件的节点数组或第一个节点, 否则返回NULL * @example - * UE.dom.domUtils.filterNodeList(document.getElementsByTagName('*'),'div p') //返回第一个是div或者p的节点 - * UE.dom.domUtils.filterNodeList(document.getElementsByTagName('*'),function(n){return n.getAttribute('src')}) - * //返回第一个带src属性的节点 - * UE.dom.domUtils.filterNodeList(document.getElementsByTagName('*'),'i',true) //返回数组,里边都是i节点 + * ```javascript + * var divNodes = document.getElementsByTagName("div"); + * divNodes = [].slice.call( divNodes, 0 ); + * + * //output: 3(假定有3个div) + * console.log( divNodes.length ); + * + * var nodes = UE.dom.domUtils.filterNodeList( divNodes, function ( node ) { + * return node.tagName.toLowerCase() === 'div'; + * }, true ); + * + * //output: 3 + * console.log( nodes.length ); + * + * var node = UE.dom.domUtils.filterNodeList( divNodes, function ( node ) { + * return node.tagName.toLowerCase() === 'div'; + * }, false ); + * + * //output: div + * console.log( node.nodeName ); + * ``` */ filterNodeList : function(nodelist,filter,forAll){ var results = []; From 8b09e01fcc916a15f0d4533839b2e086243350d8 Mon Sep 17 00:00:00 2001 From: hancong03 <121371790@qq.com> Date: Mon, 26 Aug 2013 13:46:24 +0800 Subject: [PATCH 05/81] =?UTF-8?q?=E6=B3=A8=E9=87=8A=E5=AE=8C=E5=96=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- _src/core/Editor.js | 744 +++++++++++++++++++++++++++++++---------- _src/core/EventBase.js | 102 ++++-- 2 files changed, 645 insertions(+), 201 deletions(-) diff --git a/_src/core/Editor.js b/_src/core/Editor.js index 2cc367d7e..087546235 100644 --- a/_src/core/Editor.js +++ b/_src/core/Editor.js @@ -1,18 +1,33 @@ /** + * 编辑器主类,包含编辑器提供的大部分公用接口 * @file - * @name UE.Editor - * @short Editor - * @import editor.js,core/utils.js,core/EventBase.js,core/browser.js,core/dom/dtd.js,core/dom/domUtils.js,core/dom/Range.js,core/dom/Selection.js,plugins/serialize.js - * @desc 编辑器主类,包含编辑器提供的大部分公用接口 + * @module UE + * @class Editor + * @since 1.2.6.1 */ + +/** + * UEditor公用空间,UEditor所有的功能都挂载在该空间下 + * @unfile + * @module UE + */ + +/** + * UEditor的核心类,为用户提供与编辑器交互的接口。 + * @unfile + * @module UE + * @class Editor + */ + (function () { var uid = 0, _selectionChangeTimer; + /** + * 获取编辑器的html内容,赋值到编辑器所在表单的textarea文本域里面 * @private - * @ignore - * @param form 编辑器所在的form元素 - * @param editor 编辑器实例对象 + * @method setValue + * @param { Editor } editor 编辑器事例 */ function setValue(form, editor) { var textarea; @@ -41,7 +56,14 @@ (editor.options.allHtmlEnabled ? editor.getAllHtml() : editor.getContent(null, null, true)) : '' } - function loadPlugins(me){ + + /** + * 初始化插件 + * @private + * @method loadPlugins + * @param { Editor } editor 编辑器事例 + */ + function loadPlugins(me) { //初始化插件 for (var pi in UE.plugins) { UE.plugins[pi].call(me); @@ -50,21 +72,67 @@ me.fireEvent("langReady"); } - function checkCurLang(I18N){ - for(var lang in I18N){ + + /** + * 获取语言包里面的第一个 + * @private + * @method checkCurLang + * @param { PlainObject } I18N 编辑器事例 + */ + function checkCurLang(I18N) { + for (var lang in I18N) { return lang } } + + + /** + * 编辑器准备就绪后会触发该事件 + * @module UE + * @class Editor + * @event ready + * @example + * ```javascript + * editor.addListener( 'ready', function( editor ) { + * editor.execCommand( 'focus' ); + * } ); + * ``` + */ + /** - * UEditor编辑器类 - * @name Editor - * @desc 创建一个跟编辑器实例 - * - ***container*** 编辑器容器对象 - * - ***iframe*** 编辑区域所在的iframe对象 - * - ***window*** 编辑区域所在的window - * - ***document*** 编辑区域所在的document对象 - * - ***body*** 编辑区域所在的body对象 - * - ***selection*** 编辑区域的选区对象 + * 每当编辑器内部选区发生改变后, 将触发该事件 + * @event selectionchange + * @warning 该事件的触发非常频繁,不建议在该事件的处理过程中做重量级的处理 + * @example + * ```javascript + * editor.addListener( 'selectionchange', function( editor ) { + * + * editor.execCommand( 'bold' ); + * + * } + */ + + /** + * 以默认参数构建一个编辑器实例 + * @constructor + * @example + * ```javascript + * var editor = new UE.Editor(); + * editor.execCommand('blod'); + * ``` + * @see UE.Config + */ + + /** + * 以给定的参数集合创建一个编辑器对象,对于未指定的参数,将应用默认参数。 + * @constructor + * @param { PlainObject } setting 创建编辑器的参数 + * @example + * ```javascript + * var editor = new UE.Editor(); + * editor.execCommand('blod'); + * ``` + * @see UE.Config */ var Editor = UE.Editor = function (options) { var me = this; @@ -79,7 +147,7 @@ me.setOpt({ isShow: true, initialContent: '', - initialStyle:'', + initialStyle: '', autoClearinitialContent: false, iframeCssUrl: me.options.UEDITOR_HOME_URL + 'themes/iframe.css', textarea: 'editorValue', @@ -99,14 +167,14 @@ allHtmlEnabled: false, scaleEnabled: false, tableNativeEditInFF: false, - autoSyncData : true + autoSyncData: true }); - if(!utils.isEmptyObject(UE.I18N)){ + if (!utils.isEmptyObject(UE.I18N)) { //修改默认的语言类型 me.options.lang = checkCurLang(UE.I18N); loadPlugins(me) - }else{ + } else { utils.loadFile(document, { src: me.options.langPath + me.options.lang + "/" + me.options.lang + ".js", tag: "script", @@ -120,17 +188,22 @@ UE.instants['ueditorInstant' + me.uid] = me; }; Editor.prototype = { + + /** - * 当编辑器ready后执行传入的fn,如果编辑器已经完成ready,就马上执行fn,fn的中的this是编辑器实例。 - * 大部分的实例接口都需要放在该方法内部执行,否则在IE下可能会报错。 - * @name ready - * @grammar editor.ready(fn) fn是当编辑器渲染好后执行的function + * 编辑器对外提供的监听ready事件的接口, 通过调用该方法,达到的效果与监听ready事件是一致的 + * @method ready + * @param { Function } fn 编辑器ready之后所执行的回调, 如果在注册事件之前编辑器已经ready,将会 + * 立即触发该回调。 + * @see UE.Editor.event:ready * @example - * var editor = new UE.ui.Editor(); - * editor.render("myEditor"); - * editor.ready(function(){ - * editor.setContent("欢迎使用UEditor!"); - * }) + * ```javascript + * editor.ready( function( editor ) { + * + * editor.setContent('初始化完毕'); + * + * } ); + * ``` */ ready: function (fn) { var me = this; @@ -138,10 +211,31 @@ me.isReady ? fn.apply(me) : me.addListener('ready', fn); } }, + + + /** + * 以attributeName - attributeValue的方式设置编辑器的配置项,以覆盖编辑器的默认选项值 + * @method setOpt + * @warning 该方法仅供编辑器构造函数调用,其他任何方法不能调用。 + * @param { String } key 编辑器的可接受的选项名称 + * @param { * } val 该选项可接受的值 + * @example + * ```javascript + * editor.setOpt( 'initContent', '欢迎使用编辑器' ); + * ``` + */ + /** - * 为编辑器设置默认参数值。若用户配置为空,则以默认配置为准 - * @grammar editor.setOpt(key,value); //传入一个键、值对 - * @grammar editor.setOpt({ key:value}); //传入一个json对象 + * 以key-value集合的方式设置编辑器的配置项,以覆盖编辑器的默认选项值 + * @method setOpt + * @warning 该方法仅供编辑器构造函数调用,其他任何方法不能调用。 + * @param { PlainObject } settings 编辑器的可接受的选项的key-value集合 + * @example + * ```javascript + * editor.setOpt( { + * 'initContent': '欢迎使用编辑器' + * } ); + * ``` */ setOpt: function (key, val) { var obj = {}; @@ -152,10 +246,15 @@ } utils.extend(this.options, obj, true); }, + + /** * 销毁编辑器实例对象 - * @name destroy - * @grammar editor.destroy(); + * @method destroy + * @example + * ```javascript + * editor.destroy(); + * ``` */ destroy: function () { @@ -185,83 +284,92 @@ } UE.delEditor(key); }, + /** - * 渲染编辑器的DOM到指定容器,必须且只能调用一次 - * @name render - * @grammar editor.render(containerId); //可以指定一个容器ID - * @grammar editor.render(containerDom); //也可以直接指定容器对象 + * 渲染编辑器的DOM到指定容器 + * @method render + * @param { String } containerId 指定一个容器ID + * @warning 必须且只能调用一次 + */ + + /** + * 渲染编辑器的DOM到指定容器 + * @method render + * @param { Element } containerDom 直接指定容器对象 + * @warning 必须且只能调用一次 */ render: function (container) { var me = this, options = me.options, - getStyleValue=function(attr){ - return parseInt(domUtils.getComputedStyle(container,attr)); + getStyleValue = function (attr) { + return parseInt(domUtils.getComputedStyle(container, attr)); }; if (utils.isString(container)) { container = document.getElementById(container); } if (container) { - if(options.initialFrameWidth){ + if (options.initialFrameWidth) { options.minFrameWidth = options.initialFrameWidth - }else{ + } else { options.minFrameWidth = options.initialFrameWidth = container.offsetWidth; } - if(options.initialFrameHeight){ + if (options.initialFrameHeight) { options.minFrameHeight = options.initialFrameHeight - }else{ + } else { options.initialFrameHeight = options.minFrameHeight = container.offsetHeight; } - container.style.width = /%$/.test(options.initialFrameWidth) ? '100%' : options.initialFrameWidth- - getStyleValue("padding-left")- getStyleValue("padding-right") +'px'; - container.style.height = /%$/.test(options.initialFrameHeight) ? '100%' : options.initialFrameHeight - - getStyleValue("padding-top")- getStyleValue("padding-bottom") +'px'; + container.style.width = /%$/.test(options.initialFrameWidth) ? '100%' : options.initialFrameWidth - + getStyleValue("padding-left") - getStyleValue("padding-right") + 'px'; + container.style.height = /%$/.test(options.initialFrameHeight) ? '100%' : options.initialFrameHeight - + getStyleValue("padding-top") - getStyleValue("padding-bottom") + 'px'; container.style.zIndex = options.zIndex; - var html = ( ie && browser.version < 9 ? '' : '') + - '' + - '' + - ( options.iframeCssUrl ? '' : '' ) + - (options.initialStyle ? '' : '') + - '' + - ''; + var html = ( ie && browser.version < 9 ? '' : '') + + '' + + '' + + ( options.iframeCssUrl ? '' : '' ) + + (options.initialStyle ? '' : '') + + '' + + ''; container.appendChild(domUtils.createElement(document, 'iframe', { id: 'ueditor_' + me.uid, width: "100%", height: "100%", frameborder: "0", - src: 'javascript:void(function(){document.open();' + (options.customDomain && document.domain != location.hostname ? 'document.domain="' + document.domain + '";' : '') + + src: 'javascript:void(function(){document.open();' + (options.customDomain && document.domain != location.hostname ? 'document.domain="' + document.domain + '";' : '') + 'document.write("' + html + '");document.close();}())' })); container.style.overflow = 'hidden'; //解决如果是给定的百分比,会导致高度算不对的问题 - setTimeout(function(){ - if( /%$/.test(options.initialFrameWidth)){ + setTimeout(function () { + if (/%$/.test(options.initialFrameWidth)) { options.minFrameWidth = options.initialFrameWidth = container.offsetWidth; container.style.width = options.initialFrameWidth + 'px'; } - if(/%$/.test(options.initialFrameHeight)){ + if (/%$/.test(options.initialFrameHeight)) { options.minFrameHeight = options.initialFrameHeight = container.offsetHeight; container.style.height = options.initialFrameHeight + 'px'; } }) } }, + /** * 编辑器初始化 + * @method _setup * @private - * @ignore - * @param {Element} doc 编辑器Iframe中的文档对象 + * @param { Element } doc 编辑器Iframe中的文档对象 */ _setup: function (doc) { @@ -291,11 +399,11 @@ for (var form = this.iframe.parentNode; !domUtils.isBody(form); form = form.parentNode) { if (form.tagName == 'FORM') { me.form = form; - if(me.options.autoSyncData){ - domUtils.on(me.window,'blur',function(){ - setValue(form,me); + if (me.options.autoSyncData) { + domUtils.on(me.window, 'blur', function () { + setValue(form, me); }); - }else{ + } else { domUtils.on(form, 'submit', function () { setValue(this, me); }); @@ -388,17 +496,25 @@ !options.isShow && me.setHide(); options.readonly && me.setDisabled(); }, + /** - * 同步编辑器的数据,为提交数据做准备,主要用于你是手动提交的情况 - * @name sync - * @grammar editor.sync(); //从编辑器的容器向上查找,如果找到就同步数据 - * @grammar editor.sync(formID); //formID制定一个要同步数据的form的id,编辑器的数据会同步到你指定form下 - * @desc - * 后台取得数据得键值使用你容器上得''name''属性,如果没有就使用参数传入的''textarea'' + * 同步编辑器的数据,为提交数据做准备,主要用于是手动提交的情况 + * 后台取得数据的键值使用你容器上的name属性,如果没有就使用参数传入的textarea属性 + * 获取要同步的表单,从编辑器的容器向上查找要同步数据的form,如果找到就同步数据 + * @method sync * @example + * ```javascript * editor.sync(); * form.sumbit(); //form变量已经指向了form元素 - * + * ``` + */ + + /** + * 同步编辑器的数据,为提交数据做准备,主要用于是手动提交的情况 + * 后台取得数据的键值使用你容器上的name属性,如果没有就使用参数传入的textarea属性 + * 根据传入表单id参数,获取要同步数据的form + * @method sync + * @param { String } formID 指定一个要同步数据的form的id,编辑器的数据会同步到你指定form下 */ sync: function (formId) { var me = this, @@ -408,12 +524,17 @@ }, true); form && setValue(form, me); }, + /** * 设置编辑器高度 - * @name setHeight - * @grammar editor.setHeight(number); //纯数值,不带单位 + * @method setHeight + * @param { Number } number 设置的高度值,纯数值,不带单位 + * @example + * ```javascript + * editor.setHeight(number); + * ``` */ - setHeight: function (height,notSetHeight) { + setHeight: function (height, notSetHeight) { if (height !== parseInt(this.iframe.parentNode.style.height)) { this.iframe.parentNode.style.height = height + 'px'; } @@ -422,6 +543,28 @@ this.body.style.height = height + 'px'; }, + /** + * 添加命令的快捷键 + * @method addshortcutkey + * @param { PlainObject } keyset 命令和快捷键的键值对对象,多个按钮的快捷键用“+”分隔 + * @example + * ```javascript + * editor.addshortcutkey({ + * "Bold" : "ctrl+66",//^B + * "Italic" : "ctrl+73", //^I + * }); + * ``` + */ + /** + * 添加命令的快捷键 + * @method addshortcutkey + * @param { String } cmd 触发快捷键时,响应的命令 + * @param { String } keys 快捷键的字符串,多个按钮用“+”分隔 + * @example + * ```javascript + * editor.addshortcutkey("Underline", "ctrl+85"); //^U + * ``` + */ addshortcutkey: function (cmd, keys) { var obj = {}; if (keys) { @@ -431,6 +574,12 @@ } utils.extend(this.shortcutkeys, obj) }, + + /** + * 对编辑器设置keydown事件监听,绑定快捷键和命令,当快捷键组合触发成功,会响应对应的命令 + * @method _bindshortcutKeys + * @private + */ _bindshortcutKeys: function () { var me = this, shortcutkeys = this.shortcutkeys; me.addListener('keydown', function (type, e) { @@ -447,7 +596,7 @@ ) || keyCode == RegExp.$1 ) { - if (me.queryCommandState(i,param) != -1) + if (me.queryCommandState(i, param) != -1) me.execCommand(i, param); domUtils.preventDefault(e); } @@ -457,19 +606,38 @@ } }); }, + + + /** + * 获取编辑器的内容 + * @method getContent + * @warning 该方法获取到的是经过编辑器内置的过滤规则进行过滤后得到的内容 + * @return { String } 编辑器的内容字符串, 如果编辑器的内容为空, 则返回空字符串 + * @example + * ```javascript + * var content = editor.getContent(); + * ``` + */ + /** - * 获取编辑器内容 - * @name getContent - * @grammar editor.getContent() => String //若编辑器中只包含字符"<p><br /></p/>"会返回空。 - * @grammar editor.getContent(fn) => String + * 获取编辑器的内容。 可以通过参数定义编辑器内置的判空规则 + * @method getContent + * @param { Function } fn 自定的判空规则, 要求该方法返回一个boolean类型的值, + * 代表当前编辑器的内容是否空, + * 如果返回true, 则该方法将直接返回空字符串;如果返回false,则编辑器将返回 + * 经过内置过滤规则处理后的内容。 + * @remind 该方法在处理包含有初始化内容的时候能起到很好的作用。 + * @warning 该方法获取到的是经过编辑器内置的过滤规则进行过滤后得到的内容 + * @return { String } 编辑器的内容字符串 * @example - * getContent默认是会现调用hasContents来判断编辑器是否为空,如果是,就直接返回空字符串 - * 你也可以传入一个fn来接替hasContents的工作,定制判断的规则 - * editor.getContent(function(){ - * return false //编辑器没有内容 ,getContent直接返回空 - * }) + * ```javascript + * // editor 是一个编辑器的实例 + * var content = editor.getContent( function ( editor ) { + * return editor.body.innerHTML === '欢迎使用UEditor'; + * } ); + * ``` */ - getContent: function (cmd, fn,notSetCursor,ignoreBlank,formatter) { + getContent: function (cmd, fn, notSetCursor, ignoreBlank, formatter) { var me = this; if (cmd && utils.isFunction(cmd)) { fn = cmd; @@ -479,15 +647,20 @@ return ''; } me.fireEvent('beforegetcontent'); - var root = UE.htmlparser(me.body.innerHTML,ignoreBlank); + var root = UE.htmlparser(me.body.innerHTML, ignoreBlank); me.filterOutputRule(root); me.fireEvent('aftergetcontent', cmd); return root.toHtml(formatter); }, + /** * 取得完整的html代码,可以直接显示成完整的html文档 - * @name getAllHtml - * @grammar editor.getAllHtml() => String + * @method getAllHtml + * @return { String } 编辑器的内容html文档字符串 + * @eaxmple + * ```javascript + * editor.getAllHtml(); + * ``` */ getAllHtml: function () { var me = this, @@ -508,10 +681,15 @@ + (headHtmlForIE9 || me.document.getElementsByTagName('head')[0].innerHTML) + headHtml.join('\n') + '' + '' + me.getContent(null, null, true) + ''; }, + /** * 得到编辑器的纯文本内容,但会保留段落格式 - * @name getPlainTxt - * @grammar editor.getPlainTxt() => String + * @method getPlainTxt + * @return { String } 编辑器带段落格式的纯文本内容字符串 + * @example + * ```javascript + * editor.getPlainTxt(); + * ``` */ getPlainTxt: function () { var reg = new RegExp(domUtils.fillChar, 'g'), @@ -528,8 +706,12 @@ /** * 获取编辑器中的纯文本内容,没有段落格式 - * @name getContentTxt - * @grammar editor.getContentTxt() => String + * @method getContentTxt + * @return { String } 编辑器不带段落格式的纯文本内容字符串 + * @example + * ```javascript + * editor.getContentTxt(); + * ``` */ getContentTxt: function () { var reg = new RegExp(domUtils.fillChar, 'g'); @@ -538,15 +720,35 @@ }, /** - * 将html设置到编辑器中, 如果是用于初始化时给编辑器赋初值,则必须放在ready方法内部执行 - * @name setContent - * @grammar editor.setContent(html) + * 获取编辑器的内容 + * @method getContent + * @warning 该方法获取到的是经过编辑器内置的过滤规则进行过滤后得到的内容 + * @return { String } 编辑器的内容字符串, 如果编辑器的内容为空, 则返回空字符串 + * @example + * ```javascript + * var content = editor.getContent(); + * ``` + */ + + /** + * 获取编辑器的内容。 可以通过参数定义编辑器内置的判空规则 + * @method getContent + * @param { Function } fn 自定的判空规则, 要求该方法返回一个boolean类型的值, + * 代表当前编辑器的内容是否空, + * 如果返回true, 则该方法将直接返回空字符串;如果返回false,则编辑器将返回 + * 经过内置过滤规则处理后的内容。 + * @remind 该方法在处理包含有初始化内容的时候能起到很好的作用。 + * @warning 该方法获取到的是经过编辑器内置的过滤规则进行过滤后得到的内容 + * @return { String } 编辑器的内容字符串 * @example - * var editor = new UE.ui.Editor() - * editor.ready(function(){ - * //需要ready后执行,否则可能报错 - * editor.setContent("欢迎使用UEditor!"); - * }) + * ```javascript + * // editor 是一个编辑器的实例 + * var content = editor.getContent( function ( editor ) { + * + * return editor.body.innerHTML === '欢迎使用UEditor'; + * + * } ); + * ``` */ setContent: function (html, isAppendTo, notFireSelectionchange) { var me = this; @@ -560,9 +762,10 @@ me.body.innerHTML = (isAppendTo ? me.body.innerHTML : '') + html; - function isCdataDiv(node){ + function isCdataDiv(node) { return node.tagName == 'DIV' && node.getAttribute('cdata_tag'); } + //给文本或者inline节点套p标签 if (me.options.enterTag == 'p') { @@ -606,15 +809,28 @@ if (browser.gecko && (geckoSel = this.selection.getNative())) { geckoSel.removeAllRanges(); } - if(me.options.autoSyncData){ - me.form && setValue(me.form,me); + if (me.options.autoSyncData) { + me.form && setValue(me.form, me); } }, + /** + * 让编辑器获得焦点,默认focus到编辑器头部 + * @method focus + * @example + * ```javascript + * editor.focus() + * ``` + */ + /** * 让编辑器获得焦点,toEnd确定focus位置 - * @name focus - * @grammar editor.focus([toEnd]) //默认focus到编辑器头部,toEnd为true时focus到内容尾部 + * @method focus + * @param { Boolean } toEnd 默认focus到编辑器头部,toEnd为true时focus到内容尾部 + * @example + * ```javascript + * editor.focus(true) + * ``` */ focus: function (toEnd) { try { @@ -632,8 +848,8 @@ /** * 初始化UE事件及部分事件代理 + * @method _initEvents * @private - * @ignore */ _initEvents: function () { var me = this, @@ -692,18 +908,21 @@ // } // }()); }, + /** * 触发事件代理 + * @method _proxyDomEvent * @private - * @ignore + * @return { * } fireEvent的返回值 + * @see UE.EventBase:fireEvent(String) */ _proxyDomEvent: function (evt) { return this.fireEvent(evt.type.replace(/^on/, ''), evt); }, /** * 变化选区 + * @method _selectionChange * @private - * @ignore */ _selectionChange: function (delay, evt) { var me = this; @@ -759,6 +978,15 @@ } }, delay || 50); }, + + /** + * 执行编辑命令 + * @method _callCmdFn + * @private + * @param { String } fnName 函数名称 + * @param { * } args 传给命令函数的参数 + * @return { * } 返回命令函数运行的返回值 + */ _callCmdFn: function (fnName, args) { var cmdName = args[0].toLowerCase(), cmd, cmdFn; @@ -774,8 +1002,12 @@ /** * 执行编辑命令cmdName,完成富文本编辑效果 - * @name execCommand - * @grammar editor.execCommand(cmdName) => {*} + * @method execCommand + * @return { * } 返回命令函数运行的返回值 + * @example + * ```javascript + * editor.execCommand(cmdName); + * ``` */ execCommand: function (cmdName) { cmdName = cmdName.toLowerCase(); @@ -787,7 +1019,7 @@ } if (!cmd.notNeedUndo && !me.__hasEnterExecCommand) { me.__hasEnterExecCommand = true; - if (me.queryCommandState.apply(me,arguments) != -1) { + if (me.queryCommandState.apply(me, arguments) != -1) { me.fireEvent('beforeexeccommand', cmdName); result = this._callCmdFn('execCommand', arguments); !me._ignoreContentChange && me.fireEvent('contentchange'); @@ -801,14 +1033,18 @@ !me._ignoreContentChange && me._selectionChange(); return result; }, + /** * 根据传入的command命令,查选编辑器当前的选区,返回命令的状态 - * @name queryCommandState - * @grammar editor.queryCommandState(cmdName) => (-1|0|1) - * @desc - * * ''-1'' 当前命令不可用 - * * ''0'' 当前命令可用 - * * ''1'' 当前命令已经执行过了 + * @method queryCommandState + * @return { Number } number 返回放前命令的状态 + * 返回 -1 当前命令不可用 + * 返回 0 当前命令可用 + * 返回 1 当前命令已经执行过了 + * @example + * ```javascript + * editor.queryCommandState(cmdName) => (-1|0|1) + * ``` */ queryCommandState: function (cmdName) { return this._callCmdFn('queryCommandState', arguments); @@ -816,22 +1052,35 @@ /** * 根据传入的command命令,查选编辑器当前的选区,根据命令返回相关的值 - * @name queryCommandValue + * @method queryCommandValue + * @remind 只有部分插件有此方法 + * @return { * } 返回每个命令特定的当前状态值 * @grammar editor.queryCommandValue(cmdName) => {*} */ queryCommandValue: function (cmdName) { return this._callCmdFn('queryCommandValue', arguments); }, + /** - * 检查编辑区域中是否有内容,若包含tags中的节点类型,直接返回true - * @name hasContents - * @desc - * 默认有文本内容,或者有以下节点都不认为是空 + * 检查编辑区域中是否有内容 + * @method hasContents + * @remind 默认有文本内容,或者有以下节点都不认为是空 * {table:1,ul:1,ol:1,dl:1,iframe:1,area:1,base:1,col:1,hr:1,img:1,embed:1,input:1,link:1,meta:1,param:1} - * @grammar editor.hasContents() => (true|false) - * @grammar editor.hasContents(tags) => (true|false) //若文档中包含tags数组里对应的tag,直接返回true + * @return { Boolean } 检查有内容返回true,否则返回false + * @example + * ```javascript + * editor.hasContents() + * ``` + */ + + /** + * 检查编辑区域中是否有内容,若包含参数tags中的节点类型,直接返回true + * @method hasContents + * @return { Boolean } 若文档中包含tags数组里对应的tag,返回true,否则返回false * @example - * editor.hasContents(['span']) //如果编辑器里有这些,不认为是空 + * ```javascript + * editor.hasContents(['span']); + * ``` */ hasContents: function (tags) { if (tags) { @@ -856,17 +1105,28 @@ } return false; }, + /** * 重置编辑器,可用来做多个tab使用同一个编辑器实例 - * @name reset - * @desc - * * 清空编辑器内容 - * * 清空回退列表 - * @grammar editor.reset() + * @method reset + * @remind 此方法会清空编辑器内容,清空回退列表 + * @example + * ```javascript + * editor.reset() + * ``` */ reset: function () { this.fireEvent('reset'); }, + + /** + * 设置当前编辑区域可以编辑 + * @method setEnabled + * @example + * ```javascript + * editor.setEnabled() + * ``` + */ setEnabled: function () { var me = this, range; if (me.body.contentEditable == 'false') { @@ -887,14 +1147,44 @@ me.fireEvent('selectionchange'); } }, + /** * 设置当前编辑区域可以编辑 - * @name enable - * @grammar editor.enable() + * @method enable + * @return { * } 返回setEnabled方法的返回值 + * @example + * ```javascript + * editor.enable() + * ``` + * @see UE.Editor:setEnabled() */ enable: function () { return this.setEnabled(); }, + + /** 设置当前编辑区域不可编辑 + * @method setDisabled + */ + + /** 设置当前编辑区域不可编辑,except中的命令除外 + * @method setDisabled + * @param { String } except 例外命令的字符串 + * @remind 即使设置了disable,此处配置的例外命令仍然可以执行 + * @example + * ```javascript + * editor.setDisabled('bold'); //禁用工具栏中除加粗之外的所有功能 + * ``` + */ + + /** 设置当前编辑区域不可编辑,except中的命令除外 + * @method setDisabled + * @param { Array } except 字符串数组,数组中的命令仍然可以执行 + * @remind 即使设置了disable,此处配置的例外命令仍然可以执行 + * @example + * ```javascript + * editor.setDisabled(['bold','insertimage']); //禁用工具栏中除加粗和插入图片之外的所有功能 + * ``` + */ setDisabled: function (except) { var me = this; except = except ? utils.isArray(except) ? except : [except] : []; @@ -913,22 +1203,42 @@ me.fireEvent('selectionchange'); } }, + + /** 设置当前编辑区域不可编辑 + * @method disable + * @see UE.Editor:setEnabled() + */ + /** 设置当前编辑区域不可编辑,except中的命令除外 - * @name disable - * @grammar editor.disable() - * @grammar editor.disable(except) //例外的命令,也即即使设置了disable,此处配置的命令仍然可以执行 + * @method disable + * @param { String } except 例外命令的字符串 + * @remind 即使设置了disable,此处配置的例外命令仍然可以执行 * @example - * //禁用工具栏中除加粗和插入图片之外的所有功能 - * editor.disable(['bold','insertimage']);//可以是单一的String,也可以是Array + * ```javascript + * editor.disable('bold'); //禁用工具栏中除加粗之外的所有功能 + * ``` + * @see UE.Editor:setEnabled(String) + */ + + /** 设置当前编辑区域不可编辑,except中的命令除外 + * @method disable + * @param { Array } except 字符串数组,数组中的命令仍然可以执行 + * @remind 即使设置了disable,此处配置的例外命令仍然可以执行 + * @example + * ```javascript + * editor.disable(['bold','insertimage']); //禁用工具栏中除加粗和插入图片之外的所有功能 + * ``` + * @see UE.Editor:setEnabled(Array) */ disable: function (except) { return this.setDisabled(except); }, + /** * 设置默认内容 - * @ignore + * @method _setDefaultContent * @private - * @param {String} cont 要存入的内容 + * @param { String } cont 要存入的内容 */ _setDefaultContent: function () { function clear() { @@ -950,10 +1260,12 @@ me.addListener('firstBeforeExecCommand focus', clear); } }(), + /** - * show方法的兼容版本 + * 显示编辑器,show方法的兼容版本 + * @method setShow * @private - * @ignore + * @param { String } cont 要存入的内容 */ setShow: function () { var me = this, range = me.selection.getRange(); @@ -971,20 +1283,26 @@ }, 100); me.container.style.display = ''; } - }, + /** * 显示编辑器 - * @name show - * @grammar editor.show() + * @method show + * @param { String } cont 要存入的内容 + * @example + * ```javascript + * editor.show() + * ``` + * @see UE.Editor:setShow(String) */ show: function () { return this.setShow(); }, + /** - * hide方法的兼容版本 + * 隐藏编辑器,hide方法的兼容版本 + * @method setHide * @private - * @ignore */ setHide: function () { var me = this; @@ -993,20 +1311,29 @@ } me.container.style.display = 'none' }, + /** * 隐藏编辑器 - * @name hide - * @grammar editor.hide() + * @method hide + * @example + * ```javascript + * editor.hide() + * ``` + * @see UE.Editor:setHide() */ hide: function () { return this.setHide(); }, + /** - * 根据制定的路径,获取对应的语言资源 - * @name getLang - * @grammar editor.getLang(path) => (JSON|String) 路径根据的是lang目录下的语言文件的路径结构 + * 根据指定的路径,获取对应的语言资源 + * @method getLang + * @param { String } path 路径根据的是lang目录下的语言文件的路径结构 + * @return { PlainObject | String } 根据路径返回语言资源的Json格式对象或者语言字符串 * @example - * editor.getLang('contextMenu.delete') //如果当前是中文,那返回是的是删除 + * ```javascript + * editor.getLang('contextMenu.delete'); //如果当前是中文,那返回是的是'删除' + * ``` */ getLang: function (path) { var lang = UE.I18N[this.options.lang]; @@ -1020,15 +1347,41 @@ } return lang; }, + + /** + * 计算编辑器当前html内容的长度 + * @method getContentLength + * @return { Number } 返回计算的长度 + * @example + * ```javascript + * editor.getContentLength() + * ``` + */ + + /** + * 计算编辑器当前存文本内容的长度 + * @method getContentLength + * @param { Boolean } ingoneHtml + * @return { Number } 返回计算的长度,内容中有hr/img/iframe标签,长度加1 + * @example + * ```javascript + * editor.getContentLength(true) + * ``` + */ + /** * 计算编辑器当前内容的长度 - * @name getContentLength - * @grammar editor.getContentLength(ingoneHtml,tagNames) => + * @method getContentLength + * @param { Boolean } ingoneHtml + * @param { Array } tagNames + * @return { Number } 返回计算的长度,内容中有hr/img/iframe标签或者参数tagNames中的标签,长度加1 * @example - * editor.getLang(true) + * ```javascript + * editor.getContentLength(true, ['em','strong']) + * ``` */ getContentLength: function (ingoneHtml, tagNames) { - var count = this.getContent(false,false,true).length; + var count = this.getContent(false, false, true).length; if (ingoneHtml) { tagNames = (tagNames || []).concat([ 'hr', 'img', 'iframe']); count = this.getContentTxt().replace(/[\t\r\n]+/g, '').length; @@ -1038,31 +1391,66 @@ } return count; }, + + /** + * 添加输入过滤规则 + * @method addInputRule + * @param { Function } rule 要添加的过滤规则 + * @example + * ```javascript + * editor.addOutputRule(function(root){ + * $.each(root.getNodesByTagName('p'),function(i,node){ + * node.tagName="div"; + * }); + * }); + * ``` + */ addInputRule: function (rule) { this.inputRules.push(rule); }, + + /** + * 根据输入过滤规则,过滤编辑器内容 + * @method filterInputRule + * @param { Element } root 要过滤的文档节点 + * @example + * ```javascript + * editor.filterInputRule(editor.body); + * ``` + */ filterInputRule: function (root) { for (var i = 0, ci; ci = this.inputRules[i++];) { ci.call(this, root) } }, + + /** + * 添加输出过滤规则 + * @method addOutputRule + * @param { PlainObject } rule 要添加的过滤规则 + * @example + * ```javascript + * editor.addOutputRule(rule); + * ``` + */ addOutputRule: function (rule) { this.outputRules.push(rule) }, + + /** + * 根据输出过滤规则,过滤编辑器内容 + * @method filterOutputRule + * @param { Element } root 要过滤的文档节点 + * @example + * ```javascript + * editor.filterOutputRule(editor.body); + * ``` + */ filterOutputRule: function (root) { for (var i = 0, ci; ci = this.outputRules[i++];) { ci.call(this, root) } } - /** - * 得到dialog实例对象 - * @name getDialog - * @grammar editor.getDialog(dialogName) => Object - * @example - * var dialog = editor.getDialog("insertimage"); - * dialog.open(); //打开dialog - * dialog.close(); //关闭dialog - */ }; utils.inherits(Editor, EventBase); })(); diff --git a/_src/core/EventBase.js b/_src/core/EventBase.js index 35d3b1c74..5c0980cb0 100644 --- a/_src/core/EventBase.js +++ b/_src/core/EventBase.js @@ -1,19 +1,48 @@ /** + * UE采用的事件基类 * @file - * @name UE.EventBase - * @short EventBase - * @import editor.js,core/utils.js - * @desc UE采用的事件基类,继承此类的对应类将获取addListener,removeListener,fireEvent方法。 + * @module UE + * @class EventBase + * @since 1.2.6.1 + */ + +/** + * UEditor公用空间,UEditor所有的功能都挂载在该空间下 + * @unfile + * @module UE + */ + +/** + * UE采用的事件基类,继承此类的对应类将获取addListener,removeListener,fireEvent方法。 * 在UE中,Editor以及所有ui实例都继承了该类,故可以在对应的ui对象以及editor对象上使用上述方法。 + * @unfile + * @module UE + * @class EventBase */ -var EventBase = UE.EventBase = function () {}; + +/** + * 通过此构造器,子类可以继承EventBase获取事件监听的方法 + * @constructor + * @example + * ```javascript + * UE.EventBase.call(editor); + * ``` + */ + +var EventBase = UE.EventBase = function () { +}; EventBase.prototype = { + + /** * 注册事件监听器 - * @name addListener - * @grammar editor.addListener(types,fn) //types为事件名称,多个可用空格分隔 + * @method addListener + * @param { String } types 监听的事件名称,同时监听多个事件使用空格分隔 + * @param { Function } fn 监听的事件被触发时,会执行该回调函数 + * @waining 事件被触发时,监听的函数假如返回的值恒等于true,回调函数的队列中后面的函数将不执行 * @example + * ```javascript * editor.addListener('selectionchange',function(){ * console.log("选区已经变化!"); * }) @@ -25,35 +54,59 @@ EventBase.prototype = { * } * console.log(this.getContent) // this是注册的事件的编辑器实例 * }) + * ``` + * @see UE.EventBase:fireEvent(String) */ - addListener:function (types, listener) { + addListener: function (types, listener) { types = utils.trim(types).split(' '); for (var i = 0, ti; ti = types[i++];) { getListener(this, ti, true).push(listener); } }, + + /** * 移除事件监听器 - * @name removeListener - * @grammar editor.removeListener(types,fn) //types为事件名称,多个可用空格分隔 + * @method removeListener + * @param { String } types 移除的事件名称,同时移除多个事件使用空格分隔 + * @param { Function } fn 移除监听事件的函数引用 * @example + * ```javascript * //changeCallback为方法体 * editor.removeListener("selectionchange",changeCallback); + * ``` */ - removeListener:function (types, listener) { + removeListener: function (types, listener) { types = utils.trim(types).split(' '); for (var i = 0, ti; ti = types[i++];) { utils.removeItem(getListener(this, ti) || [], listener); } }, + + + /** + * 触发事件 + * @method fireEvent + * @param { String } types 触发的事件名称,同时触发多个事件使用空格分隔 + * @remind 该方法会触发addListener + * @return { * } 返回触发事件的队列中,最后执行的回调函数的返回值 + * @example + * ```javascript + * editor.fireEvent("selectionchange"); + * ``` + */ + /** * 触发事件 - * @name fireEvent - * @grammar editor.fireEvent(types) //types为事件名称,多个可用空格分隔 + * @method fireEvent + * @param { String } types 触发的事件名称,同时触发多个事件使用空格分隔 + * @param { *... } options 第二项开始的参数会传给触发的回调函数 * @example + * ```javascript * editor.fireEvent("selectionchange"); + * ``` */ - fireEvent:function () { + fireEvent: function () { var types = arguments[0]; types = utils.trim(types).split(' '); for (var i = 0, ti; ti = types[i++];) { @@ -62,9 +115,9 @@ EventBase.prototype = { if (listeners) { k = listeners.length; while (k--) { - if(!listeners[k])continue; + if (!listeners[k])continue; t = listeners[k].apply(this, arguments); - if(t === true){ + if (t === true) { return t; } if (t !== undefined) { @@ -79,19 +132,22 @@ EventBase.prototype = { return r; } }; + /** * 获得对象所拥有监听类型的所有监听器 + * @unfile + * @module UE + * @since 1.2.6.1 + * @method getListener * @public - * @function - * @param {Object} obj 查询监听器的对象 - * @param {String} type 事件类型 - * @param {Boolean} force 为true且当前所有type类型的侦听器不存在时,创建一个空监听器数组 - * @returns {Array} 监听器数组 + * @param { Object } obj 查询监听器的对象 + * @param { String } type 事件类型 + * @param { Boolean } force 为true且当前所有type类型的侦听器不存在时,创建一个空监听器数组 + * @return { Array } 监听器数组 */ function getListener(obj, type, force) { var allListeners; type = type.toLowerCase(); return ( ( allListeners = ( obj.__allListeners || force && ( obj.__allListeners = {} ) ) ) && ( allListeners[type] || force && ( allListeners[type] = [] ) ) ); -} - +} \ No newline at end of file From dc72b624e0e58c98aabbce18984c0cfc597067fa Mon Sep 17 00:00:00 2001 From: hancong03 <121371790@qq.com> Date: Mon, 26 Aug 2013 13:50:31 +0800 Subject: [PATCH 06/81] =?UTF-8?q?=E6=96=87=E6=A1=A3view?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/api.html | 19206 ++++++++++++++++++++++++++ docs/images/bg.png | Bin 0 -> 2108 bytes docs/images/up.png | Bin 0 -> 3103 bytes docs/scripts/autocomplete.js | 320 + docs/scripts/jquery-1.10.2.js | 9789 +++++++++++++ docs/scripts/search.js | 105 + docs/styles/bootstrap-theme.css | 384 + docs/styles/bootstrap-theme.min.css | 1 + docs/styles/bootstrap.css | 6805 +++++++++ docs/styles/bootstrap.min.css | 9 + docs/styles/page.css | 206 + docs/styles/pygments.css | 61 + 12 files changed, 36886 insertions(+) create mode 100644 docs/api.html create mode 100644 docs/images/bg.png create mode 100644 docs/images/up.png create mode 100644 docs/scripts/autocomplete.js create mode 100644 docs/scripts/jquery-1.10.2.js create mode 100644 docs/scripts/search.js create mode 100644 docs/styles/bootstrap-theme.css create mode 100644 docs/styles/bootstrap-theme.min.css create mode 100644 docs/styles/bootstrap.css create mode 100644 docs/styles/bootstrap.min.css create mode 100644 docs/styles/page.css create mode 100644 docs/styles/pygments.css diff --git a/docs/api.html b/docs/api.html new file mode 100644 index 000000000..b2f8691ed --- /dev/null +++ b/docs/api.html @@ -0,0 +1,19206 @@ + + + + API文档 + + + + + + + + + +
+ +
+
+

UE

+
+ 模块 +
+
+ +
+ +
+ UEditor公用空间,UEditor所有的功能都挂载在该空间下 +
+ + + + + +
+ +
+ +
+ + + + + + 方法列表 + + + + + + + + + + + + + + + + + +
方法签名静态描述
+ getListener(Object obj, String type, Boolean force) + + 是 + + 获得对象所拥有监听类型的所有监听器 +
+
+ + + + + 类列表 + + + + + + + + + + + + + + + + + + + + + + +
类名描述
+ Editor + + UEditor的核心类,为用户提供与编辑器交互的接口。 +
+ EventBase + + UE采用的事件基类,继承此类的对应类将获取addListener,removeListener,fireEvent方法。 + 在UE中,Editor以及所有ui实例都继承了该类,故可以在对应的ui对象以及editor对象上使用上述方法。 +
+
+ + +
+ +
+ + + + 模块成员详细描述(UE) + +
+ + + + + +
+
+

getListener(Object obj, String type, Boolean force)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获得对象所拥有监听类型的所有监听器 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ obj + + Object + + 查询监听器的对象 +
+ type + + String + + 事件类型 +
+ force + + Boolean + + 为true且当前所有type类型的侦听器不存在时,创建一个空监听器数组 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Array + + 监听器数组 +
+
+ + + + +
+
+ + + + +
+
+

Editor

+
+ +
+
+ +
+ +
+ UEditor的核心类,为用户提供与编辑器交互的接口。 +
+ + + + + +
+
+ 所属模块: UE +
+
+ +
+ +
+
+ + + + + + 事件列表 + + + + + + + + + + + + + + + + + + + + +
事件名描述
+ ready + + 编辑器准备就绪后会触发该事件 +
+ selectionchange + + 每当编辑器内部选区发生改变后, 将触发该事件 +
+
+ + + + + 构造器列表 + + + + + + + + + + + + + + + + + + + + +
方法签名描述
+ Editor() + + 以默认参数构建一个编辑器实例 +
+ Editor(PlainObject setting) + + 以给定的参数集合创建一个编辑器对象,对于未指定的参数,将应用默认参数。 +
+
+ + + + + 方法列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
方法签名静态描述
+ setValue(Editor editor) + + 否 + + 获取编辑器的html内容,赋值到编辑器所在表单的textarea文本域里面 +
+ loadPlugins(Editor editor) + + 否 + + 初始化插件 +
+ checkCurLang(PlainObject I18N) + + 否 + + 获取语言包里面的第一个 +
+ ready(Function fn) + + 否 + + 编辑器对外提供的监听ready事件的接口, 通过调用该方法,达到的效果与监听ready事件是一致的 +
+ setOpt(String key, * val) + + 否 + + 以attributeName - attributeValue的方式设置编辑器的配置项,以覆盖编辑器的默认选项值 +
+ setOpt(PlainObject settings) + + 否 + + 以key-value集合的方式设置编辑器的配置项,以覆盖编辑器的默认选项值 +
+ destroy() + + 否 + + 销毁编辑器实例对象 +
+ render(String containerId) + + 否 + + 渲染编辑器的DOM到指定容器 +
+ render(Element containerDom) + + 否 + + 渲染编辑器的DOM到指定容器 +
+ _setup(Element doc) + + 否 + + 编辑器初始化 +
+ sync() + + 否 + + 同步编辑器的数据,为提交数据做准备,主要用于是手动提交的情况 + 后台取得数据的键值使用你容器上的name属性,如果没有就使用参数传入的textarea属性 + 获取要同步的表单,从编辑器的容器向上查找要同步数据的form,如果找到就同步数据 +
+ sync(String formID) + + 否 + + 同步编辑器的数据,为提交数据做准备,主要用于是手动提交的情况 + 后台取得数据的键值使用你容器上的name属性,如果没有就使用参数传入的textarea属性 + 根据传入表单id参数,获取要同步数据的form +
+ setHeight(Number number) + + 否 + + 设置编辑器高度 +
+ addshortcutkey(PlainObject keyset) + + 否 + + 添加命令的快捷键 +
+ addshortcutkey(String cmd, String keys) + + 否 + + 添加命令的快捷键 +
+ _bindshortcutKeys() + + 否 + + 对编辑器设置keydown事件监听,绑定快捷键和命令,当快捷键组合触发成功,会响应对应的命令 +
+ getContent() + + 否 + + 获取编辑器的内容 +
+ getContent(Function fn) + + 否 + + 获取编辑器的内容。 可以通过参数定义编辑器内置的判空规则 +
+ getAllHtml() + + 否 + + 取得完整的html代码,可以直接显示成完整的html文档 +
+ getPlainTxt() + + 否 + + 得到编辑器的纯文本内容,但会保留段落格式 +
+ getContentTxt() + + 否 + + 获取编辑器中的纯文本内容,没有段落格式 +
+ getContent() + + 否 + + 获取编辑器的内容 +
+ getContent(Function fn) + + 否 + + 获取编辑器的内容。 可以通过参数定义编辑器内置的判空规则 +
+ focus() + + 否 + + 让编辑器获得焦点,默认focus到编辑器头部 +
+ focus(Boolean toEnd) + + 否 + + 让编辑器获得焦点,toEnd确定focus位置 +
+ _initEvents() + + 否 + + 初始化UE事件及部分事件代理 +
+ _proxyDomEvent() + + 否 + + 触发事件代理 +
+ _selectionChange() + + 否 + + 变化选区 +
+ _callCmdFn(String fnName, * args) + + 否 + + 执行编辑命令 +
+ execCommand() + + 否 + + 执行编辑命令cmdName,完成富文本编辑效果 +
+ queryCommandState() + + 否 + + 根据传入的command命令,查选编辑器当前的选区,返回命令的状态 +
+ queryCommandValue() + + 否 + + 根据传入的command命令,查选编辑器当前的选区,根据命令返回相关的值 +
+ hasContents() + + 否 + + 检查编辑区域中是否有内容 +
+ hasContents() + + 否 + + 检查编辑区域中是否有内容,若包含参数tags中的节点类型,直接返回true +
+ reset() + + 否 + + 重置编辑器,可用来做多个tab使用同一个编辑器实例 +
+ setEnabled() + + 否 + + 设置当前编辑区域可以编辑 +
+ enable() + + 否 + + 设置当前编辑区域可以编辑 +
+ setDisabled() + + 否 + + 设置当前编辑区域不可编辑 +
+ setDisabled(String except) + + 否 + + 设置当前编辑区域不可编辑,except中的命令除外 +
+ setDisabled(Array except) + + 否 + + 设置当前编辑区域不可编辑,except中的命令除外 +
+ disable() + + 否 + + 设置当前编辑区域不可编辑 +
+ disable(String except) + + 否 + + 设置当前编辑区域不可编辑,except中的命令除外 +
+ disable(Array except) + + 否 + + 设置当前编辑区域不可编辑,except中的命令除外 +
+ _setDefaultContent(String cont) + + 否 + + 设置默认内容 +
+ setShow(String cont) + + 否 + + 显示编辑器,show方法的兼容版本 +
+ show(String cont) + + 否 + + 显示编辑器 +
+ setHide() + + 否 + + 隐藏编辑器,hide方法的兼容版本 +
+ hide() + + 否 + + 隐藏编辑器 +
+ getLang(String path) + + 否 + + 根据指定的路径,获取对应的语言资源 +
+ getContentLength() + + 否 + + 计算编辑器当前html内容的长度 +
+ getContentLength() + + 否 + + 计算编辑器当前存文本内容的长度 +
+ getContentLength() + + 否 + + 计算编辑器当前内容的长度 +
+ addInputRule(Function rule) + + 否 + + 添加输入过滤规则 +
+ filterInputRule(Element root) + + 否 + + 根据输入过滤规则,过滤编辑器内容 +
+ addOutputRule(PlainObject rule) + + 否 + + 添加输出过滤规则 +
+ filterOutputRule(Element root) + + 否 + + 根据输出过滤规则,过滤编辑器内容 +
+
+ + +
+ +
+ + + + 类成员详细描述(Editor) + +
+ + + + + + +
+
+

ready

+
+ 事件 +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 编辑器准备就绪后会触发该事件 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 示例 + + + + + +
+
+ +
+
+

selectionchange

+
+ 事件 +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 每当编辑器内部选区发生改变后, 将触发该事件 +
+ + + + + + +
    +
  • + 警告: 该事件的触发非常频繁,不建议在该事件的处理过程中做重量级的处理 +
  • +
+ + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 示例 + +
+
1
+2
+3
+4
+5
 editor.addListener( 'selectionchange', function( editor ) {
+
+     editor.execCommand( 'bold' );
+
+ }
+
+
+
+ +
+ + + +
+
+ + + + + +
+
+

Editor()

+
+ 构造器 +
+ + + 1.2.6.1 + + +
+
+ +
+ 以默认参数构建一个编辑器实例 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+
+ + + + + 参考 +
+ + UE.Config + +
+
+ + + + + + + + + 示例 + + + + +
+
+ +
+
+

Editor(PlainObject setting)

+
+ 构造器 +
+ + + 1.2.6.1 + + +
+
+ +
+ 以给定的参数集合创建一个编辑器对象,对于未指定的参数,将应用默认参数。 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+
+ + + + + 参考 +
+ + UE.Config + +
+
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ setting + + PlainObject + + 创建编辑器的参数 +
+
+ + + + + + + 示例 + +
+
1
+2
 var editor = new UE.Editor();
+ editor.execCommand('blod');
+
+
+
+ +
+ + +
+
+ + + + + +
+
+

setValue(Editor editor)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取编辑器的html内容,赋值到编辑器所在表单的textarea文本域里面 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ editor + + Editor + + 编辑器事例 +
+
+ + + + + + +
+
+ +
+
+

loadPlugins(Editor editor)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 初始化插件 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ editor + + Editor + + 编辑器事例 +
+
+ + + + + + +
+
+ +
+
+

checkCurLang(PlainObject I18N)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取语言包里面的第一个 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ I18N + + PlainObject + + 编辑器事例 +
+
+ + + + + + +
+
+ +
+
+

ready(Function fn)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 编辑器对外提供的监听ready事件的接口, 通过调用该方法,达到的效果与监听ready事件是一致的 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + 参考 + + + + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ fn + + Function + + 编辑器ready之后所执行的回调, 如果在注册事件之前编辑器已经ready,将会 + 立即触发该回调。 +
+
+ + + + + + + + + 示例 + +
+
1
+2
+3
+4
+5
 editor.ready( function( editor ) {
+
+     editor.setContent('初始化完毕');
+
+ } );
+
+
+
+ +
+ + +
+
+ +
+
+

setOpt(String key, * val)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 以attributeName - attributeValue的方式设置编辑器的配置项,以覆盖编辑器的默认选项值 +
+ + + + + + +
    +
  • + 警告: 该方法仅供编辑器构造函数调用,其他任何方法不能调用。 +
  • +
+ + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ key + + String + + 编辑器的可接受的选项名称 +
+ val + + * + + 该选项可接受的值 +
+
+ + + + + + + + + 示例 + +
+
1
 editor.setOpt( 'initContent', '欢迎使用编辑器' );
+
+
+
+ +
+ + +
+
+ +
+
+

setOpt(PlainObject settings)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 以key-value集合的方式设置编辑器的配置项,以覆盖编辑器的默认选项值 +
+ + + + + + +
    +
  • + 警告: 该方法仅供编辑器构造函数调用,其他任何方法不能调用。 +
  • +
+ + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ settings + + PlainObject + + 编辑器的可接受的选项的key-value集合 +
+
+ + + + + + + + + 示例 + +
+
1
+2
+3
 editor.setOpt( {
+     'initContent': '欢迎使用编辑器'
+ } );
+
+
+
+ +
+ + +
+
+ +
+
+

destroy()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 销毁编辑器实例对象 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + + + 示例 + +
+
1
 editor.destroy();
+
+
+
+ +
+ + +
+
+ +
+
+

render(String containerId)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 渲染编辑器的DOM到指定容器 +
+ + + + + + +
    +
  • + 警告: 必须且只能调用一次 +
  • +
+ + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ containerId + + String + + 指定一个容器ID +
+
+ + + + + + +
+
+ +
+
+

render(Element containerDom)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 渲染编辑器的DOM到指定容器 +
+ + + + + + +
    +
  • + 警告: 必须且只能调用一次 +
  • +
+ + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ containerDom + + Element + + 直接指定容器对象 +
+
+ + + + + + +
+
+ +
+
+

_setup(Element doc)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 编辑器初始化 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ doc + + Element + + 编辑器Iframe中的文档对象 +
+
+ + + + + + +
+
+ +
+
+

sync()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 同步编辑器的数据,为提交数据做准备,主要用于是手动提交的情况 + 后台取得数据的键值使用你容器上的name属性,如果没有就使用参数传入的textarea属性 + 获取要同步的表单,从编辑器的容器向上查找要同步数据的form,如果找到就同步数据 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + + + 示例 + +
+
1
+2
 editor.sync();
+ form.sumbit(); //form变量已经指向了form元素
+
+
+
+ +
+ + +
+
+ +
+
+

sync(String formID)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 同步编辑器的数据,为提交数据做准备,主要用于是手动提交的情况 + 后台取得数据的键值使用你容器上的name属性,如果没有就使用参数传入的textarea属性 + 根据传入表单id参数,获取要同步数据的form +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ formID + + String + + 指定一个要同步数据的form的id,编辑器的数据会同步到你指定form下 +
+
+ + + + + + +
+
+ +
+
+

setHeight(Number number)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 设置编辑器高度 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ number + + Number + + 设置的高度值,纯数值,不带单位 +
+
+ + + + + + + + + 示例 + +
+
1
 editor.setHeight(number);
+
+
+
+ +
+ + +
+
+ +
+
+

addshortcutkey(PlainObject keyset)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 添加命令的快捷键 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ keyset + + PlainObject + + 命令和快捷键的键值对对象,多个按钮的快捷键用“+”分隔 +
+
+ + + + + + + + + 示例 + +
+
1
+2
+3
+4
 editor.addshortcutkey({
+     "Bold" : "ctrl+66",//^B
+     "Italic" : "ctrl+73", //^I
+ });
+
+
+
+ +
+ + +
+
+ +
+
+

addshortcutkey(String cmd, String keys)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 添加命令的快捷键 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ cmd + + String + + 触发快捷键时,响应的命令 +
+ keys + + String + + 快捷键的字符串,多个按钮用“+”分隔 +
+
+ + + + + + + + + 示例 + +
+
1
 editor.addshortcutkey("Underline", "ctrl+85"); //^U
+
+
+
+ +
+ + +
+
+ +
+
+

_bindshortcutKeys()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 对编辑器设置keydown事件监听,绑定快捷键和命令,当快捷键组合触发成功,会响应对应的命令 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + +
+
+ +
+
+

getContent()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取编辑器的内容 +
+ + + + + + +
    +
  • + 警告: 该方法获取到的是经过编辑器内置的过滤规则进行过滤后得到的内容 +
  • +
+ + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ String + + 编辑器的内容字符串, 如果编辑器的内容为空, 则返回空字符串 +
+
+ + + + + + + 示例 + +
+
1
 var content = editor.getContent();
+
+
+
+ +
+ + +
+
+ +
+
+

getContent(Function fn)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取编辑器的内容。 可以通过参数定义编辑器内置的判空规则 +
+ + + + +
    +
  • + 提示: 该方法在处理包含有初始化内容的时候能起到很好的作用。 +
  • +
+ + + + + + + +
    +
  • + 警告: 该方法获取到的是经过编辑器内置的过滤规则进行过滤后得到的内容 +
  • +
+ + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ fn + + Function + + 自定的判空规则, 要求该方法返回一个boolean类型的值, + 代表当前编辑器的内容是否空, + 如果返回true, 则该方法将直接返回空字符串;如果返回false,则编辑器将返回 + 经过内置过滤规则处理后的内容。 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ String + + 编辑器的内容字符串 +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
 // editor 是一个编辑器的实例
+ var content = editor.getContent( function ( editor ) {
+      return editor.body.innerHTML === '欢迎使用UEditor';
+ } );
+
+
+
+ +
+ + +
+
+ +
+
+

getAllHtml()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 取得完整的html代码,可以直接显示成完整的html文档 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ String + + 编辑器的内容html文档字符串 +
+
+ + + + +
+
+ +
+
+

getPlainTxt()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 得到编辑器的纯文本内容,但会保留段落格式 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ String + + 编辑器带段落格式的纯文本内容字符串 +
+
+ + + + + + + 示例 + +
+
1
 editor.getPlainTxt();
+
+
+
+ +
+ + +
+
+ +
+
+

getContentTxt()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取编辑器中的纯文本内容,没有段落格式 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ String + + 编辑器不带段落格式的纯文本内容字符串 +
+
+ + + + + + + 示例 + +
+
1
 editor.getContentTxt();
+
+
+
+ +
+ + +
+
+ +
+
+

getContent()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取编辑器的内容 +
+ + + + + + +
    +
  • + 警告: 该方法获取到的是经过编辑器内置的过滤规则进行过滤后得到的内容 +
  • +
+ + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ String + + 编辑器的内容字符串, 如果编辑器的内容为空, 则返回空字符串 +
+
+ + + + + + + 示例 + +
+
1
 var content = editor.getContent();
+
+
+
+ +
+ + +
+
+ +
+
+

getContent(Function fn)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取编辑器的内容。 可以通过参数定义编辑器内置的判空规则 +
+ + + + +
    +
  • + 提示: 该方法在处理包含有初始化内容的时候能起到很好的作用。 +
  • +
+ + + + + + + +
    +
  • + 警告: 该方法获取到的是经过编辑器内置的过滤规则进行过滤后得到的内容 +
  • +
+ + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ fn + + Function + + 自定的判空规则, 要求该方法返回一个boolean类型的值, + 代表当前编辑器的内容是否空, + 如果返回true, 则该方法将直接返回空字符串;如果返回false,则编辑器将返回 + 经过内置过滤规则处理后的内容。 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ String + + 编辑器的内容字符串 +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
 // editor 是一个编辑器的实例
+ var content = editor.getContent( function ( editor ) {
+
+      return editor.body.innerHTML === '欢迎使用UEditor';
+
+ } );
+
+
+
+ +
+ + +
+
+ +
+
+

focus()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 让编辑器获得焦点,默认focus到编辑器头部 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + + + 示例 + +
+
1
 editor.focus()
+
+
+
+ +
+ + +
+
+ +
+
+

focus(Boolean toEnd)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 让编辑器获得焦点,toEnd确定focus位置 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ toEnd + + Boolean + + 默认focus到编辑器头部,toEnd为true时focus到内容尾部 +
+
+ + + + + + + + + 示例 + +
+
1
 editor.focus(true)
+
+
+
+ +
+ + +
+
+ +
+
+

_initEvents()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 初始化UE事件及部分事件代理 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + +
+
+ +
+
+

_proxyDomEvent()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 触发事件代理 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + 参考 + + + + + + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ * + + fireEvent的返回值 +
+
+ + + + +
+
+ +
+
+

_selectionChange()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 变化选区 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + +
+
+ +
+
+

_callCmdFn(String fnName, * args)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 执行编辑命令 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ fnName + + String + + 函数名称 +
+ args + + * + + 传给命令函数的参数 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ * + + 返回命令函数运行的返回值 +
+
+ + + + +
+
+ +
+
+

execCommand()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 执行编辑命令cmdName,完成富文本编辑效果 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ * + + 返回命令函数运行的返回值 +
+
+ + + + + + + 示例 + +
+
1
 editor.execCommand(cmdName);
+
+
+
+ +
+ + +
+
+ +
+
+

queryCommandState()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 根据传入的command命令,查选编辑器当前的选区,返回命令的状态 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Number + + number 返回放前命令的状态 + 返回 -1 当前命令不可用 + 返回 0 当前命令可用 + 返回 1 当前命令已经执行过了 +
+
+ + + + + + + 示例 + +
+
1
 editor.queryCommandState(cmdName)  => (-1|0|1)
+
+
+
+ +
+ + +
+
+ +
+
+

queryCommandValue()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 根据传入的command命令,查选编辑器当前的选区,根据命令返回相关的值 +
+ + + + +
    +
  • + 提示: 只有部分插件有此方法 +
  • +
+ + + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ * + + 返回每个命令特定的当前状态值 +
+
+ + + + +
+
+ +
+
+

hasContents()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检查编辑区域中是否有内容 +
+ + + + +
    +
  • + 提示: 默认有文本内容,或者有以下节点都不认为是空 + {table:1,ul:1,ol:1,dl:1,iframe:1,area:1,base:1,col:1,hr:1,img:1,embed:1,input:1,link:1,meta:1,param:1} +
  • +
+ + + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 检查有内容返回true,否则返回false +
+
+ + + + + + + 示例 + +
+
1
 editor.hasContents()
+
+
+
+ +
+ + +
+
+ +
+
+

hasContents()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检查编辑区域中是否有内容,若包含参数tags中的节点类型,直接返回true +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 若文档中包含tags数组里对应的tag,返回true,否则返回false +
+
+ + + + + + + 示例 + + + + +
+
+ +
+
+

reset()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 重置编辑器,可用来做多个tab使用同一个编辑器实例 +
+ + + + +
    +
  • + 提示: 此方法会清空编辑器内容,清空回退列表 +
  • +
+ + + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + + + 示例 + +
+
1
 editor.reset()
+
+
+
+ +
+ + +
+
+ +
+
+

setEnabled()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 设置当前编辑区域可以编辑 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + + + 示例 + +
+
1
 editor.setEnabled()
+
+
+
+ +
+ + +
+
+ +
+
+

enable()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 设置当前编辑区域可以编辑 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + 参考 + + + + + + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ * + + 返回setEnabled方法的返回值 +
+
+ + + + + + + 示例 + +
+
1
 editor.enable()
+
+
+
+ +
+ + +
+
+ +
+
+

setDisabled()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 设置当前编辑区域不可编辑 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + +
+
+ +
+
+

setDisabled(String except)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 设置当前编辑区域不可编辑,except中的命令除外 +
+ + + + +
    +
  • + 提示: 即使设置了disable,此处配置的例外命令仍然可以执行 +
  • +
+ + + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ except + + String + + 例外命令的字符串 +
+
+ + + + + + + + + 示例 + +
+
1
 editor.setDisabled('bold'); //禁用工具栏中除加粗之外的所有功能
+
+
+
+ +
+ + +
+
+ +
+
+

setDisabled(Array except)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 设置当前编辑区域不可编辑,except中的命令除外 +
+ + + + +
    +
  • + 提示: 即使设置了disable,此处配置的例外命令仍然可以执行 +
  • +
+ + + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ except + + Array + + 字符串数组,数组中的命令仍然可以执行 +
+
+ + + + + + + + + 示例 + +
+
1
 editor.setDisabled(['bold','insertimage']); //禁用工具栏中除加粗和插入图片之外的所有功能
+
+
+
+ +
+ + +
+
+ +
+
+

disable()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 设置当前编辑区域不可编辑 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + 参考 + + + + + + + + + + +
+
+ +
+
+

disable(String except)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 设置当前编辑区域不可编辑,except中的命令除外 +
+ + + + +
    +
  • + 提示: 即使设置了disable,此处配置的例外命令仍然可以执行 +
  • +
+ + + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + 参考 + + + + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ except + + String + + 例外命令的字符串 +
+
+ + + + + + + + + 示例 + +
+
1
 editor.disable('bold'); //禁用工具栏中除加粗之外的所有功能
+
+
+
+ +
+ + +
+
+ +
+
+

disable(Array except)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 设置当前编辑区域不可编辑,except中的命令除外 +
+ + + + +
    +
  • + 提示: 即使设置了disable,此处配置的例外命令仍然可以执行 +
  • +
+ + + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + 参考 + + + + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ except + + Array + + 字符串数组,数组中的命令仍然可以执行 +
+
+ + + + + + + + + 示例 + +
+
1
 editor.disable(['bold','insertimage']); //禁用工具栏中除加粗和插入图片之外的所有功能
+
+
+
+ +
+ + +
+
+ +
+
+

_setDefaultContent(String cont)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 设置默认内容 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ cont + + String + + 要存入的内容 +
+
+ + + + + + +
+
+ +
+
+

setShow(String cont)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 显示编辑器,show方法的兼容版本 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ cont + + String + + 要存入的内容 +
+
+ + + + + + +
+
+ +
+
+

show(String cont)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 显示编辑器 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + 参考 + + + + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ cont + + String + + 要存入的内容 +
+
+ + + + + + + + + 示例 + +
+
1
 editor.show()
+
+
+
+ +
+ + +
+
+ +
+
+

setHide()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 隐藏编辑器,hide方法的兼容版本 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + +
+
+ +
+
+

hide()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 隐藏编辑器 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + 参考 + + + + + + + + + + + + + 示例 + +
+
1
 editor.hide()
+
+
+
+ +
+ + +
+
+ +
+
+

getLang(String path)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 根据指定的路径,获取对应的语言资源 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ path + + String + + 路径根据的是lang目录下的语言文件的路径结构 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ PlainObject | String + + 根据路径返回语言资源的Json格式对象或者语言字符串 +
+
+ + + + + + + 示例 + +
+
1
 editor.getLang('contextMenu.delete'); //如果当前是中文,那返回是的是'删除'
+
+
+
+ +
+ + +
+
+ +
+
+

getContentLength()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 计算编辑器当前html内容的长度 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Number + + 返回计算的长度 +
+
+ + + + + + + 示例 + +
+
1
 editor.getContentLength()
+
+
+
+ +
+ + +
+
+ +
+
+

getContentLength()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 计算编辑器当前存文本内容的长度 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + +
参数名类型描述
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Number + + 返回计算的长度,内容中有hr/img/iframe标签,长度加1 +
+
+ + + + + + + 示例 + +
+
1
 editor.getContentLength(true)
+
+
+
+ +
+ + +
+
+ +
+
+

getContentLength()

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 计算编辑器当前内容的长度 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + +
参数名类型描述
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Number + + 返回计算的长度,内容中有hr/img/iframe标签或者参数tagNames中的标签,长度加1 +
+
+ + + + + + + 示例 + +
+
1
 editor.getContentLength(true, ['em','strong'])
+
+
+
+ +
+ + +
+
+ +
+
+

addInputRule(Function rule)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 添加输入过滤规则 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ rule + + Function + + 要添加的过滤规则 +
+
+ + + + + + + + + 示例 + +
+
1
+2
+3
+4
+5
 editor.addOutputRule(function(root){
+   $.each(root.getNodesByTagName('p'),function(i,node){
+       node.tagName="div";
+   });
+ });
+
+
+
+ +
+ + +
+
+ +
+
+

filterInputRule(Element root)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 根据输入过滤规则,过滤编辑器内容 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ root + + Element + + 要过滤的文档节点 +
+
+ + + + + + + + + 示例 + +
+
1
 editor.filterInputRule(editor.body);
+
+
+
+ +
+ + +
+
+ +
+
+

addOutputRule(PlainObject rule)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 添加输出过滤规则 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ rule + + PlainObject + + 要添加的过滤规则 +
+
+ + + + + + + + + 示例 + +
+
1
 editor.addOutputRule(rule);
+
+
+
+ +
+ + +
+
+ +
+
+

filterOutputRule(Element root)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 根据输出过滤规则,过滤编辑器内容 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.Editor +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ root + + Element + + 要过滤的文档节点 +
+
+ + + + + + + + + 示例 + +
+
1
 editor.filterOutputRule(editor.body);
+
+
+
+ +
+ + +
+
+ + +
+
+ + +
+
+ +
+ +
+
+

EventBase

+
+ +
+
+ +
+ +
+ UE采用的事件基类,继承此类的对应类将获取addListener,removeListener,fireEvent方法。 + 在UE中,Editor以及所有ui实例都继承了该类,故可以在对应的ui对象以及editor对象上使用上述方法。 +
+ + + + + +
+
+ 所属模块: UE +
+
+ +
+ +
+
+ + + + + + + + 构造器列表 + + + + + + + + + + + + + + + +
方法签名描述
+ EventBase() + + 通过此构造器,子类可以继承EventBase获取事件监听的方法 +
+
+ + + + + 方法列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
方法签名静态描述
+ addListener(String types, Function fn) + + 否 + + 注册事件监听器 +
+ removeListener(String types, Function fn) + + 否 + + 移除事件监听器 +
+ fireEvent(String types) + + 否 + + 触发事件 +
+ fireEvent(String types, *... options) + + 否 + + 触发事件 +
+
+ + +
+ +
+ + + + 类成员详细描述(EventBase) + +
+ + + + + + + + + + +
+
+

EventBase()

+
+ 构造器 +
+ + + 1.2.6.1 + + +
+
+ +
+ 通过此构造器,子类可以继承EventBase获取事件监听的方法 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.EventBase +
+ +
+ +
+
+ + + + + + + + + 示例 + +
+
1
 UE.EventBase.call(editor);
+
+
+
+ +
+ + +
+
+ + + + + +
+
+

addListener(String types, Function fn)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 注册事件监听器 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.EventBase +
+ +
+ +
+ +
+ + + + + 参考 + + + + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ types + + String + + 监听的事件名称,同时监听多个事件使用空格分隔 +
+ fn + + Function + + 监听的事件被触发时,会执行该回调函数 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
 editor.addListener('selectionchange',function(){
+      console.log("选区已经变化!");
+ })
+ editor.addListener('beforegetcontent aftergetcontent',function(type){
+         if(type == 'beforegetcontent'){
+             //do something
+         }else{
+             //do something
+         }
+         console.log(this.getContent) // this是注册的事件的编辑器实例
+ })
+
+
+
+ +
+ + +
+
+ +
+
+

removeListener(String types, Function fn)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 移除事件监听器 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.EventBase +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ types + + String + + 移除的事件名称,同时移除多个事件使用空格分隔 +
+ fn + + Function + + 移除监听事件的函数引用 +
+
+ + + + + + + + + 示例 + +
+
1
+2
 //changeCallback为方法体
+ editor.removeListener("selectionchange",changeCallback);
+
+
+
+ +
+ + +
+
+ +
+
+

fireEvent(String types)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 触发事件 +
+ + + + +
    +
  • + 提示: 该方法会触发addListener +
  • +
+ + + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.EventBase +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ types + + String + + 触发的事件名称,同时触发多个事件使用空格分隔 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ * + + 返回触发事件的队列中,最后执行的回调函数的返回值 +
+
+ + + + + + + 示例 + +
+
1
 editor.fireEvent("selectionchange");
+
+
+
+ +
+ + +
+
+ +
+
+

fireEvent(String types, *... options)

+
+ 方法 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 触发事件 +
+ + + + + +
+
+ 所属模块: UE +
+ +
+ 所属类: UE.EventBase +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ types + + String + + 触发的事件名称,同时触发多个事件使用空格分隔 +
+ options + + *... + + 第二项开始的参数会传给触发的回调函数 +
+
+ + + + + + + + + 示例 + +
+
1
 editor.fireEvent("selectionchange");
+
+
+
+ +
+ + +
+
+ + +
+
+ + +
+
+ +
+ + +
+ +
+ + +
+ +
+ +
+ +
+
+

UE.browser

+
+ 模块 +
+
+ +
+ +
+ 提供浏览器检测的模块 +
+ + + + + +
+ +
+ +
+ + + + 属性列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
属性名类型静态描述
+ ie + + boolean + + 是 + + 检测当前浏览器是否为IE +
+ opera + + boolean + + 是 + + 检测当前浏览器是否为Opera +
+ webkit + + boolean + + 是 + + 检测当前浏览器是否是webkit内核的浏览器 +
+ mac + + boolean + + 是 + + 检测当前浏览器是否是运行在mac平台下 +
+ quirks + + boolean + + 是 + + 检测当前浏览器是否处于“怪异模式”下 +
+ gecko + + boolean + + 是 + + 检测当前浏览器内核是否是gecko内核 +
+ ie9Compat + + boolean + + 是 + + 检测浏览器模式是否为 IE9 兼容模式 +
+ ie8 + + boolean + + 是 + + 检测浏览器是否是IE8浏览器 +
+ ie8Compat + + boolean + + 是 + + 检测浏览器模式是否为 IE8 兼容模式 +
+ ie7Compat + + boolean + + 是 + + 检测浏览器模式是否为 IE7 兼容模式 +
+ ie6Compat + + boolean + + 是 + + 检测浏览器模式是否为 IE6 模式 或者怪异模式 +
+ chrome + + Number + + 是 + + 检测当前浏览器是否为Chrome, 如果是,则返回Chrome的大版本号 +
+ safari + + Number + + 是 + + 检测当前浏览器是否为Safari, 如果是,则返回Safari的大版本号 +
+ version + + Number + + 是 + + 检测当前浏览器版本号 +
+ isCompatible + + boolean + + 是 + + 检测当前浏览器是否能够与UEditor良好兼容 +
+
+ + + + + + +
+ +
+ + + + 模块成员详细描述(UE.browser) + +
+ +
+
+

ie

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测当前浏览器是否为IE +
+ + + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ boolean + + + 无 + + + 检测当前浏览器是否为IE +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.ie ) {
+     console.log( '当前浏览器是IE' );
+ }
+
+
+
+ +
+ + + +
+
+
+

opera

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测当前浏览器是否为Opera +
+ + + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ boolean + + + 无 + + + 检测当前浏览器是否为Opera +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.opera ) {
+     console.log( '当前浏览器是Opera' );
+ }
+
+
+
+ +
+ + + +
+
+
+

webkit

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测当前浏览器是否是webkit内核的浏览器 +
+ + + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ boolean + + + 无 + + + 检测当前浏览器是否是webkit内核的浏览器 +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.webkit ) {
+     console.log( '当前浏览器是webkit内核浏览器' );
+ }
+
+
+
+ +
+ + + +
+
+
+

mac

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测当前浏览器是否是运行在mac平台下 +
+ + + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ boolean + + + 无 + + + 检测当前浏览器是否是运行在mac平台下 +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.mac ) {
+     console.log( '当前浏览器运行在mac平台下' );
+ }
+
+
+
+ +
+ + + +
+
+
+

quirks

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测当前浏览器是否处于“怪异模式”下 +
+ + + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ boolean + + + 无 + + + 检测当前浏览器是否处于“怪异模式”下 +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.quirks ) {
+     console.log( '当前浏览器运行处于“怪异模式”' );
+ }
+
+
+
+ +
+ + + +
+
+
+

gecko

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测当前浏览器内核是否是gecko内核 +
+ + + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ boolean + + + 无 + + + 检测当前浏览器内核是否是gecko内核 +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.gecko ) {
+     console.log( '当前浏览器内核是gecko内核' );
+ }
+
+
+
+ +
+ + + +
+
+
+

ie9Compat

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测浏览器模式是否为 IE9 兼容模式 +
+ + + + + + +
    +
  • + 警告: 如果浏览器不是IE, 则该值为undefined +
  • +
+ + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ boolean + + + 无 + + + 检测浏览器模式是否为 IE9 兼容模式 +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.ie9Compat ) {
+     console.log( '当前浏览器运行在IE9兼容模式下' );
+ }
+
+
+
+ +
+ + + +
+
+
+

ie8

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测浏览器是否是IE8浏览器 +
+ + + + + + +
    +
  • + 警告: 如果浏览器不是IE, 则该值为undefined +
  • +
+ + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ boolean + + + 无 + + + 检测浏览器是否是IE8浏览器 +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.ie8 ) {
+     console.log( '当前浏览器是IE8浏览器' );
+ }
+
+
+
+ +
+ + + +
+
+
+

ie8Compat

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测浏览器模式是否为 IE8 兼容模式 +
+ + + + + + +
    +
  • + 警告: 如果浏览器不是IE, 则该值为undefined +
  • +
+ + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ boolean + + + 无 + + + 检测浏览器模式是否为 IE8 兼容模式 +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.ie8Compat ) {
+     console.log( '当前浏览器运行在IE8兼容模式下' );
+ }
+
+
+
+ +
+ + + +
+
+
+

ie7Compat

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测浏览器模式是否为 IE7 兼容模式 +
+ + + + + + +
    +
  • + 警告: 如果浏览器不是IE, 则该值为undefined +
  • +
+ + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ boolean + + + 无 + + + 检测浏览器模式是否为 IE7 兼容模式 +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.ie7Compat ) {
+     console.log( '当前浏览器运行在IE7兼容模式下' );
+ }
+
+
+
+ +
+ + + +
+
+
+

ie6Compat

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测浏览器模式是否为 IE6 模式 或者怪异模式 +
+ + + + + + +
    +
  • + 警告: 如果浏览器不是IE, 则该值为undefined +
  • +
+ + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ boolean + + + 无 + + + 检测浏览器模式是否为 IE6 模式 或者怪异模式 +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.ie6Compat ) {
+     console.log( '当前浏览器运行在IE6模式或者怪异模式下' );
+ }
+
+
+
+ +
+ + + +
+
+
+

chrome

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测当前浏览器是否为Chrome, 如果是,则返回Chrome的大版本号 +
+ + + + + + +
    +
  • + 警告: 如果浏览器不是chrome, 则该值为undefined +
  • +
+ + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ Number + + + 无 + + + 检测当前浏览器是否为Chrome, 如果是,则返回Chrome的大版本号 +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.chrome ) {
+     console.log( '当前浏览器是Chrome' );
+ }
+
+
+
+ +
+ + + +
+
+
+

safari

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测当前浏览器是否为Safari, 如果是,则返回Safari的大版本号 +
+ + + + + + +
    +
  • + 警告: 如果浏览器不是safari, 则该值为undefined +
  • +
+ + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ Number + + + 无 + + + 检测当前浏览器是否为Safari, 如果是,则返回Safari的大版本号 +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.safari ) {
+     console.log( '当前浏览器是Safari' );
+ }
+
+
+
+ +
+ + + +
+
+
+

version

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测当前浏览器版本号 +
+ + + + +
    +
  • + 提示:
      +
    • IE系列返回值为5,6,7,8,9,10等
    • +
    • gecko系列会返回10900,158900等
    • +
    • webkit系列会返回其build号 (如 522等)
    • +
    +
  • +
+ + + + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ Number + + + 无 + + + 检测当前浏览器版本号 +
+ + + + + 示例 + +
+
1
 console.log( '当前浏览器版本号是: ' + UE.browser.version );
+
+
+
+ +
+ + + +
+
+
+

isCompatible

+
+ 属性 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测当前浏览器是否能够与UEditor良好兼容 +
+ + + + + +
+
+ 所属模块: UE.browser +
+ +
+ +
+ +
+ + + + + + + + + + + + + + + + + + +
类型默认值描述
+ boolean + + + 无 + + + 检测当前浏览器是否能够与UEditor良好兼容 +
+ + + + + 示例 + +
+
1
+2
+3
 if ( UE.browser.isCompatible ) {
+     console.log( '浏览器与UEditor能够良好兼容' );
+ }
+
+
+
+ +
+ + + +
+
+ + + + + + + +
+ +
+ + +
+ +
+ +
+ +
+
+

UE.ajax

+
+ 模块 +
+
+ +
+ +
+ 提供对ajax请求的支持 +
+ + + + + +
+ +
+ +
+ + + + + + 方法列表 + + + + + + + + + + + + + + + + + + + + + + + +
方法签名静态描述
+ request(URLString url, PlainObject ajaxOptions) + + 是 + + 根据给定的参数项,向指定的url发起一个ajax请求。 ajax请求完成后,会根据请求结果调用相应回调: 如果请求 + 成功, 则调用onsuccess回调, 失败则调用 onerror 回调 +
+ request(PlainObject ajaxOptions) + + 是 + + 根据给定的参数项发起一个ajax请求, 参数项里必须包含一个url地址。 ajax请求完成后,会根据请求结果调用相应回调: 如果请求 + 成功, 则调用onsuccess回调, 失败则调用 onerror 回调。 +
+
+ + + + +
+ +
+ + + + 模块成员详细描述(UE.ajax) + +
+ + + + + +
+
+

request(URLString url, PlainObject ajaxOptions)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 根据给定的参数项,向指定的url发起一个ajax请求。 ajax请求完成后,会根据请求结果调用相应回调: 如果请求 + 成功, 则调用onsuccess回调, 失败则调用 onerror 回调 +
+ + + + + +
+
+ 所属模块: UE.ajax +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ url + + URLString + + ajax请求的url地址 +
+ ajaxOptions + + PlainObject + + ajax请求选项的key-value对象,支持的选项如下: +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
 //向sayhello.php发起一个异步的Ajax GET请求, 请求超时时间为10s, 请求完成后执行相应的回调。
+ UE.ajax.requeset( 'sayhello.php', {
+
+     //请求方法。可选值: 'GET', 'POST',默认值是'POST'
+     method: 'GET',
+
+     //超时时间。 默认为5000, 单位是ms
+     timeout: 10000,
+
+     //是否是异步请求。 true为异步请求, false为同步请求
+     async: true,
+
+     //请求携带的数据。如果请求为GET请求, data会经过stringify后附加到请求url之后。
+     data: {
+         name: 'ueditor'
+     },
+
+     //请求成功后的回调, 该回调接受当前的XMLHttpRequest对象作为参数。
+     onsuccess: function ( xhr ) {
+         console.log( xhr.responseText );
+     },
+
+     //请求失败或者超时后的回调。
+     onerror: function ( xhr ) {
+          alert( 'Ajax请求失败' );
+     }
+
+ } );
+
+
+
+ +
+ + +
+
+
+

request(PlainObject ajaxOptions)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 根据给定的参数项发起一个ajax请求, 参数项里必须包含一个url地址。 ajax请求完成后,会根据请求结果调用相应回调: 如果请求 + 成功, 则调用onsuccess回调, 失败则调用 onerror 回调。 +
+ + + + + + +
    +
  • + 警告: 如果在参数项里未提供一个key为“url”的地址值,则该请求将直接退出。 +
  • +
+ + + + +
+
+ 所属模块: UE.ajax +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ ajaxOptions + + PlainObject + + ajax请求选项的key-value对象,支持的选项如下: +
+
+ + + + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
+7
 //向sayhello.php发起一个异步的Ajax POST请求, 请求超时时间为5s, 请求完成后不执行任何回调。
+ UE.ajax.requeset( 'sayhello.php', {
+
+     //请求的地址, 该项是必须的。
+     url: 'sayhello.php'
+
+ } );
+
+
+
+ +
+ + +
+
+ + + +
+ +
+ + +
+ +
+ +
+ +
+
+

UE.dom.domUtils

+
+ 模块 +
+
+ +
+ +
+ 根据指定的判断规则判断给定的元素是否是一个空元素 +
+ + + + + +
+ +
+ +
+ + + + + + 方法列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
方法签名静态描述
+ getPosition(DomNode nodeA, DomNode nodeB) + + 是 + + 获取节点A相对于节点B的位置关系 +
+ getNodeIndex(DomNode node) + + 是 + + 检测节点node在父节点中的索引位置, 忽略文本节点 +
+ getNodeIndex(DomNode node, Boolean ignoreTextNode) + + 是 + + 检测节点node在父节点中的索引位置, 根据给定的ignoreTextNode参数决定是否要忽略文本节点 +
+ inDoc(DomNode node, DomNode doc) + + 是 + + 检测节点node是否在节点doc的树上,实质上是检测是否被doc包含 +
+ findParent(DomNode node) + + 是 + + 查找node节点的父节点,查找的过程中不包含自身节点。 +
+ findParent(DomNode node, Function filterFn) + + 是 + + 根据给定的过滤规则filterFn, 查找符合该过滤规则的node节点的祖先节点, + 查找的过程中不包含自身节点。 +
+ findParent(DomNode node, Function filterFn, Boolean includeSelf) + + 是 + + 根据给定的过滤规则filterFn, 查找符合该过滤规则的node节点的祖先节点, + 查找的过程中根据includeSelf的值决定是否包含自身节点。 +
+ findParentByTagName(DomNode node, Array tagNames) + + 是 + + 查找node的节点名为tagName的祖先节点, 查找过程中不包含node节点自身 +
+ findParentByTagName(DomNode node, Array tagNames, Boolean includeSelf) + + 是 + + 查找node的节点名为tagName的祖先节点, 查找过程中根据includeSelf的值决定是否包含node节点自身 +
+ findParentByTagName(DomNode node, Array tagNames, Boolean includeSelf, Function excludeFn) + + 是 + + 查找node的节点名为tagName的祖先节点,并且该祖先节点不满足excludeFn过滤器的过滤要求, + 查找过程中根据includeSelf的值决定是否包含node节点自身, +
+ insertAfter(DomNode node, DomNode newNode) + + 是 + + 在节点node后面插入新节点newNode +
+ remove(DomNode node) + + 是 + + 删除节点node及其下属的所有节点 +
+ remove(DomNode node, Boolean keepChildren) + + 是 + + 删除节点node,并根据keepChildren的值决定是否保留子节点 +
+ isBookmarkNode(DomNode node) + + 是 + + 检测节点node是否属是UEditor定义的bookmark节点 +
+ getWindow(DomNode node) + + 是 + + 获取节点node所属的window对象 +
+ getCommonAncestor(DomNode nodeA, DomNode nodeB) + + 是 + + 获取离nodeA与nodeB最近的公共的祖先节点 +
+ split(DomNode textNode, int offset) + + 是 + + 将一个文本节点textNode拆分成两个文本节点,offset指定拆分位置 +
+ isWhitespace(DomNode node) + + 是 + + 检测文本节点textNode是否为空节点(包括空格、换行、占位符等字符) +
+ getXY(DomNode element) + + 是 + + 获取元素element相对于viewport的位置坐标 +
+ on(DomNode element, String type, Function handler) + + 是 + + 为元素element绑定原生DOM事件,type为事件类型,handler为处理函数 +
+ on(DomNode element, Array type, Function handler) + + 是 + + 为元素element绑定原生DOM事件,type为事件类型,handler为处理函数 +
+ un(DomNode element, String type, Function handler) + + 是 + + 解除DOM事件绑定 +
+ un(DomNode element, Array type, Function handler) + + 是 + + 解除DOM事件绑定 +
+ isSameElement(DomNode nodeA, DomNode nodeB) + + 是 + + 比较节点nodeA与节点nodeB是否具有相同的标签名、属性名以及属性值 +
+ isSameStyle(DomNode nodeA, DomNode nodeB) + + 是 + + 判断节点nodeA与节点nodeB的元素的style属性是否一致 +
+ isBlockElm(DomNode node) + + 是 + + 检查节点node是否为block元素 +
+ isBody(DomElement node) + + 是 + + 检测node节点是否为body节点 +
+ trimWhiteTextNode(DomElement node) + + 是 + + 删除node节点下首尾两端的空白文本子节点 +
+ mergeToParent(DomElement node) + + 是 + + 将节点node提取到父节点上 +
+ mergeSibling(DomElement node) + + 是 + + 合并节点node的左右兄弟节点 +
+ mergeSibling(DomElement node, Boolean ignorePre) + + 是 + + 合并节点node的左右兄弟节点, 可以根据给定的条件选择是否忽略合并左节点。 +
+ mergeSibling(DomElement node, Boolean ignorePre, Boolean ignoreNext) + + 是 + + 合并节点node的左右兄弟节点,可以根据给定的条件选择是否忽略合并左右节点。 +
+ unSelectable(DomElement node) + + 是 + + 设置节点node及其子节点不会被选中 +
+ removeAttributes(String attrNames) + + 是 + + 删除节点node上的指定属性名称的属性 +
+ removeAttributes(Array attrNames) + + 是 + + 删除节点node上的指定属性名称的属性 +
+ createElement(DomDocument doc, String tagName, PlainObject attrs) + + 是 + + 在doc下创建一个标签名为tag,属性为attrs的元素 +
+ setAttributes(DomElement node, KeyValueMap attrs) + + 是 + + 为节点node添加属性attrs,attrs为属性键值对 +
+ getComputedStyle(DomElement element, String styleName) + + 是 + + 获取元素element经过计算后的样式值 +
+ removeClasses(DomElement ele, String classNames) + + 是 + + 删除元素element指定的className +
+ removeClasses(DomElement ele, Array classNames) + + 是 + + 删除元素element指定的className +
+ addClass(DomNode ele, String classNames) + + 是 + + 给元素element添加className +
+ addClass(DomNode ele, Array classNames) + + 是 + + 给元素element添加className +
+ hasClass(DomNode ele, String classNames) + + 是 + + 判断元素element是否包含给定的样式类名className +
+ hasClass(DomNode ele, Array classNames) + + 是 + + 判断元素element是否包含给定的样式类名className +
+ preventDefault(Event evt) + + 是 + + 阻止事件默认行为 +
+ removeStyle(DomElement element, String styleName) + + 是 + + 删除元素element指定的样式 +
+ getStyle(DomElement element, String styleName) + + 是 + + 获取元素element的style属性的指定值 +
+ setStyle(DomElement element, String styleName, String styleValue) + + 是 + + 为元素element设置样式属性值 +
+ setStyles(DomElement element, KeyValueMap styles) + + 是 + + 为元素element设置多个样式属性值 +
+ getChildCount(DomElement node) + + 是 + + 获取子节点的数量 +
+ getChildCount(DomElement node, Function fn) + + 是 + + 根据给定的过滤规则, 获取符合条件的子节点的数量 +
+ isEmptyNode(DomNode node) + + 是 + + 判断给定节点是否为空节点 +
+ clearSelectedArr(Array nodes) + + 是 + + 清空给定节点所有的className +
+ isBr(DomNode node) + + 是 + + 判断给定节点是否为br +
+ setViewportOffset(DomElement element, KeyValueMap offset) + + 是 + + 移动元素使得该元素的位置移动指定的偏移量的距离 +
+ fillNode(DomDocument doc, DomNode node) + + 是 + + 用“填充字符”填充节点 +
+ moveChild(DomNode src, DomNode tag) + + 是 + + 把节点src的所有子节点追加到另一个节点tag上去 +
+ moveChild(DomNode src, DomNode tag, Boolean dir) + + 是 + + 把节点src的所有子节点移动到另一个节点tag上去, 可以通过dir参数控制附加的行为是“追加”还是“插入顶部” +
+ hasNoAttributes(DomNode node) + + 是 + + 判断节点的标签上是否不存在任何属性 +
+ isCustomeNode(DomNode node) + + 是 + + 检测节点是否是UEditor所使用的辅助节点 +
+ isTagNode(DomNode node, String tagName) + + 是 + + 检测节点的标签是否是给定的标签 +
+ filterNodeList(Array nodeList, Function fn) + + 是 + + 给定一个节点数组,在通过指定的过滤器过滤后, 获取其中满足过滤条件的第一个节点 +
+ filterNodeList(Array nodeList, String tagNames) + + 是 + + 给定一个节点数组nodeList和一组标签名tagNames, 获取其中能够匹配标签名的节点集合中的第一个节点 +
+ filterNodeList(Array nodeList, Function fn, Boolean forAll) + + 是 + + 给定一个节点数组,在通过指定的过滤器过滤后, 如果参数forAll为true, 则会返回所有满足过滤 + 条件的节点集合, 否则, 返回满足条件的节点集合中的第一个节点 +
+
+ + + + +
+ +
+ + + + 模块成员详细描述(UE.dom.domUtils) + +
+ + + + + +
+
+

getPosition(DomNode nodeA, DomNode nodeB)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取节点A相对于节点B的位置关系 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ nodeA + + DomNode + + 需要查询位置关系的节点A +
+ nodeB + + DomNode + + 需要查询位置关系的节点B +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Number + + 节点A与节点B的关系 +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
 //output: 20
+ var position = UE.dom.domUtils.getPosition( document.documentElement, document.body );
+
+ switch ( position ) {
+
+      case 0:
+          console.log('相等,同一节点');
+          break;
+      case 1:
+          console.log('无关,节点不相连');
+          break;
+      case 2:
+          console.log('跟随,即节点A头部位于节点B头部的后面');
+          break;
+      case 4;
+          console.log('前置,即节点A头部位于节点B头部的前面');
+          break;
+      case 8:
+          console.log('被包含,即节点A被节点B包含');
+          break;
+      case 10:
+          console.log('组合类型,即节点A满足跟随节点B且被节点B包含。');
+          break;
+      case 16:
+          console.log('包含,即节点A包含节点B');
+          break;
+      case 20:
+          console.log('组合类型,即节点A满足前置节点A且包含节点B。');
+          break;
+
+ }
+
+
+
+ +
+ + +
+
+
+

getNodeIndex(DomNode node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测节点node在父节点中的索引位置, 忽略文本节点 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要检测的节点对象 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Number + + 该节点在父节点中的位置 +
+
+ + + + +
+
+
+

getNodeIndex(DomNode node, Boolean ignoreTextNode)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测节点node在父节点中的索引位置, 根据给定的ignoreTextNode参数决定是否要忽略文本节点 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要检测的节点对象 +
+ ignoreTextNode + + Boolean + + 是否忽略文本节点 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Number + + 该节点在父节点中的位置 +
+
+ + + + +
+
+
+

inDoc(DomNode node, DomNode doc)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测节点node是否在节点doc的树上,实质上是检测是否被doc包含 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要检测的节点对象 +
+ doc + + DomNode + + 需要检测的节点对象 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + doc节点是否包含node节点 +
+
+ + + + +
+
+
+

findParent(DomNode node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 查找node节点的父节点,查找的过程中不包含自身节点。 +
+ + + + + + +
    +
  • + 警告: 查找的终点是到body节点为止 +
  • +
+ + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要查找的节点 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomNode | Null + + 如果该节点有父节点就返回该父节点, 否则返回NULL +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
 //因为查找的终点是body标签,所以查找body的父节点将返回NULL
+ var parentNode = UE.dom.domUtils.findParent( document.body );
+ //output: true
+ console.log( parentNode === null )
+
+
+
+ +
+
1
+2
+3
 var parentNode = UE.dom.domUtils.findParent( document.body.firstChild );
+ //output: BODY
+ console.log( parentNode.tagName );
+
+
+
+ +
+ + +
+
+
+

findParent(DomNode node, Function filterFn)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 根据给定的过滤规则filterFn, 查找符合该过滤规则的node节点的祖先节点, + 查找的过程中不包含自身节点。 +
+ + + + +
    +
  • + 提示: 自定义的过滤方法filterFn接受一个DomNode对象作为参数, 该对象代表当前执行检测的节点。 如果该 + 节点满足过滤条件, 则要求返回true, 否则, 请返回false。 +
  • +
+ + + + + + + +
    +
  • + 警告: 查找的终点是到body节点为止 +
  • +
+ + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要查找的节点 +
+ filterFn + + Function + + 自定义的过滤方法。 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomNode | Null + + 如果找到符合过滤条件的节点, 就返回该节点, 否则返回NULL +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
+7
+8
+9
 var filterNode = UE.dom.domUtils.findParent( document.body.firstChild, function ( node ) {
+
+     //由于查找的终点是body节点, 所以永远也不会匹配当前过滤器的条件, 即这里永远会返回false
+     return node.tagName === "HTML";
+
+ } );
+
+ //output: true
+ console.log( filterNode === null );
+
+
+
+ +
+ + +
+
+
+

findParent(DomNode node, Function filterFn, Boolean includeSelf)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 根据给定的过滤规则filterFn, 查找符合该过滤规则的node节点的祖先节点, + 查找的过程中根据includeSelf的值决定是否包含自身节点。 +
+ + + + +
    +
  • + 提示: 自定义的过滤方法filterFn接受一个DomNode对象作为参数, 该对象代表当前执行检测的节点。 如果该 + 节点满足过滤条件, 则要求返回true, 否则, 请返回false。 +
  • +
+ +
    +
  • + 提示: 如果includeSelf为true, 则过滤器第一次执行时的参数会是节点本身。 + 反之, 过滤器第一次执行时的参数将是该节点的父节点。 +
  • +
+ + + + + + + +
    +
  • + 警告: 查找的终点是到body节点为止 +
  • +
+ + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要查找的节点 +
+ filterFn + + Function + + 自定义的过滤方法。 +
+ includeSelf + + Boolean + + 查找过程是否包含自身 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomNode | Null + + 如果找到符合过滤条件的节点, 就返回该节点, 否则返回NULL +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
 <body>
+
+      <div id="test">
+      </div>
+
+      <script type="text/javascript">
+
+          //output: DIV, BODY
+          var filterNode = UE.dom.domUtils.findParent( document.getElementById( "test" ), function ( node ) {
+
+              console.log( node.tagName );
+              return false;
+
+          }, true );
+
+      </script>
+ </body>
+
+
+
+ +
+ + +
+
+
+

findParentByTagName(DomNode node, Array tagNames)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 查找node的节点名为tagName的祖先节点, 查找过程中不包含node节点自身 +
+ + + + + + +
    +
  • + 警告: 查找的终点是到body节点为止 +
  • +
+ + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要查找的节点对象 +
+ tagNames + + Array + + 需要查找的父节点的名称数组 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomNode | NULL + + 如果找到符合条件的节点, 则返回该节点, 否则返回NULL +
+
+ + + + + + + 示例 + +
+
1
+2
+3
 var node = UE.dom.domUtils.findParentByTagName( document.getElementsByTagName("div")[0], [ "BODY" ] );
+ //output: BODY
+ console.log( node.tagName );
+
+
+
+ +
+ + +
+
+
+

findParentByTagName(DomNode node, Array tagNames, Boolean includeSelf)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 查找node的节点名为tagName的祖先节点, 查找过程中根据includeSelf的值决定是否包含node节点自身 +
+ + + + + + +
    +
  • + 警告: 查找的终点是到body节点为止 +
  • +
+ + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要查找的节点对象 +
+ tagNames + + Array + + 需要查找的父节点的名称数组 +
+ includeSelf + + Boolean + + 查找过程是否包含node节点自身 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomNode | NULL + + 如果找到符合条件的节点, 则返回该节点, 否则返回NULL +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
 var queryTarget = document.getElementsByTagName("div")[0];
+ var node = UE.dom.domUtils.findParentByTagName( queryTarget, [ "DIV" ], true );
+ //output: true
+ console.log( queryTarget === node );
+
+
+
+ +
+ + +
+
+
+

findParentByTagName(DomNode node, Array tagNames, Boolean includeSelf, Function excludeFn)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 查找node的节点名为tagName的祖先节点,并且该祖先节点不满足excludeFn过滤器的过滤要求, + 查找过程中根据includeSelf的值决定是否包含node节点自身, +
+ + + + +
    +
  • + 提示: 查找过滤器excludeFn要求对不应该被匹配的节点应该返回true +
  • +
+ + + + + + + +
    +
  • + 警告: 查找的终点是到body节点为止 +
  • +
+ + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要查找的节点对象 +
+ tagNames + + Array + + 需要查找的父节点的名称数组 +
+ includeSelf + + Boolean + + 查找过程是否包含node节点自身 +
+ excludeFn + + Function + + 查找过程中应用的过滤器, 如果该过滤器对给定的节点返回true, + 则该节点将被排除在查询结果之外。 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomNode | NULL + + 如果找到符合条件的节点, 则返回该节点, 否则返回NULL +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
 var queryTarget = document.getElementsByTagName("div")[0];
+
+ //需要查找的节点和过滤器的过滤条件刚好冲突, 执行结果将永远为NULL
+ var node = UE.dom.domUtils.findParentByTagName( queryTarget, [ "DIV" ], false, function ( node ) {
+
+      return node.tagName.toLowerCase() === 'div';
+
+ } );
+ //output: true
+ console.log( queryTarget === null );
+
+
+
+ +
+ + +
+
+
+

insertAfter(DomNode node, DomNode newNode)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 在节点node后面插入新节点newNode +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 目标节点 +
+ newNode + + DomNode + + 新插入的节点, 该节点将置于目标节点之后 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomNode + + 新插入的节点 +
+
+ + + + +
+
+
+

remove(DomNode node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 删除节点node及其下属的所有节点 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要删除的节点对象 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomNode + + 返回刚删除的节点对象 +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
+7
+8
 <div id="test">
+     <div id="child">你好</div>
+ </div>
+ <script>
+     UE.dom.domUtils.remove( document.body, false );
+     //output: false
+     console.log( document.getElementById( "child" ) !== null );
+ </script>
+
+
+
+ +
+ + +
+
+
+

remove(DomNode node, Boolean keepChildren)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 删除节点node,并根据keepChildren的值决定是否保留子节点 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要删除的节点对象 +
+ keepChildren + + Boolean + + 是否需要保留子节点 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomNode + + 返回刚删除的节点对象 +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
+7
+8
 <div id="test">
+     <div id="child">你好</div>
+ </div>
+ <script>
+     UE.dom.domUtils.remove( document.body, true );
+     //output: true
+     console.log( document.getElementById( "child" ) !== null );
+ </script>
+
+
+
+ +
+ + +
+
+
+

isBookmarkNode(DomNode node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测节点node是否属是UEditor定义的bookmark节点 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要检测的节点对象 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 是否是bookmark节点 +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
 <span id="_baidu_bookmark_1"></span>
+ <script>
+      var bookmarkNode = document.getElementById("_baidu_bookmark_1");
+      //output: true
+      console.log( UE.dom.domUtils.isBookmarkNode( bookmarkNode ) );
+ </script>
+
+
+
+ +
+ + +
+
+
+

getWindow(DomNode node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取节点node所属的window对象 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 节点对象 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Window + + 当前节点所属的window对象 +
+
+ + + + + + + 示例 + +
+
1
+2
 //output: true
+ console.log( UE.dom.domUtils.getWindow( document.body ) === window );
+
+
+
+ +
+ + +
+
+
+

getCommonAncestor(DomNode nodeA, DomNode nodeB)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取离nodeA与nodeB最近的公共的祖先节点 +
+ + + + +
    +
  • + 提示: 如果给定的两个节点是同一个节点, 将直接返回该节点。 +
  • +
+ + + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ nodeA + + DomNode + + 第一个节点 +
+ nodeB + + DomNode + + 第二个节点 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomNode | NULL + + 如果未找到公共节点, 返回NULL, 否则返回最近的公共祖先节点。 +
+
+ + + + + + + 示例 + +
+
1
+2
+3
 var commonAncestor = UE.dom.domUtils.getCommonAncestor( document.body, document.body.firstChild );
+ //output: true
+ console.log( commonAncestor.tagName.toLowerCase() === 'body' );
+
+
+
+ +
+ + +
+
+
+

split(DomNode textNode, int offset)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 将一个文本节点textNode拆分成两个文本节点,offset指定拆分位置 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ textNode + + DomNode + + 需要拆分的文本节点对象 +
+ offset + + int + + 需要拆分的位置, 位置计算从0开始 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomNode + + 拆分后形成的新节点 +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
 <div id="test">abcdef</div>
+ <script>
+      var newNode = UE.dom.domUtils.split( document.getElementById( "test" ), 3 );
+      //output: def
+      console.log( newNode.nodeValue );
+ </script>
+
+
+
+ +
+ + +
+
+
+

isWhitespace(DomNode node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测文本节点textNode是否为空节点(包括空格、换行、占位符等字符) +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要检测的节点对象 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 检测的节点是否为空 +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
+7
 <div id="test">
+
+ </div>
+ <script>
+      //output: true
+      console.log( UE.dom.domUtils.isWhitespace( document.getElementById("test").firstChild ) );
+ </script>
+
+
+
+ +
+ + +
+
+
+

getXY(DomNode element)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取元素element相对于viewport的位置坐标 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ element + + DomNode + + 需要计算位置的节点对象 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ PlainObject + + 返回形如{x:left,y:top}的一个key-value映射对象, 其中键x代表水平偏移距离, + y代表垂直偏移距离。 +
+
+ + + + + + + 示例 + +
+
1
+2
+3
 var location = UE.dom.domUtils.getXY( document.getElementById("test") );
+ //output: test的坐标为: 12, 24
+ console.log( 'test的坐标为: ', location.x, ',', location.y );
+
+
+
+ +
+ + +
+
+
+

on(DomNode element, String type, Function handler)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 为元素element绑定原生DOM事件,type为事件类型,handler为处理函数 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ element + + DomNode + + 需要绑定事件的节点对象 +
+ type + + String + + 绑定的事件类型 +
+ handler + + Function + + 事件处理器 +
+
+ + + + + + + + + 示例 + +
+
1
+2
+3
 UE.dom.domUtils.on(document.body,"click",function(e){
+     //e为事件对象,this为被点击元素对戏那个
+ });
+
+
+
+ +
+ + +
+
+
+

on(DomNode element, Array type, Function handler)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 为元素element绑定原生DOM事件,type为事件类型,handler为处理函数 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ element + + DomNode + + 需要绑定事件的节点对象 +
+ type + + Array + + 绑定的事件类型数组 +
+ handler + + Function + + 事件处理器 +
+
+ + + + + + + + + 示例 + +
+
1
+2
+3
 UE.dom.domUtils.on(document.body,["click","mousedown"],function(evt){
+     //evt为事件对象,this为被点击元素对象
+ });
+
+
+
+ +
+ + +
+
+
+

un(DomNode element, String type, Function handler)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 解除DOM事件绑定 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ element + + DomNode + + 需要解除事件绑定的节点对象 +
+ type + + String + + 需要接触绑定的事件类型 +
+ handler + + Function + + 对应的事件处理器 +
+
+ + + + + + + + + 示例 + +
+
1
+2
+3
 UE.dom.domUtils.un(document.body,"click",function(evt){
+     //evt为事件对象,this为被点击元素对象
+ });
+
+
+
+ +
+ + +
+
+
+

un(DomNode element, Array type, Function handler)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 解除DOM事件绑定 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ element + + DomNode + + 需要解除事件绑定的节点对象 +
+ type + + Array + + 需要接触绑定的事件类型数组 +
+ handler + + Function + + 对应的事件处理器 +
+
+ + + + + + + + + 示例 + +
+
1
+2
+3
 UE.dom.domUtils.un(document.body, ["click","mousedown"],function(evt){
+     //evt为事件对象,this为被点击元素对象
+ });
+
+
+
+ +
+ + +
+
+
+

isSameElement(DomNode nodeA, DomNode nodeB)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 比较节点nodeA与节点nodeB是否具有相同的标签名、属性名以及属性值 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ nodeA + + DomNode + + 需要比较的节点 +
+ nodeB + + DomNode + + 需要比较的节点 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 两个节点是否具有相同的标签名、属性名以及属性值 +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
 <span style="font-size:12px">ssss</span>
+ <span style="font-size:12px">bbbbb</span>
+ <span style="font-size:13px">ssss</span>
+ <span style="font-size:14px">bbbbb</span>
+
+ <script>
+
+     var nodes = document.getElementsByTagName( "span" );
+
+     //output: true
+     console.log( UE.dom.domUtils.isSameElement( nodes[0], nodes[1] ) );
+
+     //output: false
+     console.log( UE.dom.domUtils.isSameElement( nodes[2], nodes[3] ) );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

isSameStyle(DomNode nodeA, DomNode nodeB)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 判断节点nodeA与节点nodeB的元素的style属性是否一致 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ nodeA + + DomNode + + 需要比较的节点 +
+ nodeB + + DomNode + + 需要比较的节点 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 两个节点是否具有相同的style属性值 +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
 <span style="font-size:12px">ssss</span>
+ <span style="font-size:12px">bbbbb</span>
+ <span style="font-size:13px">ssss</span>
+ <span style="font-size:14px">bbbbb</span>
+
+ <script>
+
+     var nodes = document.getElementsByTagName( "span" );
+
+     //output: true
+     console.log( UE.dom.domUtils.isSameElement( nodes[0], nodes[1] ) );
+
+     //output: false
+     console.log( UE.dom.domUtils.isSameElement( nodes[2], nodes[3] ) );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

isBlockElm(DomNode node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检查节点node是否为block元素 +
+ + + + + + +
    +
  • + 警告: 该方法的判断规则如下: 如果该元素原本是block元素, 则不论该元素当前的css样式是什么都会返回true; + 否则,检测该元素的css样式, 如果该元素当前是block元素, 则返回true。 其余情况下都返回false。 +
  • +
+ + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要检测的节点对象 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 是否是block元素节点 +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
 <span id="test1" style="display: block"></span>
+ <span id="test2"></span>
+ <div id="test3" style="display: inline"></div>
+
+ <script>
+
+     //output: true
+     console.log( UE.dom.domUtils.isBlockEle( document.getElementById("test1") ) );
+
+     //output: false
+     console.log( UE.dom.domUtils.isBlockEle( document.getElementById("test2") ) );
+
+     //output: true
+     console.log( UE.dom.domUtils.isBlockEle( document.getElementById("test3") ) );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

isBody(DomElement node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测node节点是否为body节点 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomElement + + 需要检测的dom元素 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 给定的元素是否是body元素 +
+
+ + + + + + + 示例 + +
+
1
+2
 //output: true
+ console.log( UE.dom.domUtils.isBody( document.body ) );
+
+
+
+ +
+ + +
+
+
+

trimWhiteTextNode(DomElement node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 删除node节点下首尾两端的空白文本子节点 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomElement + + 需要执行删除操作的元素对象 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
 <div id="test">
+     <div></div>
+ </div>
+
+ <script>
+     var testNode = document.getElementById("test");
+     //output: 3
+     console.log(testNode.childNodes.length);
+
+     UE.dom.domUtils.trimWhiteTextNode( testNode );
+     //output: 1
+     console.log(testNode.childNodes.length);
+ </script>
+
+
+
+ +
+ + +
+
+
+

mergeToParent(DomElement node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 将节点node提取到父节点上 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomElement + + 需要提取的元素对象 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
 <div id="parent">
+     <div id="sub">
+         <span id="child"></span>
+     </div>
+ </div>
+
+ <script>
+
+     var child = document.getElementById( "child" );
+
+     //output: sub
+     console.log( child.parentNode.id );
+
+     UE.dom.domUtils.mergeToParent( child );
+
+     //output: parent
+     console.log( child.parentNode.id );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

mergeSibling(DomElement node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 合并节点node的左右兄弟节点 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomElement + + 需要合并的目标节点 +
+
+ + + + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
+7
+8
 <b>xxxx</b><b id="test">ooo</b><b>xxxx</b>
+
+ <script>
+     var demoNode = document.getElementById("test");
+     UE.dom.domUtils.mergeSibling( demoNode );
+     //output: xxxxoooxxxx
+     console.log( demoNode.innerHTML );
+ </script>
+
+
+
+ +
+ + +
+
+
+

mergeSibling(DomElement node, Boolean ignorePre)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 合并节点node的左右兄弟节点, 可以根据给定的条件选择是否忽略合并左节点。 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomElement + + 需要合并的目标节点 +
+ ignorePre + + Boolean + + 是否忽略合并左节点 +
+
+ + + + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
+7
+8
 <b>xxxx</b><b id="test">ooo</b><b>xxxx</b>
+
+ <script>
+     var demoNode = document.getElementById("test");
+     UE.dom.domUtils.mergeSibling( demoNode, true );
+     //output: oooxxxx
+     console.log( demoNode.innerHTML );
+ </script>
+
+
+
+ +
+ + +
+
+
+

mergeSibling(DomElement node, Boolean ignorePre, Boolean ignoreNext)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 合并节点node的左右兄弟节点,可以根据给定的条件选择是否忽略合并左右节点。 +
+ + + + +
    +
  • + 提示: 如果同时忽略左右节点, 则该操作什么也不会做 +
  • +
+ + + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomElement + + 需要合并的目标节点 +
+ ignorePre + + Boolean + + 是否忽略合并左节点 +
+ ignoreNext + + Boolean + + 是否忽略合并右节点 +
+
+ + + + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
+7
+8
 <b>xxxx</b><b id="test">ooo</b><b>xxxx</b>
+
+ <script>
+     var demoNode = document.getElementById("test");
+     UE.dom.domUtils.mergeSibling( demoNode, false, true );
+     //output: xxxxooo
+     console.log( demoNode.innerHTML );
+ </script>
+
+
+
+ +
+ + +
+
+
+

unSelectable(DomElement node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 设置节点node及其子节点不会被选中 +
+ + + + +
    +
  • + 提示: 执行该操作后的节点, 将不能被鼠标选中 +
  • +
+ + + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomElement + + 需要执行操作的dom元素 +
+
+ + + + + + + + + 示例 + +
+
1
 UE.dom.domUtils.unSelectable( document.body );
+
+
+
+ +
+ + +
+
+
+

removeAttributes(String attrNames)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 删除节点node上的指定属性名称的属性 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ attrNames + + String + + 可以是空格隔开的多个属性名称,该操作将会依次删除相应的属性 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
 <div id="wrap">
+      <span style="font-size:14px;" id="test" name="followMe">xxxxx</span>
+ </div>
+
+ <script>
+
+     UE.dom.domUtils.removeAttributes( document.getElementById( "test" ), "id name" );
+
+     //output: <span style="font-size:14px;">xxxxx</span>
+     console.log( document.getElementById("wrap").innerHTML );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

removeAttributes(Array attrNames)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 删除节点node上的指定属性名称的属性 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ attrNames + + Array + + 需要删除的属性名数组 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
 <div id="wrap">
+      <span style="font-size:14px;" id="test" name="followMe">xxxxx</span>
+ </div>
+
+ <script>
+
+     UE.dom.domUtils.removeAttributes( document.getElementById( "test" ), ["id", "name"] );
+
+     //output: <span style="font-size:14px;">xxxxx</span>
+     console.log( document.getElementById("wrap").innerHTML );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

createElement(DomDocument doc, String tagName, PlainObject attrs)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 在doc下创建一个标签名为tag,属性为attrs的元素 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ doc + + DomDocument + + 新创建的元素属于该document节点创建 +
+ tagName + + String + + 需要创建的元素的标签名 +
+ attrs + + PlainObject + + 新创建的元素的属性key-value集合 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomElement + + 新创建的元素对象 +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
+7
+8
+9
 var ele = UE.dom.domUtils.createElement( document, 'div', {
+     id: 'test'
+ } );
+
+ //output: DIV
+ console.log( ele.tagName );
+
+ //output: test
+ console.log( ele.id );
+
+
+
+ +
+ + +
+
+
+

setAttributes(DomElement node, KeyValueMap attrs)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 为节点node添加属性attrs,attrs为属性键值对 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomElement + + 需要设置属性的元素对象 +
+ attrs + + KeyValueMap + + 需要设置的属性名-值对 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomElement + + 设置属性的元素对象 +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
 <span id="test"></span>
+
+ <script>
+
+     var testNode = UE.dom.domUtils.setAttributes( document.getElementById( "test" ), {
+         id: 'demo'
+     } );
+
+     //output: demo
+     console.log( testNode.id );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

getComputedStyle(DomElement element, String styleName)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取元素element经过计算后的样式值 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ element + + DomElement + + 需要获取样式的元素对象 +
+ styleName + + String + + 需要获取的样式名 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ String + + 获取到的样式值 +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
 <style type="text/css">
+      #test {
+          font-size: 15px;
+      }
+ </style>
+
+ <span id="test"></span>
+
+ <script>
+     //output: 15px
+     console.log( UE.dom.domUtils.getComputedStyle( document.getElementById( "test" ), 'font-size' ) );
+ </script>
+
+
+
+ +
+ + +
+
+
+

removeClasses(DomElement ele, String classNames)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 删除元素element指定的className +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ ele + + DomElement + + 需要删除class的元素节点 +
+ classNames + + String + + 需要删除的className, 多个className之间以空格分开 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
 <span id="test" class="test1 test2 test3">xxx</span>
+
+ <script>
+
+     var testNode = document.getElementById( "test" );
+     UE.dom.domUtils.removeClasses( testNode, "test1 test2" );
+
+     //output: test3
+     console.log( testNode.className );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

removeClasses(DomElement ele, Array classNames)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 删除元素element指定的className +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ ele + + DomElement + + 需要删除class的元素节点 +
+ classNames + + Array + + 需要删除的className数组 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
 <span id="test" class="test1 test2 test3">xxx</span>
+
+ <script>
+
+     var testNode = document.getElementById( "test" );
+     UE.dom.domUtils.removeClasses( testNode, ["test1", "test2"] );
+
+     //output: test3
+     console.log( testNode.className );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

addClass(DomNode ele, String classNames)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 给元素element添加className +
+ + + + +
    +
  • + 提示: 相同的类名不会被重复添加 +
  • +
+ + + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ ele + + DomNode + + 需要增加className的元素 +
+ classNames + + String + + 需要添加的className, 多个className之间以空格分割 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
 <span id="test" class="cls1 cls2"></span>
+
+ <script>
+     var testNode = document.getElementById("test");
+
+     UE.dom.domUtils.addClass( testNode, "cls2 cls3 cls4" );
+
+     //output: cl1 cls2 cls3 cls4
+     console.log( testNode.className );
+
+ <script>
+
+
+
+ +
+ + +
+
+
+

addClass(DomNode ele, Array classNames)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 给元素element添加className +
+ + + + +
    +
  • + 提示: 相同的类名不会被重复添加 +
  • +
+ + + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ ele + + DomNode + + 需要增加className的元素 +
+ classNames + + Array + + 需要添加的className的数组 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
 <span id="test" class="cls1 cls2"></span>
+
+ <script>
+     var testNode = document.getElementById("test");
+
+     UE.dom.domUtils.addClass( testNode, ["cls2", "cls3", "cls4"] );
+
+     //output: cl1 cls2 cls3 cls4
+     console.log( testNode.className );
+
+ <script>
+
+
+
+ +
+ + +
+
+
+

hasClass(DomNode ele, String classNames)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 判断元素element是否包含给定的样式类名className +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ ele + + DomNode + + 需要检测的元素 +
+ classNames + + String + + 需要检测的className, 多个className之间用空格分割 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 元素是否包含所有给定的className +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
 <span id="test1" class="cls1 cls2"></span>
+
+ <script>
+     var test1 = document.getElementById("test1");
+
+     //output: false
+     console.log( UE.dom.domUtils.hasClass( test1, "cls2 cls1 cls3" ) );
+
+     //output: true
+     console.log( UE.dom.domUtils.hasClass( test1, "cls2 cls1" ) );
+ </script>
+
+
+
+ +
+ + +
+
+
+

hasClass(DomNode ele, Array classNames)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 判断元素element是否包含给定的样式类名className +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ ele + + DomNode + + 需要检测的元素 +
+ classNames + + Array + + 需要检测的className数组 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 元素是否包含所有给定的className +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
 <span id="test1" class="cls1 cls2"></span>
+
+ <script>
+     var test1 = document.getElementById("test1");
+
+     //output: false
+     console.log( UE.dom.domUtils.hasClass( test1, [ "cls2", "cls1", "cls3" ] ) );
+
+     //output: true
+     console.log( UE.dom.domUtils.hasClass( test1, [ "cls2", "cls1" ]) );
+ </script>
+
+
+
+ +
+ + +
+
+
+

preventDefault(Event evt)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 阻止事件默认行为 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ evt + + Event + + 需要阻止默认行为的事件对象 +
+
+ + + + + + + + + 示例 + +
+
1
 UE.dom.domUtils.preventDefault( evt );
+
+
+
+ +
+ + +
+
+
+

removeStyle(DomElement element, String styleName)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 删除元素element指定的样式 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ element + + DomElement + + 需要删除样式的元素 +
+ styleName + + String + + 需要删除的样式名 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
 <span id="test" style="color: red; background: blue;"></span>
+
+ <script>
+
+     var testNode = document.getElementById("test");
+
+     UE.dom.domUtils.removeStyle( testNode, 'color' );
+
+     //output: background: blue;
+     console.log( testNode.style.cssText );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

getStyle(DomElement element, String styleName)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取元素element的style属性的指定值 +
+ + + + + + +
    +
  • + 警告: 该方法仅获取元素style属性中所标明的值 +
  • +
+ + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ element + + DomElement + + 需要获取属性值的元素 +
+ styleName + + String + + 需要获取的style的名称 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ String + + 该元素包含指定的style属性值 +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
 <div id="test" style="color: red;"></div>
+
+ <script>
+
+      var testNode = document.getElementById( "test" );
+
+      //output: red
+      console.log( UE.dom.domUtils.getStyle( testNode, "color" ) );
+
+      //output: ""
+      console.log( UE.dom.domUtils.getStyle( testNode, "background" ) );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

setStyle(DomElement element, String styleName, String styleValue)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 为元素element设置样式属性值 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ element + + DomElement + + 需要设置样式的元素 +
+ styleName + + String + + 样式名 +
+ styleValue + + String + + 样式值 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
 <div id="test"></div>
+
+ <script>
+
+      var testNode = document.getElementById( "test" );
+
+      //output: ""
+      console.log( testNode.style.color );
+
+      UE.dom.domUtils.setStyle( testNode, 'color', 'red' );
+      //output: "red"
+      console.log( testNode.style.color );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

setStyles(DomElement element, KeyValueMap styles)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 为元素element设置多个样式属性值 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ element + + DomElement + + 需要设置样式的元素 +
+ styles + + KeyValueMap + + 样式名值对 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
 <div id="test"></div>
+
+ <script>
+
+      var testNode = document.getElementById( "test" );
+
+      //output: ""
+      console.log( testNode.style.color );
+
+      UE.dom.domUtils.setStyles( testNode, {
+          'color': 'red'
+      } );
+      //output: "red"
+      console.log( testNode.style.color );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

getChildCount(DomElement node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 获取子节点的数量 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomElement + + 需要检测的元素 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Number + + 给定的node元素的子节点数量 +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
 <div id="test">
+      <span></span>
+ </div>
+
+ <script>
+
+     //output: 3
+     console.log( UE.dom.domUtils.getChildCount( document.getElementById("test") ) );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

getChildCount(DomElement node, Function fn)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 根据给定的过滤规则, 获取符合条件的子节点的数量 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomElement + + 需要检测的元素 +
+ fn + + Function + + 过滤器, 要求对符合条件的子节点返回true, 反之则要求返回false +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Number + + 符合过滤条件的node元素的子节点数量 +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
 <div id="test">
+      <span></span>
+ </div>
+
+ <script>
+
+     //output: 1
+     console.log( UE.dom.domUtils.getChildCount( document.getElementById("test"), function ( node ) {
+
+         return node.nodeType === 1;
+
+     } ) );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

isEmptyNode(DomNode node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 判断给定节点是否为空节点 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要检测的节点对象 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 节点是否为空 +
+
+ + + + + + + 示例 + +
+
1
 UE.dom.domUtils.isEmptyNode( document.body );
+
+
+
+ +
+ + +
+
+
+

clearSelectedArr(Array nodes)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 清空给定节点所有的className +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ nodes + + Array + + 需要清空className的节点的数组集合 +
+
+ + + + + + + + + 示例 + +
+
1
 UE.dom.domUtils.clearSelectedArr( [ document.body, document.body.firstChild ] );
+
+
+
+ +
+ + +
+
+
+

isBr(DomNode node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 判断给定节点是否为br +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要判断的节点对象 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 给定的节点是否是br节点 +
+
+ + + + +
+
+
+

setViewportOffset(DomElement element, KeyValueMap offset)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 移动元素使得该元素的位置移动指定的偏移量的距离 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ element + + DomElement + + 需要设置偏移量的元素 +
+ offset + + KeyValueMap + + 偏移量, 形如{ left: 100, top: 50 }的一个键值对, 表示该元素将在 + 现有的位置上向水平方向偏移offset.left的距离, 在竖直方向上偏移 + offset.top的距离 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
 <div id="test" style="top: 100px; left: 50px; position: absolute;"></div>
+
+ <script>
+
+     var testNode = document.getElementById("test");
+
+     UE.dom.domUtils.setViewportOffset( testNode, {
+         left: 200,
+         top: 50
+     } );
+
+     //output: top: 300px; left: 100px; position: absolute;
+     console.log( testNode.style.cssText );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

fillNode(DomDocument doc, DomNode node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 用“填充字符”填充节点 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ doc + + DomDocument + + 填充的节点所在的docment对象 +
+ node + + DomNode + + 需要填充的节点对象 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
 <div id="test"></div>
+
+ <script>
+     var testNode = document.getElementById("test");
+
+     //output: 0
+     console.log( testNode.childNodes.length );
+
+     UE.dom.domUtils.fillNode( document, testNode );
+
+     //output: 1
+     console.log( testNode.childNodes.length );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

moveChild(DomNode src, DomNode tag)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 把节点src的所有子节点追加到另一个节点tag上去 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ src + + DomNode + + 源节点, 该节点下的所有子节点将被移除 +
+ tag + + DomNode + + 目标节点, 从源节点移除的子节点将被追加到该节点下 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
 <div id="test1">
+      <span></span>
+ </div>
+ <div id="test2">
+     <div></div>
+ </div>
+
+ <script>
+
+     var test1 = document.getElementById("test1"),
+         test2 = document.getElementById("test2");
+
+     UE.dom.domUtils.moveChild( test1, test2 );
+
+     //output: ""(空字符串)
+     console.log( test1.innerHTML );
+
+     //output: "<div></div><span></span>"
+     console.log( test2.innerHTML );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

moveChild(DomNode src, DomNode tag, Boolean dir)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 把节点src的所有子节点移动到另一个节点tag上去, 可以通过dir参数控制附加的行为是“追加”还是“插入顶部” +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ src + + DomNode + + 源节点, 该节点下的所有子节点将被移除 +
+ tag + + DomNode + + 目标节点, 从源节点移除的子节点将被附加到该节点下 +
+ dir + + Boolean + + 附加方式, 如果为true, 则附加进去的节点将被放到目标节点的顶部, 反之,则放到末尾 +
+
+ + + + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20
+21
 <div id="test1">
+      <span></span>
+ </div>
+ <div id="test2">
+     <div></div>
+ </div>
+
+ <script>
+
+     var test1 = document.getElementById("test1"),
+         test2 = document.getElementById("test2");
+
+     UE.dom.domUtils.moveChild( test1, test2, true );
+
+     //output: ""(空字符串)
+     console.log( test1.innerHTML );
+
+     //output: "<span></span><div></div>"
+     console.log( test2.innerHTML );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

hasNoAttributes(DomNode node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 判断节点的标签上是否不存在任何属性 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要检测的节点对象 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 节点是否不包含任何属性 +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
 <div id="test"><span>xxxx</span></div>
+
+ <script>
+
+     //output: false
+     console.log( UE.dom.domUtils.hasNoAttributes( document.getElementById("test") ) );
+
+     //output: true
+     console.log( UE.dom.domUtils.hasNoAttributes( document.getElementById("test").firstChild ) );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

isCustomeNode(DomNode node)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测节点是否是UEditor所使用的辅助节点 +
+ + + + +
    +
  • + 提示: 辅助节点是指编辑器要完成工作临时添加的节点, 在输出的时候将会从编辑器内移除, 不会影响最终的结果。 +
  • +
+ + + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要检测的节点 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 给定的节点是否是一个辅助节点 +
+
+ + + + +
+
+
+

isTagNode(DomNode node, String tagName)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 检测节点的标签是否是给定的标签 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ node + + DomNode + + 需要检测的节点对象 +
+ tagName + + String + + 标签 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Boolean + + 节点的标签是否是给定的标签 +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
+7
+8
 <div id="test"></div>
+
+ <script>
+
+     //output: true
+     console.log( UE.dom.domUtils.isTagNode( document.getElementById("test"), "div" ) );
+
+ </script>
+
+
+
+ +
+ + +
+
+
+

filterNodeList(Array nodeList, Function fn)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 给定一个节点数组,在通过指定的过滤器过滤后, 获取其中满足过滤条件的第一个节点 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ nodeList + + Array + + 需要过滤的节点数组 +
+ fn + + Function + + 过滤器, 对符合条件的节点, 执行结果返回true, 反之则返回false +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomNode | NULL + + 如果找到符合过滤条件的节点, 则返回该节点, 否则返回NULL +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
+5
+6
+7
 var divNodes = document.getElementsByTagName("div");
+ divNodes = [].slice.call( divNodes, 0 );
+
+ //output: null
+ console.log( UE.dom.domUtils.filterNodeList( divNodes, function ( node ) {
+     return node.tagName.toLowerCase() !== 'div';
+ } ) );
+
+
+
+ +
+ + +
+
+
+

filterNodeList(Array nodeList, String tagNames)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 给定一个节点数组nodeList和一组标签名tagNames, 获取其中能够匹配标签名的节点集合中的第一个节点 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ nodeList + + Array + + 需要过滤的节点数组 +
+ tagNames + + String + + 需要匹配的标签名, 多个标签名之间用空格分割 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ DomNode | NULL + + 如果找到标签名匹配的节点, 则返回该节点, 否则返回NULL +
+
+ + + + + + + 示例 + +
+
1
+2
+3
+4
+5
 var divNodes = document.getElementsByTagName("div");
+ divNodes = [].slice.call( divNodes, 0 );
+
+ //output: null
+ console.log( UE.dom.domUtils.filterNodeList( divNodes, 'a span' ) );
+
+
+
+ +
+ + +
+
+
+

filterNodeList(Array nodeList, Function fn, Boolean forAll)

+
+ 方法 + + 静态 + +
+ + + 1.2.6.1 + + +
+ +
+ +
+ 给定一个节点数组,在通过指定的过滤器过滤后, 如果参数forAll为true, 则会返回所有满足过滤 + 条件的节点集合, 否则, 返回满足条件的节点集合中的第一个节点 +
+ + + + + +
+
+ 所属模块: UE.dom.domUtils +
+ +
+ +
+ +
+ + + + + + + 参数列表 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
参数名类型描述
+ nodeList + + Array + + 需要过滤的节点数组 +
+ fn + + Function + + 过滤器, 对符合条件的节点, 执行结果返回true, 反之则返回false +
+ forAll + + Boolean + + 是否返回整个节点数组, 如果该参数为false, 则返回节点集合中的第一个节点 +
+
+ + + + + + + 返回值 + + + + + + + + + + + + + +
类型描述
+ Array | DomNode | NULL + + 如果找到符合过滤条件的节点, 则根据参数forAll的值决定返回满足 + 过滤条件的节点数组或第一个节点, 否则返回NULL +
+
+ + + + + + + 示例 + +
+
 1
+ 2
+ 3
+ 4
+ 5
+ 6
+ 7
+ 8
+ 9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
 var divNodes = document.getElementsByTagName("div");
+ divNodes = [].slice.call( divNodes, 0 );
+
+ //output: 3(假定有3个div)
+ console.log( divNodes.length );
+
+ var nodes = UE.dom.domUtils.filterNodeList( divNodes, function ( node ) {
+     return node.tagName.toLowerCase() === 'div';
+ }, true );
+
+ //output: 3
+ console.log( nodes.length );
+
+ var node = UE.dom.domUtils.filterNodeList( divNodes, function ( node ) {
+     return node.tagName.toLowerCase() === 'div';
+ }, false );
+
+ //output: div
+ console.log( node.nodeName );
+
+
+
+ +
+ + +
+
+ + + +
+ +
+ + +
+ +
+ +
+ +
+ + + + + Ctrl + Q 可以打开搜索框 + + \ No newline at end of file diff --git a/docs/images/bg.png b/docs/images/bg.png new file mode 100644 index 0000000000000000000000000000000000000000..90ee6934dd8d0c334ea38a0a74e32bdec2b7dba0 GIT binary patch literal 2108 zcmV-C2*dY@P)5A&Zg|w;|A<;OML(S zeJ?j`bDz)ae!m;JwY%MIAb zjo)-PyEc9nZrHxQefxGRGGm_-&Vbv-?a#jLd4r~(Z&TlBZ!AAsP2S_yo88>J>3iI) zjoEtMY>dI)SkIgNZmt!*6bB*N%lrQD>hW-{Wah@v$@^))-}#IxksNUv58wFq`SVH7wtW6%(U4sfotRe z=>1uM_!&5Og5C0HzZ|wDH$N$p%gqu39N7TugqS-EDP1Z6>$mfoDiZ$z`NLypep&{$ z1b%BvmT9&L(_SEWp7g0@it!?De4@7Y^pm!+iR73Zo~F%)8GHvcp`#WKP*U)+FyQiS>Ga)Gm~36IQTt2LN`sHW3q zK_ujfJ7$?SSc=OdVfJVCL7WIpQn0{d94J!qJhJ8(3Zb#G1Z#7cVjx!(3<*vw70KL7 zIt(gDxS>*ZFi|pc5(fYfa7cB!24~^8!ruZ&e`bIYib3EN2^1=P``v)Ue{db-*&2(K z$#K|j_Ejki?^FF+Vg8a3VJe7Q4(m=JX&V5ebUNshGq5c;lx0C@_QANo7hHDJNk(HP z{D+(gA$B*Ir4Y%siicr`O8WrpKIkUYxG=kW;^-8KtBkL|uH3_P5Ue)TGL%dNiX+Ew zIcf1=Jm3valo0zCemSp1?}oP;&kgcl?B1SNHIX|NACci&3UI{6AIt*z|5oMS6v-IK z09j&6DQ@0KA&x>1x;mFW;@he|hnqx`%b{M`Q={r?ENUe1{h`*i=7ccZ*c`3Z2J%=ZGroFaW%4;=QMyZemR9!HUKkukF?MPIyCqyL^(gAsT&r@ zQj8K;61o<0qTv^3;?gp|ZqYDilvrCux^RzA+Bo!iBq_8;>tv;qn9^8|5HUTl5iO+~ z+oEhOm!@+5rf%&GC8VTipjI8|ql-_KE6xB5smgG$s|s2B+NX=VFbM|?6*ZPryrD%Y z%(f$+3@seHLmeKpRgZ*o3-%9O{;I%H4`?-oc z^}`P(PPLeg5pN$qeyr2_=LWDM9a}>BRMBW;E(#ElG$_z%CRNod*iA^xe3Wf-YJ#i( z8eBa>TiiX`gt3)2dnwT(Ph}W2RMh#2opdtZ03PA9Ls6cr@8MN|Kt;$*ysnjBJH`Lk zE<=mb7B^mCn}zrrT4)cTx%`1yMynXnX(g5;IaQ%;!_Hg@&!qNn+V=LPT0Gs0ZmLh6 z@U+?dU2#R7-C`$Ri0zt3wHx$y($tn=BRkj;ET8HzuXIpw?YSk*;crcI8_`E1Tu4=6 zk-(i6iKAa<1y|(C5~}Nqn71WEPko|71YuI-kZdpCb7x}GRbF%)Qg2=pAvr*Bzf%!G zpfm>5MH--qst>a(x$ZZQS=T*GUR7Hx4*?G&&LpT6lj=k) z`vBVQSkQE=#&dPc&pQ(AC~3nknQJb7?=a8yhM;L&spha4rySG=Tz6ok zbpj7+0&>5eZFC~iA*VJd*yXl%01c>Y%jg=z4lih**!FE~{v(1*rW&bh9~@=GVfg9) zwxhgvKLZ*U+IBfRsybQWXdwQbLP>6pAqfylh#{fb6;Z(vMMVS~$e@S=j*ftg6;Uhf59&ghTmgWD0l;*T zI709Y^p6lP1rIRMx#05C~cW=H_Aw*bJ-5DT&Z2n+x)QHX^p z00esgV8|mQcmRZ%02D^@S3L16t`O%c004NIvOKvYIYoh62rY33S640`D9%Y2D-rV&neh&#Q1i z007~1e$oCcFS8neI|hJl{-P!B1ZZ9hpmq0)X0i`JwE&>$+E?>%_LC6RbVIkUx0b+_+BaR3cnT7Zv!AJxW zizFb)h!jyGOOZ85F;a?DAXP{m@;!0_IfqH8(HlgRxt7s3}k3K`kFu>>-2Q$QMFfPW!La{h336o>X zu_CMttHv6zR;&ZNiS=X8v3CR#fknUxHUxJ0uoBa_M6WNWeqIg~6QE69c9o#eyhGvpiOA@W-aonk<7r1(?fC{oI5N*U!4 zfg=2N-7=cNnjjOr{yriy6mMFgG#l znCF=fnQv8CDz++o6_Lscl}eQ+l^ZHARH>?_s@|##Rr6KLRFA1%Q+=*RRWnoLsR`7U zt5vFIcfW3@?wFpwUVxrVZ>QdQz32KIeJ}k~{cZZE^+ya? z2D1z#2HOnI7(B%_ac?{wFUQ;QQA1tBKtrWrm0_3Rgps+?Jfqb{jYbcQX~taRB;#$y zZN{S}1|}gUOHJxc?wV3fxuz+mJ4`!F$IZ;mqRrNsHJd##*D~ju=bP7?-?v~|cv>vB zsJ6IeNwVZxrdjT`yl#bBIa#GxRa#xMMy;K#CDyyGyQdMSxlWT#tDe?p!?5wT$+oGt z8L;Kp2HUQ-ZMJ=3XJQv;x5ci*?vuTfeY$;({XGW_huIFR9a(?@3)XSs8O^N5RyOM=TTmp(3=8^+zpz2r)C z^>JO{deZfso3oq3?Wo(Y?l$ge?uXo;%ru`Vo>?<<(8I_>;8Eq#KMS9gFl*neeosSB zfoHYnBQIkwkyowPu(zdms`p{<7e4kra-ZWq<2*OsGTvEV%s0Td$hXT+!*8Bnh2KMe zBmZRodjHV?r+_5^X9J0WL4jKW`}lf%A-|44I@@LTvf1rHjG(ze6+w@Jt%Bvjts!X0 z?2xS?_ve_-kiKB_KiJlZ$9G`c^=E@oNG)mWWaNo-3TIW8)$Hg0Ub-~8?KhvJ>$ z3*&nim@mj(aCxE5!t{lw7O5^0EIO7zOo&c6l<+|iDySBWCGrz@C5{St!X3hAA}`T4 z(TLbXTq+(;@<=L8dXnssyft|w#WSTW<++3>sgS%(4NTpeI-VAqb|7ssJvzNHgOZVu zaYCvgO_R1~>SyL=cFU|~g|hy|Zi}}s9+d~lYqOB71z9Z$wnC=pR9Yz4DhIM>Wmjgu z&56o6maCpC&F##y%G;1PobR9i?GnNg;gYtchD%p19a!eQtZF&3JaKv33gZ<8D~47E ztUS1iwkmDaPpj=$m#%)jCVEY4fnLGNg2A-`YwHVD3gv};>)hAvT~AmqS>Lr``i7kw zJ{5_It`yrBmlc25DBO7E8;5VoznR>Ww5hAaxn$2~(q`%A-YuS64wkBy=9dm`4cXeX z4c}I@?e+FW+b@^RDBHV(wnMq2zdX3SWv9u`%{xC-q*U}&`cyXV(%rRT*Z6MH?i+i& z_B8C(+grT%{XWUQ+f@NoP1R=AW&26{v-dx)iK^-Nmiuj8txj!m?Z*Ss1N{dh4z}01 z)YTo*JycSU)+_5r4#yw9{+;i4Ee$peRgIj+;v;ZGdF1K$3E%e~4LaI(jC-u%2h$&R z9cLXcYC@Xwnns&bn)_Q~Te?roKGD|d-g^8;+aC{{G(1^(O7m37Y1-+6)01cN&y1aw zoqc{T`P^XJqPBbIW6s}d4{z_f5Om?vMgNQEJG?v2T=KYd^0M3I6IZxbny)%vZR&LD zJpPl@Psh8QyPB@KTx+@RdcC!KX7}kEo;S|j^u2lU7XQ}Oo;f|;z4Ll+_r>@1-xl3| zawq-H%e&ckC+@AhPrP6BKT#_XdT7&;F71j}Joy zkC~6lh7E@6o;W@^IpRNZ{ptLtL(gQ-CY~4mqW;US7Zxvm_|@yz&e53Bp_lTPlfP|z zrTyx_>lv@x#=^!PzR7qqF<$gm`|ZJZ+;<)Cqu&ot2z=0000WV@Og>004R=004l4008;_004mL004C`008P>0026e000+nl3&F} z0003>NklI2K9GtP(VZv`m7?NAMG)UW(2e3od`rQF8yAjML9r^- z%?*Uon4w8U=z;$#=icwj;bx$C?cyG{*fiiez&AP}-)IgBzTX9pOYBq)-%EhUCAO-9 zH&ftIKC3tr+Zo|e+Sn)yzJ;$G@VLZkzwpg4(oVs&(I^Vv2pe?zOdBhC;cF$q;}Z3( z@J7k-C?8l#gRfKskMfSiBzV1Ic$7CRbi2t1Yk15%^gO~=Lro@VWbKO zz|=1ir`=D&MUU~+dOWUq1Yo9z#97k2-~=zY3?o#608EEHUvb>;7qW;zVvYFY8VU>r th64XmpjGf%X|= MAX_COUNT ) { + return false; + } + + if ( item.toLowerCase().indexOf( searchText ) !== -1 ) { + + result.push( item ); + + } + + } ); + + return result; + + }, + + escapeRegexp: function ( input ) { + + return input.replace( /[\.\\\/\*\?\+\[\(\)\]\{\}\^\$\|]/g, function ( match ) { + return '\\' + match; + } ); + + } + + }; + + function AutoComplete () { + this.panel = new Panel(); + this.source = null; + + this._lastInput = ""; + this._inputBox = null; + this._selectIndex = -1; + this._matchCount = 0; + this._inputValue = ""; + } + + $.extend( AutoComplete.prototype, { + + setSource: function ( source ) { + this.source = source; + }, + + bindInput: function ( inputBox ) { + + var _self = this, + $inputBox = $( inputBox ); + + this._inputBox = $inputBox; + this.panel.bind( $inputBox ); + + this.panel.onselect( function ( index, title ) { + + _self.to( title ); + + } ); + + $inputBox.on( "oninput" in document.body ? "input" : "keyup", function ( evt ) { + + _self._inputValue = this.value; + + if ( !Util.hasChange( _self._inputValue, _self._lastInput ) ) { + return ; + } + + _self._lastInput = _self._inputValue; + + _self.search( _self._inputValue ); + + } ).on( "click", function () { + + return false; + + } ).on( "keydown", function ( evt ) { + + if ( evt.ctrlKey && evt.keyCode === 81 ) { + $( document ).trigger( 'togglepanel' ); + return false; + } + + if ( evt.keyCode === 13 ) { + + _self.to( this.value ); + return; + + } + + if ( !_self.panel.showState ) { + return; + } + + //down + if ( evt.keyCode === 40 ) { + + _self._selectIndex = ++_self._selectIndex; + + //up + } else if ( evt.keyCode === 38 ) { + + _self._selectIndex = _self._selectIndex === -1 ? + _self._selectIndex + _self._matchCount : _self._selectIndex - 1; + + //do search + } else { + return; + } + + _self.select( _self._selectIndex ); + + return false; + + } ); + + }, + + select: function ( index ) { + + this.panel.change( index ); + + //设置搜索框值 + if ( index > -1 && index < this._matchCount ) { + this._inputBox.val( this.panel.getTitle( index ) ); + } else { + this._inputBox.val( this._inputValue ); + this._selectIndex = -1; + } + + }, + + search: function ( searchText ) { + + this.render( searchText, Util.getMatchText( searchText, this.source ) ); + + }, + + to: function ( anchor ) { + anchor && ( location.hash = anchor ); + this.clear(); + this._inputBox.trigger( "close" ); + }, + + render: function ( searchText, items ) { + + this._matchCount = items.length; + this.panel.render( this._getItemHtml( searchText, items ) ).show(); + + }, + + hide: function () { + + this.panel.hide(); + + this._lastInput = ""; + this._selectIndex = -1; + this._matchCount = 0; + + }, + + clear: function () { + this.hide(); + this.panel.clear(); + + this._inputValue = ""; + }, + + _getItemHtml: function ( searchText, items ) { + + var htmlStr = [], + pattern = new RegExp( Util.escapeRegexp( searchText ), 'i' ); + + if ( !items.length ) { + return '
  • 未找到匹配的内容
'; + } + + $.each( items, function ( index, item ) { + + htmlStr.push( '' + item.replace( pattern, function ( match ) { + + return '' + match + ''; + + } ) + '' ); + + } ); + + return '
  • '+ htmlStr.join( '
  • ' ) +'
'; + + } + + } ); + + function Panel () { + + this.showState = false; + + this._input = null; + this._panel = $( '
' ); + this._callbacks = []; + + this.selectStyle = "background: #f0f0f0"; + + } + + $.extend( Panel.prototype, { + + bind: function ( $inputBox ) { + + var _self = this; + + this._input = $inputBox; + + $inputBox.parent().append( this._panel ); + + this._panel.delegate( ".search-result-item", "click", function () { + + var $this = $( this ), + selectIndex = $this.attr( "data-index" ), + title = $this.text(); + + $.each( _self._callbacks, function ( index, callback ) { + + callback( selectIndex, title ); + + } ); + + _self.hide(); + + return false; + + } ); + + return this; + + }, + + render: function ( htmlStr ) { + + this._panel.html( htmlStr ); + + return this; + + }, + + clear: function () { + this._panel.html( "" ); + this._input.val( "" ); + }, + + change: function ( itemIndex ) { + var $items = this._panel.find( ".search-result-item" ).css( "background", "" ); + $items[ itemIndex ] && ( $items[ itemIndex ].style.cssText = this.selectStyle ); + }, + + onselect: function ( callback ) { + + this._callbacks.push( callback ); + + }, + + getTitle: function ( itemIndex ) { + return $( this._panel.find( ".search-result-item" )[ itemIndex ] ).text(); + }, + + show: function () { + + this.showState = true; + + this._panel.css( { + width: this._input.outerWidth(), + top: this._input.position().top + this._input.innerHeight(), + left: this._input.position().left + } ); + + this._panel.show(); + + }, + + hide: function () { + + this.showState = false; + this._panel.hide(); + + return this; + + } + + } ); + + window.AutoComplete = AutoComplete; + +} )(); \ No newline at end of file diff --git a/docs/scripts/jquery-1.10.2.js b/docs/scripts/jquery-1.10.2.js new file mode 100644 index 000000000..c5c648255 --- /dev/null +++ b/docs/scripts/jquery-1.10.2.js @@ -0,0 +1,9789 @@ +/*! + * jQuery JavaScript Library v1.10.2 + * http://jquery.com/ + * + * Includes Sizzle.js + * http://sizzlejs.com/ + * + * Copyright 2005, 2013 jQuery Foundation, Inc. and other contributors + * Released under the MIT license + * http://jquery.org/license + * + * Date: 2013-07-03T13:48Z + */ +(function( window, undefined ) { + +// Can't do this because several apps including ASP.NET trace +// the stack via arguments.caller.callee and Firefox dies if +// you try to trace through "use strict" call chains. (#13335) +// Support: Firefox 18+ +//"use strict"; +var + // The deferred used on DOM ready + readyList, + + // A central reference to the root jQuery(document) + rootjQuery, + + // Support: IE<10 + // For `typeof xmlNode.method` instead of `xmlNode.method !== undefined` + core_strundefined = typeof undefined, + + // Use the correct document accordingly with window argument (sandbox) + location = window.location, + document = window.document, + docElem = document.documentElement, + + // Map over jQuery in case of overwrite + _jQuery = window.jQuery, + + // Map over the $ in case of overwrite + _$ = window.$, + + // [[Class]] -> type pairs + class2type = {}, + + // List of deleted data cache ids, so we can reuse them + core_deletedIds = [], + + core_version = "1.10.2", + + // Save a reference to some core methods + core_concat = core_deletedIds.concat, + core_push = core_deletedIds.push, + core_slice = core_deletedIds.slice, + core_indexOf = core_deletedIds.indexOf, + core_toString = class2type.toString, + core_hasOwn = class2type.hasOwnProperty, + core_trim = core_version.trim, + + // Define a local copy of jQuery + jQuery = function( selector, context ) { + // The jQuery object is actually just the init constructor 'enhanced' + return new jQuery.fn.init( selector, context, rootjQuery ); + }, + + // Used for matching numbers + core_pnum = /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source, + + // Used for splitting on whitespace + core_rnotwhite = /\S+/g, + + // Make sure we trim BOM and NBSP (here's looking at you, Safari 5.0 and IE) + rtrim = /^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g, + + // A simple way to check for HTML strings + // Prioritize #id over to avoid XSS via location.hash (#9521) + // Strict HTML recognition (#11290: must start with <) + rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]*))$/, + + // Match a standalone tag + rsingleTag = /^<(\w+)\s*\/?>(?:<\/\1>|)$/, + + // JSON RegExp + rvalidchars = /^[\],:{}\s]*$/, + rvalidbraces = /(?:^|:|,)(?:\s*\[)+/g, + rvalidescape = /\\(?:["\\\/bfnrt]|u[\da-fA-F]{4})/g, + rvalidtokens = /"[^"\\\r\n]*"|true|false|null|-?(?:\d+\.|)\d+(?:[eE][+-]?\d+|)/g, + + // Matches dashed string for camelizing + rmsPrefix = /^-ms-/, + rdashAlpha = /-([\da-z])/gi, + + // Used by jQuery.camelCase as callback to replace() + fcamelCase = function( all, letter ) { + return letter.toUpperCase(); + }, + + // The ready event handler + completed = function( event ) { + + // readyState === "complete" is good enough for us to call the dom ready in oldIE + if ( document.addEventListener || event.type === "load" || document.readyState === "complete" ) { + detach(); + jQuery.ready(); + } + }, + // Clean-up method for dom ready events + detach = function() { + if ( document.addEventListener ) { + document.removeEventListener( "DOMContentLoaded", completed, false ); + window.removeEventListener( "load", completed, false ); + + } else { + document.detachEvent( "onreadystatechange", completed ); + window.detachEvent( "onload", completed ); + } + }; + +jQuery.fn = jQuery.prototype = { + // The current version of jQuery being used + jquery: core_version, + + constructor: jQuery, + init: function( selector, context, rootjQuery ) { + var match, elem; + + // HANDLE: $(""), $(null), $(undefined), $(false) + if ( !selector ) { + return this; + } + + // Handle HTML strings + if ( typeof selector === "string" ) { + if ( selector.charAt(0) === "<" && selector.charAt( selector.length - 1 ) === ">" && selector.length >= 3 ) { + // Assume that strings that start and end with <> are HTML and skip the regex check + match = [ null, selector, null ]; + + } else { + match = rquickExpr.exec( selector ); + } + + // Match html or make sure no context is specified for #id + if ( match && (match[1] || !context) ) { + + // HANDLE: $(html) -> $(array) + if ( match[1] ) { + context = context instanceof jQuery ? context[0] : context; + + // scripts is true for back-compat + jQuery.merge( this, jQuery.parseHTML( + match[1], + context && context.nodeType ? context.ownerDocument || context : document, + true + ) ); + + // HANDLE: $(html, props) + if ( rsingleTag.test( match[1] ) && jQuery.isPlainObject( context ) ) { + for ( match in context ) { + // Properties of context are called as methods if possible + if ( jQuery.isFunction( this[ match ] ) ) { + this[ match ]( context[ match ] ); + + // ...and otherwise set as attributes + } else { + this.attr( match, context[ match ] ); + } + } + } + + return this; + + // HANDLE: $(#id) + } else { + elem = document.getElementById( match[2] ); + + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document #6963 + if ( elem && elem.parentNode ) { + // Handle the case where IE and Opera return items + // by name instead of ID + if ( elem.id !== match[2] ) { + return rootjQuery.find( selector ); + } + + // Otherwise, we inject the element directly into the jQuery object + this.length = 1; + this[0] = elem; + } + + this.context = document; + this.selector = selector; + return this; + } + + // HANDLE: $(expr, $(...)) + } else if ( !context || context.jquery ) { + return ( context || rootjQuery ).find( selector ); + + // HANDLE: $(expr, context) + // (which is just equivalent to: $(context).find(expr) + } else { + return this.constructor( context ).find( selector ); + } + + // HANDLE: $(DOMElement) + } else if ( selector.nodeType ) { + this.context = this[0] = selector; + this.length = 1; + return this; + + // HANDLE: $(function) + // Shortcut for document ready + } else if ( jQuery.isFunction( selector ) ) { + return rootjQuery.ready( selector ); + } + + if ( selector.selector !== undefined ) { + this.selector = selector.selector; + this.context = selector.context; + } + + return jQuery.makeArray( selector, this ); + }, + + // Start with an empty selector + selector: "", + + // The default length of a jQuery object is 0 + length: 0, + + toArray: function() { + return core_slice.call( this ); + }, + + // Get the Nth element in the matched element set OR + // Get the whole matched element set as a clean array + get: function( num ) { + return num == null ? + + // Return a 'clean' array + this.toArray() : + + // Return just the object + ( num < 0 ? this[ this.length + num ] : this[ num ] ); + }, + + // Take an array of elements and push it onto the stack + // (returning the new matched element set) + pushStack: function( elems ) { + + // Build a new jQuery matched element set + var ret = jQuery.merge( this.constructor(), elems ); + + // Add the old object onto the stack (as a reference) + ret.prevObject = this; + ret.context = this.context; + + // Return the newly-formed element set + return ret; + }, + + // Execute a callback for every element in the matched set. + // (You can seed the arguments with an array of args, but this is + // only used internally.) + each: function( callback, args ) { + return jQuery.each( this, callback, args ); + }, + + ready: function( fn ) { + // Add the callback + jQuery.ready.promise().done( fn ); + + return this; + }, + + slice: function() { + return this.pushStack( core_slice.apply( this, arguments ) ); + }, + + first: function() { + return this.eq( 0 ); + }, + + last: function() { + return this.eq( -1 ); + }, + + eq: function( i ) { + var len = this.length, + j = +i + ( i < 0 ? len : 0 ); + return this.pushStack( j >= 0 && j < len ? [ this[j] ] : [] ); + }, + + map: function( callback ) { + return this.pushStack( jQuery.map(this, function( elem, i ) { + return callback.call( elem, i, elem ); + })); + }, + + end: function() { + return this.prevObject || this.constructor(null); + }, + + // For internal use only. + // Behaves like an Array's method, not like a jQuery method. + push: core_push, + sort: [].sort, + splice: [].splice +}; + +// Give the init function the jQuery prototype for later instantiation +jQuery.fn.init.prototype = jQuery.fn; + +jQuery.extend = jQuery.fn.extend = function() { + var src, copyIsArray, copy, name, options, clone, + target = arguments[0] || {}, + i = 1, + length = arguments.length, + deep = false; + + // Handle a deep copy situation + if ( typeof target === "boolean" ) { + deep = target; + target = arguments[1] || {}; + // skip the boolean and the target + i = 2; + } + + // Handle case when target is a string or something (possible in deep copy) + if ( typeof target !== "object" && !jQuery.isFunction(target) ) { + target = {}; + } + + // extend jQuery itself if only one argument is passed + if ( length === i ) { + target = this; + --i; + } + + for ( ; i < length; i++ ) { + // Only deal with non-null/undefined values + if ( (options = arguments[ i ]) != null ) { + // Extend the base object + for ( name in options ) { + src = target[ name ]; + copy = options[ name ]; + + // Prevent never-ending loop + if ( target === copy ) { + continue; + } + + // Recurse if we're merging plain objects or arrays + if ( deep && copy && ( jQuery.isPlainObject(copy) || (copyIsArray = jQuery.isArray(copy)) ) ) { + if ( copyIsArray ) { + copyIsArray = false; + clone = src && jQuery.isArray(src) ? src : []; + + } else { + clone = src && jQuery.isPlainObject(src) ? src : {}; + } + + // Never move original objects, clone them + target[ name ] = jQuery.extend( deep, clone, copy ); + + // Don't bring in undefined values + } else if ( copy !== undefined ) { + target[ name ] = copy; + } + } + } + } + + // Return the modified object + return target; +}; + +jQuery.extend({ + // Unique for each copy of jQuery on the page + // Non-digits removed to match rinlinejQuery + expando: "jQuery" + ( core_version + Math.random() ).replace( /\D/g, "" ), + + noConflict: function( deep ) { + if ( window.$ === jQuery ) { + window.$ = _$; + } + + if ( deep && window.jQuery === jQuery ) { + window.jQuery = _jQuery; + } + + return jQuery; + }, + + // Is the DOM ready to be used? Set to true once it occurs. + isReady: false, + + // A counter to track how many items to wait for before + // the ready event fires. See #6781 + readyWait: 1, + + // Hold (or release) the ready event + holdReady: function( hold ) { + if ( hold ) { + jQuery.readyWait++; + } else { + jQuery.ready( true ); + } + }, + + // Handle when the DOM is ready + ready: function( wait ) { + + // Abort if there are pending holds or we're already ready + if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { + return; + } + + // Make sure body exists, at least, in case IE gets a little overzealous (ticket #5443). + if ( !document.body ) { + return setTimeout( jQuery.ready ); + } + + // Remember that the DOM is ready + jQuery.isReady = true; + + // If a normal DOM Ready event fired, decrement, and wait if need be + if ( wait !== true && --jQuery.readyWait > 0 ) { + return; + } + + // If there are functions bound, to execute + readyList.resolveWith( document, [ jQuery ] ); + + // Trigger any bound ready events + if ( jQuery.fn.trigger ) { + jQuery( document ).trigger("ready").off("ready"); + } + }, + + // See test/unit/core.js for details concerning isFunction. + // Since version 1.3, DOM methods and functions like alert + // aren't supported. They return false on IE (#2968). + isFunction: function( obj ) { + return jQuery.type(obj) === "function"; + }, + + isArray: Array.isArray || function( obj ) { + return jQuery.type(obj) === "array"; + }, + + isWindow: function( obj ) { + /* jshint eqeqeq: false */ + return obj != null && obj == obj.window; + }, + + isNumeric: function( obj ) { + return !isNaN( parseFloat(obj) ) && isFinite( obj ); + }, + + type: function( obj ) { + if ( obj == null ) { + return String( obj ); + } + return typeof obj === "object" || typeof obj === "function" ? + class2type[ core_toString.call(obj) ] || "object" : + typeof obj; + }, + + isPlainObject: function( obj ) { + var key; + + // Must be an Object. + // Because of IE, we also have to check the presence of the constructor property. + // Make sure that DOM nodes and window objects don't pass through, as well + if ( !obj || jQuery.type(obj) !== "object" || obj.nodeType || jQuery.isWindow( obj ) ) { + return false; + } + + try { + // Not own constructor property must be Object + if ( obj.constructor && + !core_hasOwn.call(obj, "constructor") && + !core_hasOwn.call(obj.constructor.prototype, "isPrototypeOf") ) { + return false; + } + } catch ( e ) { + // IE8,9 Will throw exceptions on certain host objects #9897 + return false; + } + + // Support: IE<9 + // Handle iteration over inherited properties before own properties. + if ( jQuery.support.ownLast ) { + for ( key in obj ) { + return core_hasOwn.call( obj, key ); + } + } + + // Own properties are enumerated firstly, so to speed up, + // if last one is own, then all properties are own. + for ( key in obj ) {} + + return key === undefined || core_hasOwn.call( obj, key ); + }, + + isEmptyObject: function( obj ) { + var name; + for ( name in obj ) { + return false; + } + return true; + }, + + error: function( msg ) { + throw new Error( msg ); + }, + + // data: string of html + // context (optional): If specified, the fragment will be created in this context, defaults to document + // keepScripts (optional): If true, will include scripts passed in the html string + parseHTML: function( data, context, keepScripts ) { + if ( !data || typeof data !== "string" ) { + return null; + } + if ( typeof context === "boolean" ) { + keepScripts = context; + context = false; + } + context = context || document; + + var parsed = rsingleTag.exec( data ), + scripts = !keepScripts && []; + + // Single tag + if ( parsed ) { + return [ context.createElement( parsed[1] ) ]; + } + + parsed = jQuery.buildFragment( [ data ], context, scripts ); + if ( scripts ) { + jQuery( scripts ).remove(); + } + return jQuery.merge( [], parsed.childNodes ); + }, + + parseJSON: function( data ) { + // Attempt to parse using the native JSON parser first + if ( window.JSON && window.JSON.parse ) { + return window.JSON.parse( data ); + } + + if ( data === null ) { + return data; + } + + if ( typeof data === "string" ) { + + // Make sure leading/trailing whitespace is removed (IE can't handle it) + data = jQuery.trim( data ); + + if ( data ) { + // Make sure the incoming data is actual JSON + // Logic borrowed from http://json.org/json2.js + if ( rvalidchars.test( data.replace( rvalidescape, "@" ) + .replace( rvalidtokens, "]" ) + .replace( rvalidbraces, "")) ) { + + return ( new Function( "return " + data ) )(); + } + } + } + + jQuery.error( "Invalid JSON: " + data ); + }, + + // Cross-browser xml parsing + parseXML: function( data ) { + var xml, tmp; + if ( !data || typeof data !== "string" ) { + return null; + } + try { + if ( window.DOMParser ) { // Standard + tmp = new DOMParser(); + xml = tmp.parseFromString( data , "text/xml" ); + } else { // IE + xml = new ActiveXObject( "Microsoft.XMLDOM" ); + xml.async = "false"; + xml.loadXML( data ); + } + } catch( e ) { + xml = undefined; + } + if ( !xml || !xml.documentElement || xml.getElementsByTagName( "parsererror" ).length ) { + jQuery.error( "Invalid XML: " + data ); + } + return xml; + }, + + noop: function() {}, + + // Evaluates a script in a global context + // Workarounds based on findings by Jim Driscoll + // http://weblogs.java.net/blog/driscoll/archive/2009/09/08/eval-javascript-global-context + globalEval: function( data ) { + if ( data && jQuery.trim( data ) ) { + // We use execScript on Internet Explorer + // We use an anonymous function so that context is window + // rather than jQuery in Firefox + ( window.execScript || function( data ) { + window[ "eval" ].call( window, data ); + } )( data ); + } + }, + + // Convert dashed to camelCase; used by the css and data modules + // Microsoft forgot to hump their vendor prefix (#9572) + camelCase: function( string ) { + return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); + }, + + nodeName: function( elem, name ) { + return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); + }, + + // args is for internal usage only + each: function( obj, callback, args ) { + var value, + i = 0, + length = obj.length, + isArray = isArraylike( obj ); + + if ( args ) { + if ( isArray ) { + for ( ; i < length; i++ ) { + value = callback.apply( obj[ i ], args ); + + if ( value === false ) { + break; + } + } + } else { + for ( i in obj ) { + value = callback.apply( obj[ i ], args ); + + if ( value === false ) { + break; + } + } + } + + // A special, fast, case for the most common use of each + } else { + if ( isArray ) { + for ( ; i < length; i++ ) { + value = callback.call( obj[ i ], i, obj[ i ] ); + + if ( value === false ) { + break; + } + } + } else { + for ( i in obj ) { + value = callback.call( obj[ i ], i, obj[ i ] ); + + if ( value === false ) { + break; + } + } + } + } + + return obj; + }, + + // Use native String.trim function wherever possible + trim: core_trim && !core_trim.call("\uFEFF\xA0") ? + function( text ) { + return text == null ? + "" : + core_trim.call( text ); + } : + + // Otherwise use our own trimming functionality + function( text ) { + return text == null ? + "" : + ( text + "" ).replace( rtrim, "" ); + }, + + // results is for internal usage only + makeArray: function( arr, results ) { + var ret = results || []; + + if ( arr != null ) { + if ( isArraylike( Object(arr) ) ) { + jQuery.merge( ret, + typeof arr === "string" ? + [ arr ] : arr + ); + } else { + core_push.call( ret, arr ); + } + } + + return ret; + }, + + inArray: function( elem, arr, i ) { + var len; + + if ( arr ) { + if ( core_indexOf ) { + return core_indexOf.call( arr, elem, i ); + } + + len = arr.length; + i = i ? i < 0 ? Math.max( 0, len + i ) : i : 0; + + for ( ; i < len; i++ ) { + // Skip accessing in sparse arrays + if ( i in arr && arr[ i ] === elem ) { + return i; + } + } + } + + return -1; + }, + + merge: function( first, second ) { + var l = second.length, + i = first.length, + j = 0; + + if ( typeof l === "number" ) { + for ( ; j < l; j++ ) { + first[ i++ ] = second[ j ]; + } + } else { + while ( second[j] !== undefined ) { + first[ i++ ] = second[ j++ ]; + } + } + + first.length = i; + + return first; + }, + + grep: function( elems, callback, inv ) { + var retVal, + ret = [], + i = 0, + length = elems.length; + inv = !!inv; + + // Go through the array, only saving the items + // that pass the validator function + for ( ; i < length; i++ ) { + retVal = !!callback( elems[ i ], i ); + if ( inv !== retVal ) { + ret.push( elems[ i ] ); + } + } + + return ret; + }, + + // arg is for internal usage only + map: function( elems, callback, arg ) { + var value, + i = 0, + length = elems.length, + isArray = isArraylike( elems ), + ret = []; + + // Go through the array, translating each of the items to their + if ( isArray ) { + for ( ; i < length; i++ ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret[ ret.length ] = value; + } + } + + // Go through every key on the object, + } else { + for ( i in elems ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret[ ret.length ] = value; + } + } + } + + // Flatten any nested arrays + return core_concat.apply( [], ret ); + }, + + // A global GUID counter for objects + guid: 1, + + // Bind a function to a context, optionally partially applying any + // arguments. + proxy: function( fn, context ) { + var args, proxy, tmp; + + if ( typeof context === "string" ) { + tmp = fn[ context ]; + context = fn; + fn = tmp; + } + + // Quick check to determine if target is callable, in the spec + // this throws a TypeError, but we will just return undefined. + if ( !jQuery.isFunction( fn ) ) { + return undefined; + } + + // Simulated bind + args = core_slice.call( arguments, 2 ); + proxy = function() { + return fn.apply( context || this, args.concat( core_slice.call( arguments ) ) ); + }; + + // Set the guid of unique handler to the same of original handler, so it can be removed + proxy.guid = fn.guid = fn.guid || jQuery.guid++; + + return proxy; + }, + + // Multifunctional method to get and set values of a collection + // The value/s can optionally be executed if it's a function + access: function( elems, fn, key, value, chainable, emptyGet, raw ) { + var i = 0, + length = elems.length, + bulk = key == null; + + // Sets many values + if ( jQuery.type( key ) === "object" ) { + chainable = true; + for ( i in key ) { + jQuery.access( elems, fn, i, key[i], true, emptyGet, raw ); + } + + // Sets one value + } else if ( value !== undefined ) { + chainable = true; + + if ( !jQuery.isFunction( value ) ) { + raw = true; + } + + if ( bulk ) { + // Bulk operations run against the entire set + if ( raw ) { + fn.call( elems, value ); + fn = null; + + // ...except when executing function values + } else { + bulk = fn; + fn = function( elem, key, value ) { + return bulk.call( jQuery( elem ), value ); + }; + } + } + + if ( fn ) { + for ( ; i < length; i++ ) { + fn( elems[i], key, raw ? value : value.call( elems[i], i, fn( elems[i], key ) ) ); + } + } + } + + return chainable ? + elems : + + // Gets + bulk ? + fn.call( elems ) : + length ? fn( elems[0], key ) : emptyGet; + }, + + now: function() { + return ( new Date() ).getTime(); + }, + + // A method for quickly swapping in/out CSS properties to get correct calculations. + // Note: this method belongs to the css module but it's needed here for the support module. + // If support gets modularized, this method should be moved back to the css module. + swap: function( elem, options, callback, args ) { + var ret, name, + old = {}; + + // Remember the old values, and insert the new ones + for ( name in options ) { + old[ name ] = elem.style[ name ]; + elem.style[ name ] = options[ name ]; + } + + ret = callback.apply( elem, args || [] ); + + // Revert the old values + for ( name in options ) { + elem.style[ name ] = old[ name ]; + } + + return ret; + } +}); + +jQuery.ready.promise = function( obj ) { + if ( !readyList ) { + + readyList = jQuery.Deferred(); + + // Catch cases where $(document).ready() is called after the browser event has already occurred. + // we once tried to use readyState "interactive" here, but it caused issues like the one + // discovered by ChrisS here: http://bugs.jquery.com/ticket/12282#comment:15 + if ( document.readyState === "complete" ) { + // Handle it asynchronously to allow scripts the opportunity to delay ready + setTimeout( jQuery.ready ); + + // Standards-based browsers support DOMContentLoaded + } else if ( document.addEventListener ) { + // Use the handy event callback + document.addEventListener( "DOMContentLoaded", completed, false ); + + // A fallback to window.onload, that will always work + window.addEventListener( "load", completed, false ); + + // If IE event model is used + } else { + // Ensure firing before onload, maybe late but safe also for iframes + document.attachEvent( "onreadystatechange", completed ); + + // A fallback to window.onload, that will always work + window.attachEvent( "onload", completed ); + + // If IE and not a frame + // continually check to see if the document is ready + var top = false; + + try { + top = window.frameElement == null && document.documentElement; + } catch(e) {} + + if ( top && top.doScroll ) { + (function doScrollCheck() { + if ( !jQuery.isReady ) { + + try { + // Use the trick by Diego Perini + // http://javascript.nwbox.com/IEContentLoaded/ + top.doScroll("left"); + } catch(e) { + return setTimeout( doScrollCheck, 50 ); + } + + // detach all dom ready events + detach(); + + // and execute any waiting functions + jQuery.ready(); + } + })(); + } + } + } + return readyList.promise( obj ); +}; + +// Populate the class2type map +jQuery.each("Boolean Number String Function Array Date RegExp Object Error".split(" "), function(i, name) { + class2type[ "[object " + name + "]" ] = name.toLowerCase(); +}); + +function isArraylike( obj ) { + var length = obj.length, + type = jQuery.type( obj ); + + if ( jQuery.isWindow( obj ) ) { + return false; + } + + if ( obj.nodeType === 1 && length ) { + return true; + } + + return type === "array" || type !== "function" && + ( length === 0 || + typeof length === "number" && length > 0 && ( length - 1 ) in obj ); +} + +// All jQuery objects should point back to these +rootjQuery = jQuery(document); +/*! + * Sizzle CSS Selector Engine v1.10.2 + * http://sizzlejs.com/ + * + * Copyright 2013 jQuery Foundation, Inc. and other contributors + * Released under the MIT license + * http://jquery.org/license + * + * Date: 2013-07-03 + */ +(function( window, undefined ) { + +var i, + support, + cachedruns, + Expr, + getText, + isXML, + compile, + outermostContext, + sortInput, + + // Local document vars + setDocument, + document, + docElem, + documentIsHTML, + rbuggyQSA, + rbuggyMatches, + matches, + contains, + + // Instance-specific data + expando = "sizzle" + -(new Date()), + preferredDoc = window.document, + dirruns = 0, + done = 0, + classCache = createCache(), + tokenCache = createCache(), + compilerCache = createCache(), + hasDuplicate = false, + sortOrder = function( a, b ) { + if ( a === b ) { + hasDuplicate = true; + return 0; + } + return 0; + }, + + // General-purpose constants + strundefined = typeof undefined, + MAX_NEGATIVE = 1 << 31, + + // Instance methods + hasOwn = ({}).hasOwnProperty, + arr = [], + pop = arr.pop, + push_native = arr.push, + push = arr.push, + slice = arr.slice, + // Use a stripped-down indexOf if we can't use a native one + indexOf = arr.indexOf || function( elem ) { + var i = 0, + len = this.length; + for ( ; i < len; i++ ) { + if ( this[i] === elem ) { + return i; + } + } + return -1; + }, + + booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped", + + // Regular expressions + + // Whitespace characters http://www.w3.org/TR/css3-selectors/#whitespace + whitespace = "[\\x20\\t\\r\\n\\f]", + // http://www.w3.org/TR/css3-syntax/#characters + characterEncoding = "(?:\\\\.|[\\w-]|[^\\x00-\\xa0])+", + + // Loosely modeled on CSS identifier characters + // An unquoted value should be a CSS identifier http://www.w3.org/TR/css3-selectors/#attribute-selectors + // Proper syntax: http://www.w3.org/TR/CSS21/syndata.html#value-def-identifier + identifier = characterEncoding.replace( "w", "w#" ), + + // Acceptable operators http://www.w3.org/TR/selectors/#attribute-selectors + attributes = "\\[" + whitespace + "*(" + characterEncoding + ")" + whitespace + + "*(?:([*^$|!~]?=)" + whitespace + "*(?:(['\"])((?:\\\\.|[^\\\\])*?)\\3|(" + identifier + ")|)|)" + whitespace + "*\\]", + + // Prefer arguments quoted, + // then not containing pseudos/brackets, + // then attribute selectors/non-parenthetical expressions, + // then anything else + // These preferences are here to reduce the number of selectors + // needing tokenize in the PSEUDO preFilter + pseudos = ":(" + characterEncoding + ")(?:\\(((['\"])((?:\\\\.|[^\\\\])*?)\\3|((?:\\\\.|[^\\\\()[\\]]|" + attributes.replace( 3, 8 ) + ")*)|.*)\\)|)", + + // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter + rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + whitespace + "+$", "g" ), + + rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), + rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + "*" ), + + rsibling = new RegExp( whitespace + "*[+~]" ), + rattributeQuotes = new RegExp( "=" + whitespace + "*([^\\]'\"]*)" + whitespace + "*\\]", "g" ), + + rpseudo = new RegExp( pseudos ), + ridentifier = new RegExp( "^" + identifier + "$" ), + + matchExpr = { + "ID": new RegExp( "^#(" + characterEncoding + ")" ), + "CLASS": new RegExp( "^\\.(" + characterEncoding + ")" ), + "TAG": new RegExp( "^(" + characterEncoding.replace( "w", "w*" ) + ")" ), + "ATTR": new RegExp( "^" + attributes ), + "PSEUDO": new RegExp( "^" + pseudos ), + "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + whitespace + + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + whitespace + + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), + "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), + // For use in libraries implementing .is() + // We use this for POS matching in `select` + "needsContext": new RegExp( "^" + whitespace + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + + whitespace + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) + }, + + rnative = /^[^{]+\{\s*\[native \w/, + + // Easily-parseable/retrievable ID or TAG or CLASS selectors + rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, + + rinputs = /^(?:input|select|textarea|button)$/i, + rheader = /^h\d$/i, + + rescape = /'|\\/g, + + // CSS escapes http://www.w3.org/TR/CSS21/syndata.html#escaped-characters + runescape = new RegExp( "\\\\([\\da-f]{1,6}" + whitespace + "?|(" + whitespace + ")|.)", "ig" ), + funescape = function( _, escaped, escapedWhitespace ) { + var high = "0x" + escaped - 0x10000; + // NaN means non-codepoint + // Support: Firefox + // Workaround erroneous numeric interpretation of +"0x" + return high !== high || escapedWhitespace ? + escaped : + // BMP codepoint + high < 0 ? + String.fromCharCode( high + 0x10000 ) : + // Supplemental Plane codepoint (surrogate pair) + String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); + }; + +// Optimize for push.apply( _, NodeList ) +try { + push.apply( + (arr = slice.call( preferredDoc.childNodes )), + preferredDoc.childNodes + ); + // Support: Android<4.0 + // Detect silently failing push.apply + arr[ preferredDoc.childNodes.length ].nodeType; +} catch ( e ) { + push = { apply: arr.length ? + + // Leverage slice if possible + function( target, els ) { + push_native.apply( target, slice.call(els) ); + } : + + // Support: IE<9 + // Otherwise append directly + function( target, els ) { + var j = target.length, + i = 0; + // Can't trust NodeList.length + while ( (target[j++] = els[i++]) ) {} + target.length = j - 1; + } + }; +} + +function Sizzle( selector, context, results, seed ) { + var match, elem, m, nodeType, + // QSA vars + i, groups, old, nid, newContext, newSelector; + + if ( ( context ? context.ownerDocument || context : preferredDoc ) !== document ) { + setDocument( context ); + } + + context = context || document; + results = results || []; + + if ( !selector || typeof selector !== "string" ) { + return results; + } + + if ( (nodeType = context.nodeType) !== 1 && nodeType !== 9 ) { + return []; + } + + if ( documentIsHTML && !seed ) { + + // Shortcuts + if ( (match = rquickExpr.exec( selector )) ) { + // Speed-up: Sizzle("#ID") + if ( (m = match[1]) ) { + if ( nodeType === 9 ) { + elem = context.getElementById( m ); + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document #6963 + if ( elem && elem.parentNode ) { + // Handle the case where IE, Opera, and Webkit return items + // by name instead of ID + if ( elem.id === m ) { + results.push( elem ); + return results; + } + } else { + return results; + } + } else { + // Context is not a document + if ( context.ownerDocument && (elem = context.ownerDocument.getElementById( m )) && + contains( context, elem ) && elem.id === m ) { + results.push( elem ); + return results; + } + } + + // Speed-up: Sizzle("TAG") + } else if ( match[2] ) { + push.apply( results, context.getElementsByTagName( selector ) ); + return results; + + // Speed-up: Sizzle(".CLASS") + } else if ( (m = match[3]) && support.getElementsByClassName && context.getElementsByClassName ) { + push.apply( results, context.getElementsByClassName( m ) ); + return results; + } + } + + // QSA path + if ( support.qsa && (!rbuggyQSA || !rbuggyQSA.test( selector )) ) { + nid = old = expando; + newContext = context; + newSelector = nodeType === 9 && selector; + + // qSA works strangely on Element-rooted queries + // We can work around this by specifying an extra ID on the root + // and working up from there (Thanks to Andrew Dupont for the technique) + // IE 8 doesn't work on object elements + if ( nodeType === 1 && context.nodeName.toLowerCase() !== "object" ) { + groups = tokenize( selector ); + + if ( (old = context.getAttribute("id")) ) { + nid = old.replace( rescape, "\\$&" ); + } else { + context.setAttribute( "id", nid ); + } + nid = "[id='" + nid + "'] "; + + i = groups.length; + while ( i-- ) { + groups[i] = nid + toSelector( groups[i] ); + } + newContext = rsibling.test( selector ) && context.parentNode || context; + newSelector = groups.join(","); + } + + if ( newSelector ) { + try { + push.apply( results, + newContext.querySelectorAll( newSelector ) + ); + return results; + } catch(qsaError) { + } finally { + if ( !old ) { + context.removeAttribute("id"); + } + } + } + } + } + + // All others + return select( selector.replace( rtrim, "$1" ), context, results, seed ); +} + +/** + * Create key-value caches of limited size + * @returns {Function(string, Object)} Returns the Object data after storing it on itself with + * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) + * deleting the oldest entry + */ +function createCache() { + var keys = []; + + function cache( key, value ) { + // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) + if ( keys.push( key += " " ) > Expr.cacheLength ) { + // Only keep the most recent entries + delete cache[ keys.shift() ]; + } + return (cache[ key ] = value); + } + return cache; +} + +/** + * Mark a function for special use by Sizzle + * @param {Function} fn The function to mark + */ +function markFunction( fn ) { + fn[ expando ] = true; + return fn; +} + +/** + * Support testing using an element + * @param {Function} fn Passed the created div and expects a boolean result + */ +function assert( fn ) { + var div = document.createElement("div"); + + try { + return !!fn( div ); + } catch (e) { + return false; + } finally { + // Remove from its parent by default + if ( div.parentNode ) { + div.parentNode.removeChild( div ); + } + // release memory in IE + div = null; + } +} + +/** + * Adds the same handler for all of the specified attrs + * @param {String} attrs Pipe-separated list of attributes + * @param {Function} handler The method that will be applied + */ +function addHandle( attrs, handler ) { + var arr = attrs.split("|"), + i = attrs.length; + + while ( i-- ) { + Expr.attrHandle[ arr[i] ] = handler; + } +} + +/** + * Checks document order of two siblings + * @param {Element} a + * @param {Element} b + * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b + */ +function siblingCheck( a, b ) { + var cur = b && a, + diff = cur && a.nodeType === 1 && b.nodeType === 1 && + ( ~b.sourceIndex || MAX_NEGATIVE ) - + ( ~a.sourceIndex || MAX_NEGATIVE ); + + // Use IE sourceIndex if available on both nodes + if ( diff ) { + return diff; + } + + // Check if b follows a + if ( cur ) { + while ( (cur = cur.nextSibling) ) { + if ( cur === b ) { + return -1; + } + } + } + + return a ? 1 : -1; +} + +/** + * Returns a function to use in pseudos for input types + * @param {String} type + */ +function createInputPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for buttons + * @param {String} type + */ +function createButtonPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return (name === "input" || name === "button") && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for positionals + * @param {Function} fn + */ +function createPositionalPseudo( fn ) { + return markFunction(function( argument ) { + argument = +argument; + return markFunction(function( seed, matches ) { + var j, + matchIndexes = fn( [], seed.length, argument ), + i = matchIndexes.length; + + // Match elements found at the specified indexes + while ( i-- ) { + if ( seed[ (j = matchIndexes[i]) ] ) { + seed[j] = !(matches[j] = seed[j]); + } + } + }); + }); +} + +/** + * Detect xml + * @param {Element|Object} elem An element or a document + */ +isXML = Sizzle.isXML = function( elem ) { + // documentElement is verified for cases where it doesn't yet exist + // (such as loading iframes in IE - #4833) + var documentElement = elem && (elem.ownerDocument || elem).documentElement; + return documentElement ? documentElement.nodeName !== "HTML" : false; +}; + +// Expose support vars for convenience +support = Sizzle.support = {}; + +/** + * Sets document-related variables once based on the current document + * @param {Element|Object} [doc] An element or document object to use to set the document + * @returns {Object} Returns the current document + */ +setDocument = Sizzle.setDocument = function( node ) { + var doc = node ? node.ownerDocument || node : preferredDoc, + parent = doc.defaultView; + + // If no document and documentElement is available, return + if ( doc === document || doc.nodeType !== 9 || !doc.documentElement ) { + return document; + } + + // Set our document + document = doc; + docElem = doc.documentElement; + + // Support tests + documentIsHTML = !isXML( doc ); + + // Support: IE>8 + // If iframe document is assigned to "document" variable and if iframe has been reloaded, + // IE will throw "permission denied" error when accessing "document" variable, see jQuery #13936 + // IE6-8 do not support the defaultView property so parent will be undefined + if ( parent && parent.attachEvent && parent !== parent.top ) { + parent.attachEvent( "onbeforeunload", function() { + setDocument(); + }); + } + + /* Attributes + ---------------------------------------------------------------------- */ + + // Support: IE<8 + // Verify that getAttribute really returns attributes and not properties (excepting IE8 booleans) + support.attributes = assert(function( div ) { + div.className = "i"; + return !div.getAttribute("className"); + }); + + /* getElement(s)By* + ---------------------------------------------------------------------- */ + + // Check if getElementsByTagName("*") returns only elements + support.getElementsByTagName = assert(function( div ) { + div.appendChild( doc.createComment("") ); + return !div.getElementsByTagName("*").length; + }); + + // Check if getElementsByClassName can be trusted + support.getElementsByClassName = assert(function( div ) { + div.innerHTML = "
"; + + // Support: Safari<4 + // Catch class over-caching + div.firstChild.className = "i"; + // Support: Opera<10 + // Catch gEBCN failure to find non-leading classes + return div.getElementsByClassName("i").length === 2; + }); + + // Support: IE<10 + // Check if getElementById returns elements by name + // The broken getElementById methods don't pick up programatically-set names, + // so use a roundabout getElementsByName test + support.getById = assert(function( div ) { + docElem.appendChild( div ).id = expando; + return !doc.getElementsByName || !doc.getElementsByName( expando ).length; + }); + + // ID find and filter + if ( support.getById ) { + Expr.find["ID"] = function( id, context ) { + if ( typeof context.getElementById !== strundefined && documentIsHTML ) { + var m = context.getElementById( id ); + // Check parentNode to catch when Blackberry 4.6 returns + // nodes that are no longer in the document #6963 + return m && m.parentNode ? [m] : []; + } + }; + Expr.filter["ID"] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + return elem.getAttribute("id") === attrId; + }; + }; + } else { + // Support: IE6/7 + // getElementById is not reliable as a find shortcut + delete Expr.find["ID"]; + + Expr.filter["ID"] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + var node = typeof elem.getAttributeNode !== strundefined && elem.getAttributeNode("id"); + return node && node.value === attrId; + }; + }; + } + + // Tag + Expr.find["TAG"] = support.getElementsByTagName ? + function( tag, context ) { + if ( typeof context.getElementsByTagName !== strundefined ) { + return context.getElementsByTagName( tag ); + } + } : + function( tag, context ) { + var elem, + tmp = [], + i = 0, + results = context.getElementsByTagName( tag ); + + // Filter out possible comments + if ( tag === "*" ) { + while ( (elem = results[i++]) ) { + if ( elem.nodeType === 1 ) { + tmp.push( elem ); + } + } + + return tmp; + } + return results; + }; + + // Class + Expr.find["CLASS"] = support.getElementsByClassName && function( className, context ) { + if ( typeof context.getElementsByClassName !== strundefined && documentIsHTML ) { + return context.getElementsByClassName( className ); + } + }; + + /* QSA/matchesSelector + ---------------------------------------------------------------------- */ + + // QSA and matchesSelector support + + // matchesSelector(:active) reports false when true (IE9/Opera 11.5) + rbuggyMatches = []; + + // qSa(:focus) reports false when true (Chrome 21) + // We allow this because of a bug in IE8/9 that throws an error + // whenever `document.activeElement` is accessed on an iframe + // So, we allow :focus to pass through QSA all the time to avoid the IE error + // See http://bugs.jquery.com/ticket/13378 + rbuggyQSA = []; + + if ( (support.qsa = rnative.test( doc.querySelectorAll )) ) { + // Build QSA regex + // Regex strategy adopted from Diego Perini + assert(function( div ) { + // Select is set to empty string on purpose + // This is to test IE's treatment of not explicitly + // setting a boolean content attribute, + // since its presence should be enough + // http://bugs.jquery.com/ticket/12359 + div.innerHTML = ""; + + // Support: IE8 + // Boolean attributes and "value" are not treated correctly + if ( !div.querySelectorAll("[selected]").length ) { + rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); + } + + // Webkit/Opera - :checked should return selected option elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + // IE8 throws error here and will not see later tests + if ( !div.querySelectorAll(":checked").length ) { + rbuggyQSA.push(":checked"); + } + }); + + assert(function( div ) { + + // Support: Opera 10-12/IE8 + // ^= $= *= and empty values + // Should not select anything + // Support: Windows 8 Native Apps + // The type attribute is restricted during .innerHTML assignment + var input = doc.createElement("input"); + input.setAttribute( "type", "hidden" ); + div.appendChild( input ).setAttribute( "t", "" ); + + if ( div.querySelectorAll("[t^='']").length ) { + rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); + } + + // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) + // IE8 throws error here and will not see later tests + if ( !div.querySelectorAll(":enabled").length ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Opera 10-11 does not throw on post-comma invalid pseudos + div.querySelectorAll("*,:x"); + rbuggyQSA.push(",.*:"); + }); + } + + if ( (support.matchesSelector = rnative.test( (matches = docElem.webkitMatchesSelector || + docElem.mozMatchesSelector || + docElem.oMatchesSelector || + docElem.msMatchesSelector) )) ) { + + assert(function( div ) { + // Check to see if it's possible to do matchesSelector + // on a disconnected node (IE 9) + support.disconnectedMatch = matches.call( div, "div" ); + + // This should fail with an exception + // Gecko does not error, returns false instead + matches.call( div, "[s!='']:x" ); + rbuggyMatches.push( "!=", pseudos ); + }); + } + + rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join("|") ); + rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join("|") ); + + /* Contains + ---------------------------------------------------------------------- */ + + // Element contains another + // Purposefully does not implement inclusive descendent + // As in, an element does not contain itself + contains = rnative.test( docElem.contains ) || docElem.compareDocumentPosition ? + function( a, b ) { + var adown = a.nodeType === 9 ? a.documentElement : a, + bup = b && b.parentNode; + return a === bup || !!( bup && bup.nodeType === 1 && ( + adown.contains ? + adown.contains( bup ) : + a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 + )); + } : + function( a, b ) { + if ( b ) { + while ( (b = b.parentNode) ) { + if ( b === a ) { + return true; + } + } + } + return false; + }; + + /* Sorting + ---------------------------------------------------------------------- */ + + // Document order sorting + sortOrder = docElem.compareDocumentPosition ? + function( a, b ) { + + // Flag for duplicate removal + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + var compare = b.compareDocumentPosition && a.compareDocumentPosition && a.compareDocumentPosition( b ); + + if ( compare ) { + // Disconnected nodes + if ( compare & 1 || + (!support.sortDetached && b.compareDocumentPosition( a ) === compare) ) { + + // Choose the first element that is related to our preferred document + if ( a === doc || contains(preferredDoc, a) ) { + return -1; + } + if ( b === doc || contains(preferredDoc, b) ) { + return 1; + } + + // Maintain original order + return sortInput ? + ( indexOf.call( sortInput, a ) - indexOf.call( sortInput, b ) ) : + 0; + } + + return compare & 4 ? -1 : 1; + } + + // Not directly comparable, sort on existence of method + return a.compareDocumentPosition ? -1 : 1; + } : + function( a, b ) { + var cur, + i = 0, + aup = a.parentNode, + bup = b.parentNode, + ap = [ a ], + bp = [ b ]; + + // Exit early if the nodes are identical + if ( a === b ) { + hasDuplicate = true; + return 0; + + // Parentless nodes are either documents or disconnected + } else if ( !aup || !bup ) { + return a === doc ? -1 : + b === doc ? 1 : + aup ? -1 : + bup ? 1 : + sortInput ? + ( indexOf.call( sortInput, a ) - indexOf.call( sortInput, b ) ) : + 0; + + // If the nodes are siblings, we can do a quick check + } else if ( aup === bup ) { + return siblingCheck( a, b ); + } + + // Otherwise we need full lists of their ancestors for comparison + cur = a; + while ( (cur = cur.parentNode) ) { + ap.unshift( cur ); + } + cur = b; + while ( (cur = cur.parentNode) ) { + bp.unshift( cur ); + } + + // Walk down the tree looking for a discrepancy + while ( ap[i] === bp[i] ) { + i++; + } + + return i ? + // Do a sibling check if the nodes have a common ancestor + siblingCheck( ap[i], bp[i] ) : + + // Otherwise nodes in our document sort first + ap[i] === preferredDoc ? -1 : + bp[i] === preferredDoc ? 1 : + 0; + }; + + return doc; +}; + +Sizzle.matches = function( expr, elements ) { + return Sizzle( expr, null, null, elements ); +}; + +Sizzle.matchesSelector = function( elem, expr ) { + // Set document vars if needed + if ( ( elem.ownerDocument || elem ) !== document ) { + setDocument( elem ); + } + + // Make sure that attribute selectors are quoted + expr = expr.replace( rattributeQuotes, "='$1']" ); + + if ( support.matchesSelector && documentIsHTML && + ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && + ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { + + try { + var ret = matches.call( elem, expr ); + + // IE 9's matchesSelector returns false on disconnected nodes + if ( ret || support.disconnectedMatch || + // As well, disconnected nodes are said to be in a document + // fragment in IE 9 + elem.document && elem.document.nodeType !== 11 ) { + return ret; + } + } catch(e) {} + } + + return Sizzle( expr, document, null, [elem] ).length > 0; +}; + +Sizzle.contains = function( context, elem ) { + // Set document vars if needed + if ( ( context.ownerDocument || context ) !== document ) { + setDocument( context ); + } + return contains( context, elem ); +}; + +Sizzle.attr = function( elem, name ) { + // Set document vars if needed + if ( ( elem.ownerDocument || elem ) !== document ) { + setDocument( elem ); + } + + var fn = Expr.attrHandle[ name.toLowerCase() ], + // Don't get fooled by Object.prototype properties (jQuery #13807) + val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? + fn( elem, name, !documentIsHTML ) : + undefined; + + return val === undefined ? + support.attributes || !documentIsHTML ? + elem.getAttribute( name ) : + (val = elem.getAttributeNode(name)) && val.specified ? + val.value : + null : + val; +}; + +Sizzle.error = function( msg ) { + throw new Error( "Syntax error, unrecognized expression: " + msg ); +}; + +/** + * Document sorting and removing duplicates + * @param {ArrayLike} results + */ +Sizzle.uniqueSort = function( results ) { + var elem, + duplicates = [], + j = 0, + i = 0; + + // Unless we *know* we can detect duplicates, assume their presence + hasDuplicate = !support.detectDuplicates; + sortInput = !support.sortStable && results.slice( 0 ); + results.sort( sortOrder ); + + if ( hasDuplicate ) { + while ( (elem = results[i++]) ) { + if ( elem === results[ i ] ) { + j = duplicates.push( i ); + } + } + while ( j-- ) { + results.splice( duplicates[ j ], 1 ); + } + } + + return results; +}; + +/** + * Utility function for retrieving the text value of an array of DOM nodes + * @param {Array|Element} elem + */ +getText = Sizzle.getText = function( elem ) { + var node, + ret = "", + i = 0, + nodeType = elem.nodeType; + + if ( !nodeType ) { + // If no nodeType, this is expected to be an array + for ( ; (node = elem[i]); i++ ) { + // Do not traverse comment nodes + ret += getText( node ); + } + } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { + // Use textContent for elements + // innerText usage removed for consistency of new lines (see #11153) + if ( typeof elem.textContent === "string" ) { + return elem.textContent; + } else { + // Traverse its children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + ret += getText( elem ); + } + } + } else if ( nodeType === 3 || nodeType === 4 ) { + return elem.nodeValue; + } + // Do not include comment or processing instruction nodes + + return ret; +}; + +Expr = Sizzle.selectors = { + + // Can be adjusted by the user + cacheLength: 50, + + createPseudo: markFunction, + + match: matchExpr, + + attrHandle: {}, + + find: {}, + + relative: { + ">": { dir: "parentNode", first: true }, + " ": { dir: "parentNode" }, + "+": { dir: "previousSibling", first: true }, + "~": { dir: "previousSibling" } + }, + + preFilter: { + "ATTR": function( match ) { + match[1] = match[1].replace( runescape, funescape ); + + // Move the given value to match[3] whether quoted or unquoted + match[3] = ( match[4] || match[5] || "" ).replace( runescape, funescape ); + + if ( match[2] === "~=" ) { + match[3] = " " + match[3] + " "; + } + + return match.slice( 0, 4 ); + }, + + "CHILD": function( match ) { + /* matches from matchExpr["CHILD"] + 1 type (only|nth|...) + 2 what (child|of-type) + 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) + 4 xn-component of xn+y argument ([+-]?\d*n|) + 5 sign of xn-component + 6 x of xn-component + 7 sign of y-component + 8 y of y-component + */ + match[1] = match[1].toLowerCase(); + + if ( match[1].slice( 0, 3 ) === "nth" ) { + // nth-* requires argument + if ( !match[3] ) { + Sizzle.error( match[0] ); + } + + // numeric x and y parameters for Expr.filter.CHILD + // remember that false/true cast respectively to 0/1 + match[4] = +( match[4] ? match[5] + (match[6] || 1) : 2 * ( match[3] === "even" || match[3] === "odd" ) ); + match[5] = +( ( match[7] + match[8] ) || match[3] === "odd" ); + + // other types prohibit arguments + } else if ( match[3] ) { + Sizzle.error( match[0] ); + } + + return match; + }, + + "PSEUDO": function( match ) { + var excess, + unquoted = !match[5] && match[2]; + + if ( matchExpr["CHILD"].test( match[0] ) ) { + return null; + } + + // Accept quoted arguments as-is + if ( match[3] && match[4] !== undefined ) { + match[2] = match[4]; + + // Strip excess characters from unquoted arguments + } else if ( unquoted && rpseudo.test( unquoted ) && + // Get excess from tokenize (recursively) + (excess = tokenize( unquoted, true )) && + // advance to the next closing parenthesis + (excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length) ) { + + // excess is a negative index + match[0] = match[0].slice( 0, excess ); + match[2] = unquoted.slice( 0, excess ); + } + + // Return only captures needed by the pseudo filter method (type and argument) + return match.slice( 0, 3 ); + } + }, + + filter: { + + "TAG": function( nodeNameSelector ) { + var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); + return nodeNameSelector === "*" ? + function() { return true; } : + function( elem ) { + return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; + }; + }, + + "CLASS": function( className ) { + var pattern = classCache[ className + " " ]; + + return pattern || + (pattern = new RegExp( "(^|" + whitespace + ")" + className + "(" + whitespace + "|$)" )) && + classCache( className, function( elem ) { + return pattern.test( typeof elem.className === "string" && elem.className || typeof elem.getAttribute !== strundefined && elem.getAttribute("class") || "" ); + }); + }, + + "ATTR": function( name, operator, check ) { + return function( elem ) { + var result = Sizzle.attr( elem, name ); + + if ( result == null ) { + return operator === "!="; + } + if ( !operator ) { + return true; + } + + result += ""; + + return operator === "=" ? result === check : + operator === "!=" ? result !== check : + operator === "^=" ? check && result.indexOf( check ) === 0 : + operator === "*=" ? check && result.indexOf( check ) > -1 : + operator === "$=" ? check && result.slice( -check.length ) === check : + operator === "~=" ? ( " " + result + " " ).indexOf( check ) > -1 : + operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : + false; + }; + }, + + "CHILD": function( type, what, argument, first, last ) { + var simple = type.slice( 0, 3 ) !== "nth", + forward = type.slice( -4 ) !== "last", + ofType = what === "of-type"; + + return first === 1 && last === 0 ? + + // Shortcut for :nth-*(n) + function( elem ) { + return !!elem.parentNode; + } : + + function( elem, context, xml ) { + var cache, outerCache, node, diff, nodeIndex, start, + dir = simple !== forward ? "nextSibling" : "previousSibling", + parent = elem.parentNode, + name = ofType && elem.nodeName.toLowerCase(), + useCache = !xml && !ofType; + + if ( parent ) { + + // :(first|last|only)-(child|of-type) + if ( simple ) { + while ( dir ) { + node = elem; + while ( (node = node[ dir ]) ) { + if ( ofType ? node.nodeName.toLowerCase() === name : node.nodeType === 1 ) { + return false; + } + } + // Reverse direction for :only-* (if we haven't yet done so) + start = dir = type === "only" && !start && "nextSibling"; + } + return true; + } + + start = [ forward ? parent.firstChild : parent.lastChild ]; + + // non-xml :nth-child(...) stores cache data on `parent` + if ( forward && useCache ) { + // Seek `elem` from a previously-cached index + outerCache = parent[ expando ] || (parent[ expando ] = {}); + cache = outerCache[ type ] || []; + nodeIndex = cache[0] === dirruns && cache[1]; + diff = cache[0] === dirruns && cache[2]; + node = nodeIndex && parent.childNodes[ nodeIndex ]; + + while ( (node = ++nodeIndex && node && node[ dir ] || + + // Fallback to seeking `elem` from the start + (diff = nodeIndex = 0) || start.pop()) ) { + + // When found, cache indexes on `parent` and break + if ( node.nodeType === 1 && ++diff && node === elem ) { + outerCache[ type ] = [ dirruns, nodeIndex, diff ]; + break; + } + } + + // Use previously-cached element index if available + } else if ( useCache && (cache = (elem[ expando ] || (elem[ expando ] = {}))[ type ]) && cache[0] === dirruns ) { + diff = cache[1]; + + // xml :nth-child(...) or :nth-last-child(...) or :nth(-last)?-of-type(...) + } else { + // Use the same loop as above to seek `elem` from the start + while ( (node = ++nodeIndex && node && node[ dir ] || + (diff = nodeIndex = 0) || start.pop()) ) { + + if ( ( ofType ? node.nodeName.toLowerCase() === name : node.nodeType === 1 ) && ++diff ) { + // Cache the index of each encountered element + if ( useCache ) { + (node[ expando ] || (node[ expando ] = {}))[ type ] = [ dirruns, diff ]; + } + + if ( node === elem ) { + break; + } + } + } + } + + // Incorporate the offset, then check against cycle size + diff -= last; + return diff === first || ( diff % first === 0 && diff / first >= 0 ); + } + }; + }, + + "PSEUDO": function( pseudo, argument ) { + // pseudo-class names are case-insensitive + // http://www.w3.org/TR/selectors/#pseudo-classes + // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters + // Remember that setFilters inherits from pseudos + var args, + fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || + Sizzle.error( "unsupported pseudo: " + pseudo ); + + // The user may use createPseudo to indicate that + // arguments are needed to create the filter function + // just as Sizzle does + if ( fn[ expando ] ) { + return fn( argument ); + } + + // But maintain support for old signatures + if ( fn.length > 1 ) { + args = [ pseudo, pseudo, "", argument ]; + return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? + markFunction(function( seed, matches ) { + var idx, + matched = fn( seed, argument ), + i = matched.length; + while ( i-- ) { + idx = indexOf.call( seed, matched[i] ); + seed[ idx ] = !( matches[ idx ] = matched[i] ); + } + }) : + function( elem ) { + return fn( elem, 0, args ); + }; + } + + return fn; + } + }, + + pseudos: { + // Potentially complex pseudos + "not": markFunction(function( selector ) { + // Trim the selector passed to compile + // to avoid treating leading and trailing + // spaces as combinators + var input = [], + results = [], + matcher = compile( selector.replace( rtrim, "$1" ) ); + + return matcher[ expando ] ? + markFunction(function( seed, matches, context, xml ) { + var elem, + unmatched = matcher( seed, null, xml, [] ), + i = seed.length; + + // Match elements unmatched by `matcher` + while ( i-- ) { + if ( (elem = unmatched[i]) ) { + seed[i] = !(matches[i] = elem); + } + } + }) : + function( elem, context, xml ) { + input[0] = elem; + matcher( input, null, xml, results ); + return !results.pop(); + }; + }), + + "has": markFunction(function( selector ) { + return function( elem ) { + return Sizzle( selector, elem ).length > 0; + }; + }), + + "contains": markFunction(function( text ) { + return function( elem ) { + return ( elem.textContent || elem.innerText || getText( elem ) ).indexOf( text ) > -1; + }; + }), + + // "Whether an element is represented by a :lang() selector + // is based solely on the element's language value + // being equal to the identifier C, + // or beginning with the identifier C immediately followed by "-". + // The matching of C against the element's language value is performed case-insensitively. + // The identifier C does not have to be a valid language name." + // http://www.w3.org/TR/selectors/#lang-pseudo + "lang": markFunction( function( lang ) { + // lang value must be a valid identifier + if ( !ridentifier.test(lang || "") ) { + Sizzle.error( "unsupported lang: " + lang ); + } + lang = lang.replace( runescape, funescape ).toLowerCase(); + return function( elem ) { + var elemLang; + do { + if ( (elemLang = documentIsHTML ? + elem.lang : + elem.getAttribute("xml:lang") || elem.getAttribute("lang")) ) { + + elemLang = elemLang.toLowerCase(); + return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; + } + } while ( (elem = elem.parentNode) && elem.nodeType === 1 ); + return false; + }; + }), + + // Miscellaneous + "target": function( elem ) { + var hash = window.location && window.location.hash; + return hash && hash.slice( 1 ) === elem.id; + }, + + "root": function( elem ) { + return elem === docElem; + }, + + "focus": function( elem ) { + return elem === document.activeElement && (!document.hasFocus || document.hasFocus()) && !!(elem.type || elem.href || ~elem.tabIndex); + }, + + // Boolean properties + "enabled": function( elem ) { + return elem.disabled === false; + }, + + "disabled": function( elem ) { + return elem.disabled === true; + }, + + "checked": function( elem ) { + // In CSS3, :checked should return both checked and selected elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + var nodeName = elem.nodeName.toLowerCase(); + return (nodeName === "input" && !!elem.checked) || (nodeName === "option" && !!elem.selected); + }, + + "selected": function( elem ) { + // Accessing this property makes selected-by-default + // options in Safari work properly + if ( elem.parentNode ) { + elem.parentNode.selectedIndex; + } + + return elem.selected === true; + }, + + // Contents + "empty": function( elem ) { + // http://www.w3.org/TR/selectors/#empty-pseudo + // :empty is only affected by element nodes and content nodes(including text(3), cdata(4)), + // not comment, processing instructions, or others + // Thanks to Diego Perini for the nodeName shortcut + // Greater than "@" means alpha characters (specifically not starting with "#" or "?") + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + if ( elem.nodeName > "@" || elem.nodeType === 3 || elem.nodeType === 4 ) { + return false; + } + } + return true; + }, + + "parent": function( elem ) { + return !Expr.pseudos["empty"]( elem ); + }, + + // Element/input types + "header": function( elem ) { + return rheader.test( elem.nodeName ); + }, + + "input": function( elem ) { + return rinputs.test( elem.nodeName ); + }, + + "button": function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === "button" || name === "button"; + }, + + "text": function( elem ) { + var attr; + // IE6 and 7 will map elem.type to 'text' for new HTML5 types (search, etc) + // use getAttribute instead to test this case + return elem.nodeName.toLowerCase() === "input" && + elem.type === "text" && + ( (attr = elem.getAttribute("type")) == null || attr.toLowerCase() === elem.type ); + }, + + // Position-in-collection + "first": createPositionalPseudo(function() { + return [ 0 ]; + }), + + "last": createPositionalPseudo(function( matchIndexes, length ) { + return [ length - 1 ]; + }), + + "eq": createPositionalPseudo(function( matchIndexes, length, argument ) { + return [ argument < 0 ? argument + length : argument ]; + }), + + "even": createPositionalPseudo(function( matchIndexes, length ) { + var i = 0; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + }), + + "odd": createPositionalPseudo(function( matchIndexes, length ) { + var i = 1; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + }), + + "lt": createPositionalPseudo(function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; --i >= 0; ) { + matchIndexes.push( i ); + } + return matchIndexes; + }), + + "gt": createPositionalPseudo(function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; ++i < length; ) { + matchIndexes.push( i ); + } + return matchIndexes; + }) + } +}; + +Expr.pseudos["nth"] = Expr.pseudos["eq"]; + +// Add button/input type pseudos +for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { + Expr.pseudos[ i ] = createInputPseudo( i ); +} +for ( i in { submit: true, reset: true } ) { + Expr.pseudos[ i ] = createButtonPseudo( i ); +} + +// Easy API for creating new setFilters +function setFilters() {} +setFilters.prototype = Expr.filters = Expr.pseudos; +Expr.setFilters = new setFilters(); + +function tokenize( selector, parseOnly ) { + var matched, match, tokens, type, + soFar, groups, preFilters, + cached = tokenCache[ selector + " " ]; + + if ( cached ) { + return parseOnly ? 0 : cached.slice( 0 ); + } + + soFar = selector; + groups = []; + preFilters = Expr.preFilter; + + while ( soFar ) { + + // Comma and first run + if ( !matched || (match = rcomma.exec( soFar )) ) { + if ( match ) { + // Don't consume trailing commas as valid + soFar = soFar.slice( match[0].length ) || soFar; + } + groups.push( tokens = [] ); + } + + matched = false; + + // Combinators + if ( (match = rcombinators.exec( soFar )) ) { + matched = match.shift(); + tokens.push({ + value: matched, + // Cast descendant combinators to space + type: match[0].replace( rtrim, " " ) + }); + soFar = soFar.slice( matched.length ); + } + + // Filters + for ( type in Expr.filter ) { + if ( (match = matchExpr[ type ].exec( soFar )) && (!preFilters[ type ] || + (match = preFilters[ type ]( match ))) ) { + matched = match.shift(); + tokens.push({ + value: matched, + type: type, + matches: match + }); + soFar = soFar.slice( matched.length ); + } + } + + if ( !matched ) { + break; + } + } + + // Return the length of the invalid excess + // if we're just parsing + // Otherwise, throw an error or return tokens + return parseOnly ? + soFar.length : + soFar ? + Sizzle.error( selector ) : + // Cache the tokens + tokenCache( selector, groups ).slice( 0 ); +} + +function toSelector( tokens ) { + var i = 0, + len = tokens.length, + selector = ""; + for ( ; i < len; i++ ) { + selector += tokens[i].value; + } + return selector; +} + +function addCombinator( matcher, combinator, base ) { + var dir = combinator.dir, + checkNonElements = base && dir === "parentNode", + doneName = done++; + + return combinator.first ? + // Check against closest ancestor/preceding element + function( elem, context, xml ) { + while ( (elem = elem[ dir ]) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + return matcher( elem, context, xml ); + } + } + } : + + // Check against all ancestor/preceding elements + function( elem, context, xml ) { + var data, cache, outerCache, + dirkey = dirruns + " " + doneName; + + // We can't set arbitrary data on XML nodes, so they don't benefit from dir caching + if ( xml ) { + while ( (elem = elem[ dir ]) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + if ( matcher( elem, context, xml ) ) { + return true; + } + } + } + } else { + while ( (elem = elem[ dir ]) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + outerCache = elem[ expando ] || (elem[ expando ] = {}); + if ( (cache = outerCache[ dir ]) && cache[0] === dirkey ) { + if ( (data = cache[1]) === true || data === cachedruns ) { + return data === true; + } + } else { + cache = outerCache[ dir ] = [ dirkey ]; + cache[1] = matcher( elem, context, xml ) || cachedruns; + if ( cache[1] === true ) { + return true; + } + } + } + } + } + }; +} + +function elementMatcher( matchers ) { + return matchers.length > 1 ? + function( elem, context, xml ) { + var i = matchers.length; + while ( i-- ) { + if ( !matchers[i]( elem, context, xml ) ) { + return false; + } + } + return true; + } : + matchers[0]; +} + +function condense( unmatched, map, filter, context, xml ) { + var elem, + newUnmatched = [], + i = 0, + len = unmatched.length, + mapped = map != null; + + for ( ; i < len; i++ ) { + if ( (elem = unmatched[i]) ) { + if ( !filter || filter( elem, context, xml ) ) { + newUnmatched.push( elem ); + if ( mapped ) { + map.push( i ); + } + } + } + } + + return newUnmatched; +} + +function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { + if ( postFilter && !postFilter[ expando ] ) { + postFilter = setMatcher( postFilter ); + } + if ( postFinder && !postFinder[ expando ] ) { + postFinder = setMatcher( postFinder, postSelector ); + } + return markFunction(function( seed, results, context, xml ) { + var temp, i, elem, + preMap = [], + postMap = [], + preexisting = results.length, + + // Get initial elements from seed or context + elems = seed || multipleContexts( selector || "*", context.nodeType ? [ context ] : context, [] ), + + // Prefilter to get matcher input, preserving a map for seed-results synchronization + matcherIn = preFilter && ( seed || !selector ) ? + condense( elems, preMap, preFilter, context, xml ) : + elems, + + matcherOut = matcher ? + // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, + postFinder || ( seed ? preFilter : preexisting || postFilter ) ? + + // ...intermediate processing is necessary + [] : + + // ...otherwise use results directly + results : + matcherIn; + + // Find primary matches + if ( matcher ) { + matcher( matcherIn, matcherOut, context, xml ); + } + + // Apply postFilter + if ( postFilter ) { + temp = condense( matcherOut, postMap ); + postFilter( temp, [], context, xml ); + + // Un-match failing elements by moving them back to matcherIn + i = temp.length; + while ( i-- ) { + if ( (elem = temp[i]) ) { + matcherOut[ postMap[i] ] = !(matcherIn[ postMap[i] ] = elem); + } + } + } + + if ( seed ) { + if ( postFinder || preFilter ) { + if ( postFinder ) { + // Get the final matcherOut by condensing this intermediate into postFinder contexts + temp = []; + i = matcherOut.length; + while ( i-- ) { + if ( (elem = matcherOut[i]) ) { + // Restore matcherIn since elem is not yet a final match + temp.push( (matcherIn[i] = elem) ); + } + } + postFinder( null, (matcherOut = []), temp, xml ); + } + + // Move matched elements from seed to results to keep them synchronized + i = matcherOut.length; + while ( i-- ) { + if ( (elem = matcherOut[i]) && + (temp = postFinder ? indexOf.call( seed, elem ) : preMap[i]) > -1 ) { + + seed[temp] = !(results[temp] = elem); + } + } + } + + // Add elements to results, through postFinder if defined + } else { + matcherOut = condense( + matcherOut === results ? + matcherOut.splice( preexisting, matcherOut.length ) : + matcherOut + ); + if ( postFinder ) { + postFinder( null, results, matcherOut, xml ); + } else { + push.apply( results, matcherOut ); + } + } + }); +} + +function matcherFromTokens( tokens ) { + var checkContext, matcher, j, + len = tokens.length, + leadingRelative = Expr.relative[ tokens[0].type ], + implicitRelative = leadingRelative || Expr.relative[" "], + i = leadingRelative ? 1 : 0, + + // The foundational matcher ensures that elements are reachable from top-level context(s) + matchContext = addCombinator( function( elem ) { + return elem === checkContext; + }, implicitRelative, true ), + matchAnyContext = addCombinator( function( elem ) { + return indexOf.call( checkContext, elem ) > -1; + }, implicitRelative, true ), + matchers = [ function( elem, context, xml ) { + return ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( + (checkContext = context).nodeType ? + matchContext( elem, context, xml ) : + matchAnyContext( elem, context, xml ) ); + } ]; + + for ( ; i < len; i++ ) { + if ( (matcher = Expr.relative[ tokens[i].type ]) ) { + matchers = [ addCombinator(elementMatcher( matchers ), matcher) ]; + } else { + matcher = Expr.filter[ tokens[i].type ].apply( null, tokens[i].matches ); + + // Return special upon seeing a positional matcher + if ( matcher[ expando ] ) { + // Find the next relative operator (if any) for proper handling + j = ++i; + for ( ; j < len; j++ ) { + if ( Expr.relative[ tokens[j].type ] ) { + break; + } + } + return setMatcher( + i > 1 && elementMatcher( matchers ), + i > 1 && toSelector( + // If the preceding token was a descendant combinator, insert an implicit any-element `*` + tokens.slice( 0, i - 1 ).concat({ value: tokens[ i - 2 ].type === " " ? "*" : "" }) + ).replace( rtrim, "$1" ), + matcher, + i < j && matcherFromTokens( tokens.slice( i, j ) ), + j < len && matcherFromTokens( (tokens = tokens.slice( j )) ), + j < len && toSelector( tokens ) + ); + } + matchers.push( matcher ); + } + } + + return elementMatcher( matchers ); +} + +function matcherFromGroupMatchers( elementMatchers, setMatchers ) { + // A counter to specify which element is currently being matched + var matcherCachedRuns = 0, + bySet = setMatchers.length > 0, + byElement = elementMatchers.length > 0, + superMatcher = function( seed, context, xml, results, expandContext ) { + var elem, j, matcher, + setMatched = [], + matchedCount = 0, + i = "0", + unmatched = seed && [], + outermost = expandContext != null, + contextBackup = outermostContext, + // We must always have either seed elements or context + elems = seed || byElement && Expr.find["TAG"]( "*", expandContext && context.parentNode || context ), + // Use integer dirruns iff this is the outermost matcher + dirrunsUnique = (dirruns += contextBackup == null ? 1 : Math.random() || 0.1); + + if ( outermost ) { + outermostContext = context !== document && context; + cachedruns = matcherCachedRuns; + } + + // Add elements passing elementMatchers directly to results + // Keep `i` a string if there are no elements so `matchedCount` will be "00" below + for ( ; (elem = elems[i]) != null; i++ ) { + if ( byElement && elem ) { + j = 0; + while ( (matcher = elementMatchers[j++]) ) { + if ( matcher( elem, context, xml ) ) { + results.push( elem ); + break; + } + } + if ( outermost ) { + dirruns = dirrunsUnique; + cachedruns = ++matcherCachedRuns; + } + } + + // Track unmatched elements for set filters + if ( bySet ) { + // They will have gone through all possible matchers + if ( (elem = !matcher && elem) ) { + matchedCount--; + } + + // Lengthen the array for every element, matched or not + if ( seed ) { + unmatched.push( elem ); + } + } + } + + // Apply set filters to unmatched elements + matchedCount += i; + if ( bySet && i !== matchedCount ) { + j = 0; + while ( (matcher = setMatchers[j++]) ) { + matcher( unmatched, setMatched, context, xml ); + } + + if ( seed ) { + // Reintegrate element matches to eliminate the need for sorting + if ( matchedCount > 0 ) { + while ( i-- ) { + if ( !(unmatched[i] || setMatched[i]) ) { + setMatched[i] = pop.call( results ); + } + } + } + + // Discard index placeholder values to get only actual matches + setMatched = condense( setMatched ); + } + + // Add matches to results + push.apply( results, setMatched ); + + // Seedless set matches succeeding multiple successful matchers stipulate sorting + if ( outermost && !seed && setMatched.length > 0 && + ( matchedCount + setMatchers.length ) > 1 ) { + + Sizzle.uniqueSort( results ); + } + } + + // Override manipulation of globals by nested matchers + if ( outermost ) { + dirruns = dirrunsUnique; + outermostContext = contextBackup; + } + + return unmatched; + }; + + return bySet ? + markFunction( superMatcher ) : + superMatcher; +} + +compile = Sizzle.compile = function( selector, group /* Internal Use Only */ ) { + var i, + setMatchers = [], + elementMatchers = [], + cached = compilerCache[ selector + " " ]; + + if ( !cached ) { + // Generate a function of recursive functions that can be used to check each element + if ( !group ) { + group = tokenize( selector ); + } + i = group.length; + while ( i-- ) { + cached = matcherFromTokens( group[i] ); + if ( cached[ expando ] ) { + setMatchers.push( cached ); + } else { + elementMatchers.push( cached ); + } + } + + // Cache the compiled function + cached = compilerCache( selector, matcherFromGroupMatchers( elementMatchers, setMatchers ) ); + } + return cached; +}; + +function multipleContexts( selector, contexts, results ) { + var i = 0, + len = contexts.length; + for ( ; i < len; i++ ) { + Sizzle( selector, contexts[i], results ); + } + return results; +} + +function select( selector, context, results, seed ) { + var i, tokens, token, type, find, + match = tokenize( selector ); + + if ( !seed ) { + // Try to minimize operations if there is only one group + if ( match.length === 1 ) { + + // Take a shortcut and set the context if the root selector is an ID + tokens = match[0] = match[0].slice( 0 ); + if ( tokens.length > 2 && (token = tokens[0]).type === "ID" && + support.getById && context.nodeType === 9 && documentIsHTML && + Expr.relative[ tokens[1].type ] ) { + + context = ( Expr.find["ID"]( token.matches[0].replace(runescape, funescape), context ) || [] )[0]; + if ( !context ) { + return results; + } + selector = selector.slice( tokens.shift().value.length ); + } + + // Fetch a seed set for right-to-left matching + i = matchExpr["needsContext"].test( selector ) ? 0 : tokens.length; + while ( i-- ) { + token = tokens[i]; + + // Abort if we hit a combinator + if ( Expr.relative[ (type = token.type) ] ) { + break; + } + if ( (find = Expr.find[ type ]) ) { + // Search, expanding context for leading sibling combinators + if ( (seed = find( + token.matches[0].replace( runescape, funescape ), + rsibling.test( tokens[0].type ) && context.parentNode || context + )) ) { + + // If seed is empty or no tokens remain, we can return early + tokens.splice( i, 1 ); + selector = seed.length && toSelector( tokens ); + if ( !selector ) { + push.apply( results, seed ); + return results; + } + + break; + } + } + } + } + } + + // Compile and execute a filtering function + // Provide `match` to avoid retokenization if we modified the selector above + compile( selector, match )( + seed, + context, + !documentIsHTML, + results, + rsibling.test( selector ) + ); + return results; +} + +// One-time assignments + +// Sort stability +support.sortStable = expando.split("").sort( sortOrder ).join("") === expando; + +// Support: Chrome<14 +// Always assume duplicates if they aren't passed to the comparison function +support.detectDuplicates = hasDuplicate; + +// Initialize against the default document +setDocument(); + +// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) +// Detached nodes confoundingly follow *each other* +support.sortDetached = assert(function( div1 ) { + // Should return 1, but returns 4 (following) + return div1.compareDocumentPosition( document.createElement("div") ) & 1; +}); + +// Support: IE<8 +// Prevent attribute/property "interpolation" +// http://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx +if ( !assert(function( div ) { + div.innerHTML = ""; + return div.firstChild.getAttribute("href") === "#" ; +}) ) { + addHandle( "type|href|height|width", function( elem, name, isXML ) { + if ( !isXML ) { + return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); + } + }); +} + +// Support: IE<9 +// Use defaultValue in place of getAttribute("value") +if ( !support.attributes || !assert(function( div ) { + div.innerHTML = ""; + div.firstChild.setAttribute( "value", "" ); + return div.firstChild.getAttribute( "value" ) === ""; +}) ) { + addHandle( "value", function( elem, name, isXML ) { + if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { + return elem.defaultValue; + } + }); +} + +// Support: IE<9 +// Use getAttributeNode to fetch booleans when getAttribute lies +if ( !assert(function( div ) { + return div.getAttribute("disabled") == null; +}) ) { + addHandle( booleans, function( elem, name, isXML ) { + var val; + if ( !isXML ) { + return (val = elem.getAttributeNode( name )) && val.specified ? + val.value : + elem[ name ] === true ? name.toLowerCase() : null; + } + }); +} + +jQuery.find = Sizzle; +jQuery.expr = Sizzle.selectors; +jQuery.expr[":"] = jQuery.expr.pseudos; +jQuery.unique = Sizzle.uniqueSort; +jQuery.text = Sizzle.getText; +jQuery.isXMLDoc = Sizzle.isXML; +jQuery.contains = Sizzle.contains; + + +})( window ); +// String to Object options format cache +var optionsCache = {}; + +// Convert String-formatted options into Object-formatted ones and store in cache +function createOptions( options ) { + var object = optionsCache[ options ] = {}; + jQuery.each( options.match( core_rnotwhite ) || [], function( _, flag ) { + object[ flag ] = true; + }); + return object; +} + +/* + * Create a callback list using the following parameters: + * + * options: an optional list of space-separated options that will change how + * the callback list behaves or a more traditional option object + * + * By default a callback list will act like an event callback list and can be + * "fired" multiple times. + * + * Possible options: + * + * once: will ensure the callback list can only be fired once (like a Deferred) + * + * memory: will keep track of previous values and will call any callback added + * after the list has been fired right away with the latest "memorized" + * values (like a Deferred) + * + * unique: will ensure a callback can only be added once (no duplicate in the list) + * + * stopOnFalse: interrupt callings when a callback returns false + * + */ +jQuery.Callbacks = function( options ) { + + // Convert options from String-formatted to Object-formatted if needed + // (we check in cache first) + options = typeof options === "string" ? + ( optionsCache[ options ] || createOptions( options ) ) : + jQuery.extend( {}, options ); + + var // Flag to know if list is currently firing + firing, + // Last fire value (for non-forgettable lists) + memory, + // Flag to know if list was already fired + fired, + // End of the loop when firing + firingLength, + // Index of currently firing callback (modified by remove if needed) + firingIndex, + // First callback to fire (used internally by add and fireWith) + firingStart, + // Actual callback list + list = [], + // Stack of fire calls for repeatable lists + stack = !options.once && [], + // Fire callbacks + fire = function( data ) { + memory = options.memory && data; + fired = true; + firingIndex = firingStart || 0; + firingStart = 0; + firingLength = list.length; + firing = true; + for ( ; list && firingIndex < firingLength; firingIndex++ ) { + if ( list[ firingIndex ].apply( data[ 0 ], data[ 1 ] ) === false && options.stopOnFalse ) { + memory = false; // To prevent further calls using add + break; + } + } + firing = false; + if ( list ) { + if ( stack ) { + if ( stack.length ) { + fire( stack.shift() ); + } + } else if ( memory ) { + list = []; + } else { + self.disable(); + } + } + }, + // Actual Callbacks object + self = { + // Add a callback or a collection of callbacks to the list + add: function() { + if ( list ) { + // First, we save the current length + var start = list.length; + (function add( args ) { + jQuery.each( args, function( _, arg ) { + var type = jQuery.type( arg ); + if ( type === "function" ) { + if ( !options.unique || !self.has( arg ) ) { + list.push( arg ); + } + } else if ( arg && arg.length && type !== "string" ) { + // Inspect recursively + add( arg ); + } + }); + })( arguments ); + // Do we need to add the callbacks to the + // current firing batch? + if ( firing ) { + firingLength = list.length; + // With memory, if we're not firing then + // we should call right away + } else if ( memory ) { + firingStart = start; + fire( memory ); + } + } + return this; + }, + // Remove a callback from the list + remove: function() { + if ( list ) { + jQuery.each( arguments, function( _, arg ) { + var index; + while( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { + list.splice( index, 1 ); + // Handle firing indexes + if ( firing ) { + if ( index <= firingLength ) { + firingLength--; + } + if ( index <= firingIndex ) { + firingIndex--; + } + } + } + }); + } + return this; + }, + // Check if a given callback is in the list. + // If no argument is given, return whether or not list has callbacks attached. + has: function( fn ) { + return fn ? jQuery.inArray( fn, list ) > -1 : !!( list && list.length ); + }, + // Remove all callbacks from the list + empty: function() { + list = []; + firingLength = 0; + return this; + }, + // Have the list do nothing anymore + disable: function() { + list = stack = memory = undefined; + return this; + }, + // Is it disabled? + disabled: function() { + return !list; + }, + // Lock the list in its current state + lock: function() { + stack = undefined; + if ( !memory ) { + self.disable(); + } + return this; + }, + // Is it locked? + locked: function() { + return !stack; + }, + // Call all callbacks with the given context and arguments + fireWith: function( context, args ) { + if ( list && ( !fired || stack ) ) { + args = args || []; + args = [ context, args.slice ? args.slice() : args ]; + if ( firing ) { + stack.push( args ); + } else { + fire( args ); + } + } + return this; + }, + // Call all the callbacks with the given arguments + fire: function() { + self.fireWith( this, arguments ); + return this; + }, + // To know if the callbacks have already been called at least once + fired: function() { + return !!fired; + } + }; + + return self; +}; +jQuery.extend({ + + Deferred: function( func ) { + var tuples = [ + // action, add listener, listener list, final state + [ "resolve", "done", jQuery.Callbacks("once memory"), "resolved" ], + [ "reject", "fail", jQuery.Callbacks("once memory"), "rejected" ], + [ "notify", "progress", jQuery.Callbacks("memory") ] + ], + state = "pending", + promise = { + state: function() { + return state; + }, + always: function() { + deferred.done( arguments ).fail( arguments ); + return this; + }, + then: function( /* fnDone, fnFail, fnProgress */ ) { + var fns = arguments; + return jQuery.Deferred(function( newDefer ) { + jQuery.each( tuples, function( i, tuple ) { + var action = tuple[ 0 ], + fn = jQuery.isFunction( fns[ i ] ) && fns[ i ]; + // deferred[ done | fail | progress ] for forwarding actions to newDefer + deferred[ tuple[1] ](function() { + var returned = fn && fn.apply( this, arguments ); + if ( returned && jQuery.isFunction( returned.promise ) ) { + returned.promise() + .done( newDefer.resolve ) + .fail( newDefer.reject ) + .progress( newDefer.notify ); + } else { + newDefer[ action + "With" ]( this === promise ? newDefer.promise() : this, fn ? [ returned ] : arguments ); + } + }); + }); + fns = null; + }).promise(); + }, + // Get a promise for this deferred + // If obj is provided, the promise aspect is added to the object + promise: function( obj ) { + return obj != null ? jQuery.extend( obj, promise ) : promise; + } + }, + deferred = {}; + + // Keep pipe for back-compat + promise.pipe = promise.then; + + // Add list-specific methods + jQuery.each( tuples, function( i, tuple ) { + var list = tuple[ 2 ], + stateString = tuple[ 3 ]; + + // promise[ done | fail | progress ] = list.add + promise[ tuple[1] ] = list.add; + + // Handle state + if ( stateString ) { + list.add(function() { + // state = [ resolved | rejected ] + state = stateString; + + // [ reject_list | resolve_list ].disable; progress_list.lock + }, tuples[ i ^ 1 ][ 2 ].disable, tuples[ 2 ][ 2 ].lock ); + } + + // deferred[ resolve | reject | notify ] + deferred[ tuple[0] ] = function() { + deferred[ tuple[0] + "With" ]( this === deferred ? promise : this, arguments ); + return this; + }; + deferred[ tuple[0] + "With" ] = list.fireWith; + }); + + // Make the deferred a promise + promise.promise( deferred ); + + // Call given func if any + if ( func ) { + func.call( deferred, deferred ); + } + + // All done! + return deferred; + }, + + // Deferred helper + when: function( subordinate /* , ..., subordinateN */ ) { + var i = 0, + resolveValues = core_slice.call( arguments ), + length = resolveValues.length, + + // the count of uncompleted subordinates + remaining = length !== 1 || ( subordinate && jQuery.isFunction( subordinate.promise ) ) ? length : 0, + + // the master Deferred. If resolveValues consist of only a single Deferred, just use that. + deferred = remaining === 1 ? subordinate : jQuery.Deferred(), + + // Update function for both resolve and progress values + updateFunc = function( i, contexts, values ) { + return function( value ) { + contexts[ i ] = this; + values[ i ] = arguments.length > 1 ? core_slice.call( arguments ) : value; + if( values === progressValues ) { + deferred.notifyWith( contexts, values ); + } else if ( !( --remaining ) ) { + deferred.resolveWith( contexts, values ); + } + }; + }, + + progressValues, progressContexts, resolveContexts; + + // add listeners to Deferred subordinates; treat others as resolved + if ( length > 1 ) { + progressValues = new Array( length ); + progressContexts = new Array( length ); + resolveContexts = new Array( length ); + for ( ; i < length; i++ ) { + if ( resolveValues[ i ] && jQuery.isFunction( resolveValues[ i ].promise ) ) { + resolveValues[ i ].promise() + .done( updateFunc( i, resolveContexts, resolveValues ) ) + .fail( deferred.reject ) + .progress( updateFunc( i, progressContexts, progressValues ) ); + } else { + --remaining; + } + } + } + + // if we're not waiting on anything, resolve the master + if ( !remaining ) { + deferred.resolveWith( resolveContexts, resolveValues ); + } + + return deferred.promise(); + } +}); +jQuery.support = (function( support ) { + + var all, a, input, select, fragment, opt, eventName, isSupported, i, + div = document.createElement("div"); + + // Setup + div.setAttribute( "className", "t" ); + div.innerHTML = "
a"; + + // Finish early in limited (non-browser) environments + all = div.getElementsByTagName("*") || []; + a = div.getElementsByTagName("a")[ 0 ]; + if ( !a || !a.style || !all.length ) { + return support; + } + + // First batch of tests + select = document.createElement("select"); + opt = select.appendChild( document.createElement("option") ); + input = div.getElementsByTagName("input")[ 0 ]; + + a.style.cssText = "top:1px;float:left;opacity:.5"; + + // Test setAttribute on camelCase class. If it works, we need attrFixes when doing get/setAttribute (ie6/7) + support.getSetAttribute = div.className !== "t"; + + // IE strips leading whitespace when .innerHTML is used + support.leadingWhitespace = div.firstChild.nodeType === 3; + + // Make sure that tbody elements aren't automatically inserted + // IE will insert them into empty tables + support.tbody = !div.getElementsByTagName("tbody").length; + + // Make sure that link elements get serialized correctly by innerHTML + // This requires a wrapper element in IE + support.htmlSerialize = !!div.getElementsByTagName("link").length; + + // Get the style information from getAttribute + // (IE uses .cssText instead) + support.style = /top/.test( a.getAttribute("style") ); + + // Make sure that URLs aren't manipulated + // (IE normalizes it by default) + support.hrefNormalized = a.getAttribute("href") === "/a"; + + // Make sure that element opacity exists + // (IE uses filter instead) + // Use a regex to work around a WebKit issue. See #5145 + support.opacity = /^0.5/.test( a.style.opacity ); + + // Verify style float existence + // (IE uses styleFloat instead of cssFloat) + support.cssFloat = !!a.style.cssFloat; + + // Check the default checkbox/radio value ("" on WebKit; "on" elsewhere) + support.checkOn = !!input.value; + + // Make sure that a selected-by-default option has a working selected property. + // (WebKit defaults to false instead of true, IE too, if it's in an optgroup) + support.optSelected = opt.selected; + + // Tests for enctype support on a form (#6743) + support.enctype = !!document.createElement("form").enctype; + + // Makes sure cloning an html5 element does not cause problems + // Where outerHTML is undefined, this still works + support.html5Clone = document.createElement("nav").cloneNode( true ).outerHTML !== "<:nav>"; + + // Will be defined later + support.inlineBlockNeedsLayout = false; + support.shrinkWrapBlocks = false; + support.pixelPosition = false; + support.deleteExpando = true; + support.noCloneEvent = true; + support.reliableMarginRight = true; + support.boxSizingReliable = true; + + // Make sure checked status is properly cloned + input.checked = true; + support.noCloneChecked = input.cloneNode( true ).checked; + + // Make sure that the options inside disabled selects aren't marked as disabled + // (WebKit marks them as disabled) + select.disabled = true; + support.optDisabled = !opt.disabled; + + // Support: IE<9 + try { + delete div.test; + } catch( e ) { + support.deleteExpando = false; + } + + // Check if we can trust getAttribute("value") + input = document.createElement("input"); + input.setAttribute( "value", "" ); + support.input = input.getAttribute( "value" ) === ""; + + // Check if an input maintains its value after becoming a radio + input.value = "t"; + input.setAttribute( "type", "radio" ); + support.radioValue = input.value === "t"; + + // #11217 - WebKit loses check when the name is after the checked attribute + input.setAttribute( "checked", "t" ); + input.setAttribute( "name", "t" ); + + fragment = document.createDocumentFragment(); + fragment.appendChild( input ); + + // Check if a disconnected checkbox will retain its checked + // value of true after appended to the DOM (IE6/7) + support.appendChecked = input.checked; + + // WebKit doesn't clone checked state correctly in fragments + support.checkClone = fragment.cloneNode( true ).cloneNode( true ).lastChild.checked; + + // Support: IE<9 + // Opera does not clone events (and typeof div.attachEvent === undefined). + // IE9-10 clones events bound via attachEvent, but they don't trigger with .click() + if ( div.attachEvent ) { + div.attachEvent( "onclick", function() { + support.noCloneEvent = false; + }); + + div.cloneNode( true ).click(); + } + + // Support: IE<9 (lack submit/change bubble), Firefox 17+ (lack focusin event) + // Beware of CSP restrictions (https://developer.mozilla.org/en/Security/CSP) + for ( i in { submit: true, change: true, focusin: true }) { + div.setAttribute( eventName = "on" + i, "t" ); + + support[ i + "Bubbles" ] = eventName in window || div.attributes[ eventName ].expando === false; + } + + div.style.backgroundClip = "content-box"; + div.cloneNode( true ).style.backgroundClip = ""; + support.clearCloneStyle = div.style.backgroundClip === "content-box"; + + // Support: IE<9 + // Iteration over object's inherited properties before its own. + for ( i in jQuery( support ) ) { + break; + } + support.ownLast = i !== "0"; + + // Run tests that need a body at doc ready + jQuery(function() { + var container, marginDiv, tds, + divReset = "padding:0;margin:0;border:0;display:block;box-sizing:content-box;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;", + body = document.getElementsByTagName("body")[0]; + + if ( !body ) { + // Return for frameset docs that don't have a body + return; + } + + container = document.createElement("div"); + container.style.cssText = "border:0;width:0;height:0;position:absolute;top:0;left:-9999px;margin-top:1px"; + + body.appendChild( container ).appendChild( div ); + + // Support: IE8 + // Check if table cells still have offsetWidth/Height when they are set + // to display:none and there are still other visible table cells in a + // table row; if so, offsetWidth/Height are not reliable for use when + // determining if an element has been hidden directly using + // display:none (it is still safe to use offsets if a parent element is + // hidden; don safety goggles and see bug #4512 for more information). + div.innerHTML = "
t
"; + tds = div.getElementsByTagName("td"); + tds[ 0 ].style.cssText = "padding:0;margin:0;border:0;display:none"; + isSupported = ( tds[ 0 ].offsetHeight === 0 ); + + tds[ 0 ].style.display = ""; + tds[ 1 ].style.display = "none"; + + // Support: IE8 + // Check if empty table cells still have offsetWidth/Height + support.reliableHiddenOffsets = isSupported && ( tds[ 0 ].offsetHeight === 0 ); + + // Check box-sizing and margin behavior. + div.innerHTML = ""; + div.style.cssText = "box-sizing:border-box;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;padding:1px;border:1px;display:block;width:4px;margin-top:1%;position:absolute;top:1%;"; + + // Workaround failing boxSizing test due to offsetWidth returning wrong value + // with some non-1 values of body zoom, ticket #13543 + jQuery.swap( body, body.style.zoom != null ? { zoom: 1 } : {}, function() { + support.boxSizing = div.offsetWidth === 4; + }); + + // Use window.getComputedStyle because jsdom on node.js will break without it. + if ( window.getComputedStyle ) { + support.pixelPosition = ( window.getComputedStyle( div, null ) || {} ).top !== "1%"; + support.boxSizingReliable = ( window.getComputedStyle( div, null ) || { width: "4px" } ).width === "4px"; + + // Check if div with explicit width and no margin-right incorrectly + // gets computed margin-right based on width of container. (#3333) + // Fails in WebKit before Feb 2011 nightlies + // WebKit Bug 13343 - getComputedStyle returns wrong value for margin-right + marginDiv = div.appendChild( document.createElement("div") ); + marginDiv.style.cssText = div.style.cssText = divReset; + marginDiv.style.marginRight = marginDiv.style.width = "0"; + div.style.width = "1px"; + + support.reliableMarginRight = + !parseFloat( ( window.getComputedStyle( marginDiv, null ) || {} ).marginRight ); + } + + if ( typeof div.style.zoom !== core_strundefined ) { + // Support: IE<8 + // Check if natively block-level elements act like inline-block + // elements when setting their display to 'inline' and giving + // them layout + div.innerHTML = ""; + div.style.cssText = divReset + "width:1px;padding:1px;display:inline;zoom:1"; + support.inlineBlockNeedsLayout = ( div.offsetWidth === 3 ); + + // Support: IE6 + // Check if elements with layout shrink-wrap their children + div.style.display = "block"; + div.innerHTML = "
"; + div.firstChild.style.width = "5px"; + support.shrinkWrapBlocks = ( div.offsetWidth !== 3 ); + + if ( support.inlineBlockNeedsLayout ) { + // Prevent IE 6 from affecting layout for positioned elements #11048 + // Prevent IE from shrinking the body in IE 7 mode #12869 + // Support: IE<8 + body.style.zoom = 1; + } + } + + body.removeChild( container ); + + // Null elements to avoid leaks in IE + container = div = tds = marginDiv = null; + }); + + // Null elements to avoid leaks in IE + all = select = fragment = opt = a = input = null; + + return support; +})({}); + +var rbrace = /(?:\{[\s\S]*\}|\[[\s\S]*\])$/, + rmultiDash = /([A-Z])/g; + +function internalData( elem, name, data, pvt /* Internal Use Only */ ){ + if ( !jQuery.acceptData( elem ) ) { + return; + } + + var ret, thisCache, + internalKey = jQuery.expando, + + // We have to handle DOM nodes and JS objects differently because IE6-7 + // can't GC object references properly across the DOM-JS boundary + isNode = elem.nodeType, + + // Only DOM nodes need the global jQuery cache; JS object data is + // attached directly to the object so GC can occur automatically + cache = isNode ? jQuery.cache : elem, + + // Only defining an ID for JS objects if its cache already exists allows + // the code to shortcut on the same path as a DOM node with no cache + id = isNode ? elem[ internalKey ] : elem[ internalKey ] && internalKey; + + // Avoid doing any more work than we need to when trying to get data on an + // object that has no data at all + if ( (!id || !cache[id] || (!pvt && !cache[id].data)) && data === undefined && typeof name === "string" ) { + return; + } + + if ( !id ) { + // Only DOM nodes need a new unique ID for each element since their data + // ends up in the global cache + if ( isNode ) { + id = elem[ internalKey ] = core_deletedIds.pop() || jQuery.guid++; + } else { + id = internalKey; + } + } + + if ( !cache[ id ] ) { + // Avoid exposing jQuery metadata on plain JS objects when the object + // is serialized using JSON.stringify + cache[ id ] = isNode ? {} : { toJSON: jQuery.noop }; + } + + // An object can be passed to jQuery.data instead of a key/value pair; this gets + // shallow copied over onto the existing cache + if ( typeof name === "object" || typeof name === "function" ) { + if ( pvt ) { + cache[ id ] = jQuery.extend( cache[ id ], name ); + } else { + cache[ id ].data = jQuery.extend( cache[ id ].data, name ); + } + } + + thisCache = cache[ id ]; + + // jQuery data() is stored in a separate object inside the object's internal data + // cache in order to avoid key collisions between internal data and user-defined + // data. + if ( !pvt ) { + if ( !thisCache.data ) { + thisCache.data = {}; + } + + thisCache = thisCache.data; + } + + if ( data !== undefined ) { + thisCache[ jQuery.camelCase( name ) ] = data; + } + + // Check for both converted-to-camel and non-converted data property names + // If a data property was specified + if ( typeof name === "string" ) { + + // First Try to find as-is property data + ret = thisCache[ name ]; + + // Test for null|undefined property data + if ( ret == null ) { + + // Try to find the camelCased property + ret = thisCache[ jQuery.camelCase( name ) ]; + } + } else { + ret = thisCache; + } + + return ret; +} + +function internalRemoveData( elem, name, pvt ) { + if ( !jQuery.acceptData( elem ) ) { + return; + } + + var thisCache, i, + isNode = elem.nodeType, + + // See jQuery.data for more information + cache = isNode ? jQuery.cache : elem, + id = isNode ? elem[ jQuery.expando ] : jQuery.expando; + + // If there is already no cache entry for this object, there is no + // purpose in continuing + if ( !cache[ id ] ) { + return; + } + + if ( name ) { + + thisCache = pvt ? cache[ id ] : cache[ id ].data; + + if ( thisCache ) { + + // Support array or space separated string names for data keys + if ( !jQuery.isArray( name ) ) { + + // try the string as a key before any manipulation + if ( name in thisCache ) { + name = [ name ]; + } else { + + // split the camel cased version by spaces unless a key with the spaces exists + name = jQuery.camelCase( name ); + if ( name in thisCache ) { + name = [ name ]; + } else { + name = name.split(" "); + } + } + } else { + // If "name" is an array of keys... + // When data is initially created, via ("key", "val") signature, + // keys will be converted to camelCase. + // Since there is no way to tell _how_ a key was added, remove + // both plain key and camelCase key. #12786 + // This will only penalize the array argument path. + name = name.concat( jQuery.map( name, jQuery.camelCase ) ); + } + + i = name.length; + while ( i-- ) { + delete thisCache[ name[i] ]; + } + + // If there is no data left in the cache, we want to continue + // and let the cache object itself get destroyed + if ( pvt ? !isEmptyDataObject(thisCache) : !jQuery.isEmptyObject(thisCache) ) { + return; + } + } + } + + // See jQuery.data for more information + if ( !pvt ) { + delete cache[ id ].data; + + // Don't destroy the parent cache unless the internal data object + // had been the only thing left in it + if ( !isEmptyDataObject( cache[ id ] ) ) { + return; + } + } + + // Destroy the cache + if ( isNode ) { + jQuery.cleanData( [ elem ], true ); + + // Use delete when supported for expandos or `cache` is not a window per isWindow (#10080) + /* jshint eqeqeq: false */ + } else if ( jQuery.support.deleteExpando || cache != cache.window ) { + /* jshint eqeqeq: true */ + delete cache[ id ]; + + // When all else fails, null + } else { + cache[ id ] = null; + } +} + +jQuery.extend({ + cache: {}, + + // The following elements throw uncatchable exceptions if you + // attempt to add expando properties to them. + noData: { + "applet": true, + "embed": true, + // Ban all objects except for Flash (which handle expandos) + "object": "clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" + }, + + hasData: function( elem ) { + elem = elem.nodeType ? jQuery.cache[ elem[jQuery.expando] ] : elem[ jQuery.expando ]; + return !!elem && !isEmptyDataObject( elem ); + }, + + data: function( elem, name, data ) { + return internalData( elem, name, data ); + }, + + removeData: function( elem, name ) { + return internalRemoveData( elem, name ); + }, + + // For internal use only. + _data: function( elem, name, data ) { + return internalData( elem, name, data, true ); + }, + + _removeData: function( elem, name ) { + return internalRemoveData( elem, name, true ); + }, + + // A method for determining if a DOM node can handle the data expando + acceptData: function( elem ) { + // Do not set data on non-element because it will not be cleared (#8335). + if ( elem.nodeType && elem.nodeType !== 1 && elem.nodeType !== 9 ) { + return false; + } + + var noData = elem.nodeName && jQuery.noData[ elem.nodeName.toLowerCase() ]; + + // nodes accept data unless otherwise specified; rejection can be conditional + return !noData || noData !== true && elem.getAttribute("classid") === noData; + } +}); + +jQuery.fn.extend({ + data: function( key, value ) { + var attrs, name, + data = null, + i = 0, + elem = this[0]; + + // Special expections of .data basically thwart jQuery.access, + // so implement the relevant behavior ourselves + + // Gets all values + if ( key === undefined ) { + if ( this.length ) { + data = jQuery.data( elem ); + + if ( elem.nodeType === 1 && !jQuery._data( elem, "parsedAttrs" ) ) { + attrs = elem.attributes; + for ( ; i < attrs.length; i++ ) { + name = attrs[i].name; + + if ( name.indexOf("data-") === 0 ) { + name = jQuery.camelCase( name.slice(5) ); + + dataAttr( elem, name, data[ name ] ); + } + } + jQuery._data( elem, "parsedAttrs", true ); + } + } + + return data; + } + + // Sets multiple values + if ( typeof key === "object" ) { + return this.each(function() { + jQuery.data( this, key ); + }); + } + + return arguments.length > 1 ? + + // Sets one value + this.each(function() { + jQuery.data( this, key, value ); + }) : + + // Gets one value + // Try to fetch any internally stored data first + elem ? dataAttr( elem, key, jQuery.data( elem, key ) ) : null; + }, + + removeData: function( key ) { + return this.each(function() { + jQuery.removeData( this, key ); + }); + } +}); + +function dataAttr( elem, key, data ) { + // If nothing was found internally, try to fetch any + // data from the HTML5 data-* attribute + if ( data === undefined && elem.nodeType === 1 ) { + + var name = "data-" + key.replace( rmultiDash, "-$1" ).toLowerCase(); + + data = elem.getAttribute( name ); + + if ( typeof data === "string" ) { + try { + data = data === "true" ? true : + data === "false" ? false : + data === "null" ? null : + // Only convert to a number if it doesn't change the string + +data + "" === data ? +data : + rbrace.test( data ) ? jQuery.parseJSON( data ) : + data; + } catch( e ) {} + + // Make sure we set the data so it isn't changed later + jQuery.data( elem, key, data ); + + } else { + data = undefined; + } + } + + return data; +} + +// checks a cache object for emptiness +function isEmptyDataObject( obj ) { + var name; + for ( name in obj ) { + + // if the public data object is empty, the private is still empty + if ( name === "data" && jQuery.isEmptyObject( obj[name] ) ) { + continue; + } + if ( name !== "toJSON" ) { + return false; + } + } + + return true; +} +jQuery.extend({ + queue: function( elem, type, data ) { + var queue; + + if ( elem ) { + type = ( type || "fx" ) + "queue"; + queue = jQuery._data( elem, type ); + + // Speed up dequeue by getting out quickly if this is just a lookup + if ( data ) { + if ( !queue || jQuery.isArray(data) ) { + queue = jQuery._data( elem, type, jQuery.makeArray(data) ); + } else { + queue.push( data ); + } + } + return queue || []; + } + }, + + dequeue: function( elem, type ) { + type = type || "fx"; + + var queue = jQuery.queue( elem, type ), + startLength = queue.length, + fn = queue.shift(), + hooks = jQuery._queueHooks( elem, type ), + next = function() { + jQuery.dequeue( elem, type ); + }; + + // If the fx queue is dequeued, always remove the progress sentinel + if ( fn === "inprogress" ) { + fn = queue.shift(); + startLength--; + } + + if ( fn ) { + + // Add a progress sentinel to prevent the fx queue from being + // automatically dequeued + if ( type === "fx" ) { + queue.unshift( "inprogress" ); + } + + // clear up the last queue stop function + delete hooks.stop; + fn.call( elem, next, hooks ); + } + + if ( !startLength && hooks ) { + hooks.empty.fire(); + } + }, + + // not intended for public consumption - generates a queueHooks object, or returns the current one + _queueHooks: function( elem, type ) { + var key = type + "queueHooks"; + return jQuery._data( elem, key ) || jQuery._data( elem, key, { + empty: jQuery.Callbacks("once memory").add(function() { + jQuery._removeData( elem, type + "queue" ); + jQuery._removeData( elem, key ); + }) + }); + } +}); + +jQuery.fn.extend({ + queue: function( type, data ) { + var setter = 2; + + if ( typeof type !== "string" ) { + data = type; + type = "fx"; + setter--; + } + + if ( arguments.length < setter ) { + return jQuery.queue( this[0], type ); + } + + return data === undefined ? + this : + this.each(function() { + var queue = jQuery.queue( this, type, data ); + + // ensure a hooks for this queue + jQuery._queueHooks( this, type ); + + if ( type === "fx" && queue[0] !== "inprogress" ) { + jQuery.dequeue( this, type ); + } + }); + }, + dequeue: function( type ) { + return this.each(function() { + jQuery.dequeue( this, type ); + }); + }, + // Based off of the plugin by Clint Helfers, with permission. + // http://blindsignals.com/index.php/2009/07/jquery-delay/ + delay: function( time, type ) { + time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; + type = type || "fx"; + + return this.queue( type, function( next, hooks ) { + var timeout = setTimeout( next, time ); + hooks.stop = function() { + clearTimeout( timeout ); + }; + }); + }, + clearQueue: function( type ) { + return this.queue( type || "fx", [] ); + }, + // Get a promise resolved when queues of a certain type + // are emptied (fx is the type by default) + promise: function( type, obj ) { + var tmp, + count = 1, + defer = jQuery.Deferred(), + elements = this, + i = this.length, + resolve = function() { + if ( !( --count ) ) { + defer.resolveWith( elements, [ elements ] ); + } + }; + + if ( typeof type !== "string" ) { + obj = type; + type = undefined; + } + type = type || "fx"; + + while( i-- ) { + tmp = jQuery._data( elements[ i ], type + "queueHooks" ); + if ( tmp && tmp.empty ) { + count++; + tmp.empty.add( resolve ); + } + } + resolve(); + return defer.promise( obj ); + } +}); +var nodeHook, boolHook, + rclass = /[\t\r\n\f]/g, + rreturn = /\r/g, + rfocusable = /^(?:input|select|textarea|button|object)$/i, + rclickable = /^(?:a|area)$/i, + ruseDefault = /^(?:checked|selected)$/i, + getSetAttribute = jQuery.support.getSetAttribute, + getSetInput = jQuery.support.input; + +jQuery.fn.extend({ + attr: function( name, value ) { + return jQuery.access( this, jQuery.attr, name, value, arguments.length > 1 ); + }, + + removeAttr: function( name ) { + return this.each(function() { + jQuery.removeAttr( this, name ); + }); + }, + + prop: function( name, value ) { + return jQuery.access( this, jQuery.prop, name, value, arguments.length > 1 ); + }, + + removeProp: function( name ) { + name = jQuery.propFix[ name ] || name; + return this.each(function() { + // try/catch handles cases where IE balks (such as removing a property on window) + try { + this[ name ] = undefined; + delete this[ name ]; + } catch( e ) {} + }); + }, + + addClass: function( value ) { + var classes, elem, cur, clazz, j, + i = 0, + len = this.length, + proceed = typeof value === "string" && value; + + if ( jQuery.isFunction( value ) ) { + return this.each(function( j ) { + jQuery( this ).addClass( value.call( this, j, this.className ) ); + }); + } + + if ( proceed ) { + // The disjunction here is for better compressibility (see removeClass) + classes = ( value || "" ).match( core_rnotwhite ) || []; + + for ( ; i < len; i++ ) { + elem = this[ i ]; + cur = elem.nodeType === 1 && ( elem.className ? + ( " " + elem.className + " " ).replace( rclass, " " ) : + " " + ); + + if ( cur ) { + j = 0; + while ( (clazz = classes[j++]) ) { + if ( cur.indexOf( " " + clazz + " " ) < 0 ) { + cur += clazz + " "; + } + } + elem.className = jQuery.trim( cur ); + + } + } + } + + return this; + }, + + removeClass: function( value ) { + var classes, elem, cur, clazz, j, + i = 0, + len = this.length, + proceed = arguments.length === 0 || typeof value === "string" && value; + + if ( jQuery.isFunction( value ) ) { + return this.each(function( j ) { + jQuery( this ).removeClass( value.call( this, j, this.className ) ); + }); + } + if ( proceed ) { + classes = ( value || "" ).match( core_rnotwhite ) || []; + + for ( ; i < len; i++ ) { + elem = this[ i ]; + // This expression is here for better compressibility (see addClass) + cur = elem.nodeType === 1 && ( elem.className ? + ( " " + elem.className + " " ).replace( rclass, " " ) : + "" + ); + + if ( cur ) { + j = 0; + while ( (clazz = classes[j++]) ) { + // Remove *all* instances + while ( cur.indexOf( " " + clazz + " " ) >= 0 ) { + cur = cur.replace( " " + clazz + " ", " " ); + } + } + elem.className = value ? jQuery.trim( cur ) : ""; + } + } + } + + return this; + }, + + toggleClass: function( value, stateVal ) { + var type = typeof value; + + if ( typeof stateVal === "boolean" && type === "string" ) { + return stateVal ? this.addClass( value ) : this.removeClass( value ); + } + + if ( jQuery.isFunction( value ) ) { + return this.each(function( i ) { + jQuery( this ).toggleClass( value.call(this, i, this.className, stateVal), stateVal ); + }); + } + + return this.each(function() { + if ( type === "string" ) { + // toggle individual class names + var className, + i = 0, + self = jQuery( this ), + classNames = value.match( core_rnotwhite ) || []; + + while ( (className = classNames[ i++ ]) ) { + // check each className given, space separated list + if ( self.hasClass( className ) ) { + self.removeClass( className ); + } else { + self.addClass( className ); + } + } + + // Toggle whole class name + } else if ( type === core_strundefined || type === "boolean" ) { + if ( this.className ) { + // store className if set + jQuery._data( this, "__className__", this.className ); + } + + // If the element has a class name or if we're passed "false", + // then remove the whole classname (if there was one, the above saved it). + // Otherwise bring back whatever was previously saved (if anything), + // falling back to the empty string if nothing was stored. + this.className = this.className || value === false ? "" : jQuery._data( this, "__className__" ) || ""; + } + }); + }, + + hasClass: function( selector ) { + var className = " " + selector + " ", + i = 0, + l = this.length; + for ( ; i < l; i++ ) { + if ( this[i].nodeType === 1 && (" " + this[i].className + " ").replace(rclass, " ").indexOf( className ) >= 0 ) { + return true; + } + } + + return false; + }, + + val: function( value ) { + var ret, hooks, isFunction, + elem = this[0]; + + if ( !arguments.length ) { + if ( elem ) { + hooks = jQuery.valHooks[ elem.type ] || jQuery.valHooks[ elem.nodeName.toLowerCase() ]; + + if ( hooks && "get" in hooks && (ret = hooks.get( elem, "value" )) !== undefined ) { + return ret; + } + + ret = elem.value; + + return typeof ret === "string" ? + // handle most common string cases + ret.replace(rreturn, "") : + // handle cases where value is null/undef or number + ret == null ? "" : ret; + } + + return; + } + + isFunction = jQuery.isFunction( value ); + + return this.each(function( i ) { + var val; + + if ( this.nodeType !== 1 ) { + return; + } + + if ( isFunction ) { + val = value.call( this, i, jQuery( this ).val() ); + } else { + val = value; + } + + // Treat null/undefined as ""; convert numbers to string + if ( val == null ) { + val = ""; + } else if ( typeof val === "number" ) { + val += ""; + } else if ( jQuery.isArray( val ) ) { + val = jQuery.map(val, function ( value ) { + return value == null ? "" : value + ""; + }); + } + + hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; + + // If set returns undefined, fall back to normal setting + if ( !hooks || !("set" in hooks) || hooks.set( this, val, "value" ) === undefined ) { + this.value = val; + } + }); + } +}); + +jQuery.extend({ + valHooks: { + option: { + get: function( elem ) { + // Use proper attribute retrieval(#6932, #12072) + var val = jQuery.find.attr( elem, "value" ); + return val != null ? + val : + elem.text; + } + }, + select: { + get: function( elem ) { + var value, option, + options = elem.options, + index = elem.selectedIndex, + one = elem.type === "select-one" || index < 0, + values = one ? null : [], + max = one ? index + 1 : options.length, + i = index < 0 ? + max : + one ? index : 0; + + // Loop through all the selected options + for ( ; i < max; i++ ) { + option = options[ i ]; + + // oldIE doesn't update selected after form reset (#2551) + if ( ( option.selected || i === index ) && + // Don't return options that are disabled or in a disabled optgroup + ( jQuery.support.optDisabled ? !option.disabled : option.getAttribute("disabled") === null ) && + ( !option.parentNode.disabled || !jQuery.nodeName( option.parentNode, "optgroup" ) ) ) { + + // Get the specific value for the option + value = jQuery( option ).val(); + + // We don't need an array for one selects + if ( one ) { + return value; + } + + // Multi-Selects return an array + values.push( value ); + } + } + + return values; + }, + + set: function( elem, value ) { + var optionSet, option, + options = elem.options, + values = jQuery.makeArray( value ), + i = options.length; + + while ( i-- ) { + option = options[ i ]; + if ( (option.selected = jQuery.inArray( jQuery(option).val(), values ) >= 0) ) { + optionSet = true; + } + } + + // force browsers to behave consistently when non-matching value is set + if ( !optionSet ) { + elem.selectedIndex = -1; + } + return values; + } + } + }, + + attr: function( elem, name, value ) { + var hooks, ret, + nType = elem.nodeType; + + // don't get/set attributes on text, comment and attribute nodes + if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + // Fallback to prop when attributes are not supported + if ( typeof elem.getAttribute === core_strundefined ) { + return jQuery.prop( elem, name, value ); + } + + // All attributes are lowercase + // Grab necessary hook if one is defined + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + name = name.toLowerCase(); + hooks = jQuery.attrHooks[ name ] || + ( jQuery.expr.match.bool.test( name ) ? boolHook : nodeHook ); + } + + if ( value !== undefined ) { + + if ( value === null ) { + jQuery.removeAttr( elem, name ); + + } else if ( hooks && "set" in hooks && (ret = hooks.set( elem, value, name )) !== undefined ) { + return ret; + + } else { + elem.setAttribute( name, value + "" ); + return value; + } + + } else if ( hooks && "get" in hooks && (ret = hooks.get( elem, name )) !== null ) { + return ret; + + } else { + ret = jQuery.find.attr( elem, name ); + + // Non-existent attributes return null, we normalize to undefined + return ret == null ? + undefined : + ret; + } + }, + + removeAttr: function( elem, value ) { + var name, propName, + i = 0, + attrNames = value && value.match( core_rnotwhite ); + + if ( attrNames && elem.nodeType === 1 ) { + while ( (name = attrNames[i++]) ) { + propName = jQuery.propFix[ name ] || name; + + // Boolean attributes get special treatment (#10870) + if ( jQuery.expr.match.bool.test( name ) ) { + // Set corresponding property to false + if ( getSetInput && getSetAttribute || !ruseDefault.test( name ) ) { + elem[ propName ] = false; + // Support: IE<9 + // Also clear defaultChecked/defaultSelected (if appropriate) + } else { + elem[ jQuery.camelCase( "default-" + name ) ] = + elem[ propName ] = false; + } + + // See #9699 for explanation of this approach (setting first, then removal) + } else { + jQuery.attr( elem, name, "" ); + } + + elem.removeAttribute( getSetAttribute ? name : propName ); + } + } + }, + + attrHooks: { + type: { + set: function( elem, value ) { + if ( !jQuery.support.radioValue && value === "radio" && jQuery.nodeName(elem, "input") ) { + // Setting the type on a radio button after the value resets the value in IE6-9 + // Reset value to default in case type is set after value during creation + var val = elem.value; + elem.setAttribute( "type", value ); + if ( val ) { + elem.value = val; + } + return value; + } + } + } + }, + + propFix: { + "for": "htmlFor", + "class": "className" + }, + + prop: function( elem, name, value ) { + var ret, hooks, notxml, + nType = elem.nodeType; + + // don't get/set properties on text, comment and attribute nodes + if ( !elem || nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + notxml = nType !== 1 || !jQuery.isXMLDoc( elem ); + + if ( notxml ) { + // Fix name and attach hooks + name = jQuery.propFix[ name ] || name; + hooks = jQuery.propHooks[ name ]; + } + + if ( value !== undefined ) { + return hooks && "set" in hooks && (ret = hooks.set( elem, value, name )) !== undefined ? + ret : + ( elem[ name ] = value ); + + } else { + return hooks && "get" in hooks && (ret = hooks.get( elem, name )) !== null ? + ret : + elem[ name ]; + } + }, + + propHooks: { + tabIndex: { + get: function( elem ) { + // elem.tabIndex doesn't always return the correct value when it hasn't been explicitly set + // http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ + // Use proper attribute retrieval(#12072) + var tabindex = jQuery.find.attr( elem, "tabindex" ); + + return tabindex ? + parseInt( tabindex, 10 ) : + rfocusable.test( elem.nodeName ) || rclickable.test( elem.nodeName ) && elem.href ? + 0 : + -1; + } + } + } +}); + +// Hooks for boolean attributes +boolHook = { + set: function( elem, value, name ) { + if ( value === false ) { + // Remove boolean attributes when set to false + jQuery.removeAttr( elem, name ); + } else if ( getSetInput && getSetAttribute || !ruseDefault.test( name ) ) { + // IE<8 needs the *property* name + elem.setAttribute( !getSetAttribute && jQuery.propFix[ name ] || name, name ); + + // Use defaultChecked and defaultSelected for oldIE + } else { + elem[ jQuery.camelCase( "default-" + name ) ] = elem[ name ] = true; + } + + return name; + } +}; +jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( i, name ) { + var getter = jQuery.expr.attrHandle[ name ] || jQuery.find.attr; + + jQuery.expr.attrHandle[ name ] = getSetInput && getSetAttribute || !ruseDefault.test( name ) ? + function( elem, name, isXML ) { + var fn = jQuery.expr.attrHandle[ name ], + ret = isXML ? + undefined : + /* jshint eqeqeq: false */ + (jQuery.expr.attrHandle[ name ] = undefined) != + getter( elem, name, isXML ) ? + + name.toLowerCase() : + null; + jQuery.expr.attrHandle[ name ] = fn; + return ret; + } : + function( elem, name, isXML ) { + return isXML ? + undefined : + elem[ jQuery.camelCase( "default-" + name ) ] ? + name.toLowerCase() : + null; + }; +}); + +// fix oldIE attroperties +if ( !getSetInput || !getSetAttribute ) { + jQuery.attrHooks.value = { + set: function( elem, value, name ) { + if ( jQuery.nodeName( elem, "input" ) ) { + // Does not return so that setAttribute is also used + elem.defaultValue = value; + } else { + // Use nodeHook if defined (#1954); otherwise setAttribute is fine + return nodeHook && nodeHook.set( elem, value, name ); + } + } + }; +} + +// IE6/7 do not support getting/setting some attributes with get/setAttribute +if ( !getSetAttribute ) { + + // Use this for any attribute in IE6/7 + // This fixes almost every IE6/7 issue + nodeHook = { + set: function( elem, value, name ) { + // Set the existing or create a new attribute node + var ret = elem.getAttributeNode( name ); + if ( !ret ) { + elem.setAttributeNode( + (ret = elem.ownerDocument.createAttribute( name )) + ); + } + + ret.value = value += ""; + + // Break association with cloned elements by also using setAttribute (#9646) + return name === "value" || value === elem.getAttribute( name ) ? + value : + undefined; + } + }; + jQuery.expr.attrHandle.id = jQuery.expr.attrHandle.name = jQuery.expr.attrHandle.coords = + // Some attributes are constructed with empty-string values when not defined + function( elem, name, isXML ) { + var ret; + return isXML ? + undefined : + (ret = elem.getAttributeNode( name )) && ret.value !== "" ? + ret.value : + null; + }; + jQuery.valHooks.button = { + get: function( elem, name ) { + var ret = elem.getAttributeNode( name ); + return ret && ret.specified ? + ret.value : + undefined; + }, + set: nodeHook.set + }; + + // Set contenteditable to false on removals(#10429) + // Setting to empty string throws an error as an invalid value + jQuery.attrHooks.contenteditable = { + set: function( elem, value, name ) { + nodeHook.set( elem, value === "" ? false : value, name ); + } + }; + + // Set width and height to auto instead of 0 on empty string( Bug #8150 ) + // This is for removals + jQuery.each([ "width", "height" ], function( i, name ) { + jQuery.attrHooks[ name ] = { + set: function( elem, value ) { + if ( value === "" ) { + elem.setAttribute( name, "auto" ); + return value; + } + } + }; + }); +} + + +// Some attributes require a special call on IE +// http://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx +if ( !jQuery.support.hrefNormalized ) { + // href/src property should get the full normalized URL (#10299/#12915) + jQuery.each([ "href", "src" ], function( i, name ) { + jQuery.propHooks[ name ] = { + get: function( elem ) { + return elem.getAttribute( name, 4 ); + } + }; + }); +} + +if ( !jQuery.support.style ) { + jQuery.attrHooks.style = { + get: function( elem ) { + // Return undefined in the case of empty string + // Note: IE uppercases css property names, but if we were to .toLowerCase() + // .cssText, that would destroy case senstitivity in URL's, like in "background" + return elem.style.cssText || undefined; + }, + set: function( elem, value ) { + return ( elem.style.cssText = value + "" ); + } + }; +} + +// Safari mis-reports the default selected property of an option +// Accessing the parent's selectedIndex property fixes it +if ( !jQuery.support.optSelected ) { + jQuery.propHooks.selected = { + get: function( elem ) { + var parent = elem.parentNode; + + if ( parent ) { + parent.selectedIndex; + + // Make sure that it also works with optgroups, see #5701 + if ( parent.parentNode ) { + parent.parentNode.selectedIndex; + } + } + return null; + } + }; +} + +jQuery.each([ + "tabIndex", + "readOnly", + "maxLength", + "cellSpacing", + "cellPadding", + "rowSpan", + "colSpan", + "useMap", + "frameBorder", + "contentEditable" +], function() { + jQuery.propFix[ this.toLowerCase() ] = this; +}); + +// IE6/7 call enctype encoding +if ( !jQuery.support.enctype ) { + jQuery.propFix.enctype = "encoding"; +} + +// Radios and checkboxes getter/setter +jQuery.each([ "radio", "checkbox" ], function() { + jQuery.valHooks[ this ] = { + set: function( elem, value ) { + if ( jQuery.isArray( value ) ) { + return ( elem.checked = jQuery.inArray( jQuery(elem).val(), value ) >= 0 ); + } + } + }; + if ( !jQuery.support.checkOn ) { + jQuery.valHooks[ this ].get = function( elem ) { + // Support: Webkit + // "" is returned instead of "on" if a value isn't specified + return elem.getAttribute("value") === null ? "on" : elem.value; + }; + } +}); +var rformElems = /^(?:input|select|textarea)$/i, + rkeyEvent = /^key/, + rmouseEvent = /^(?:mouse|contextmenu)|click/, + rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, + rtypenamespace = /^([^.]*)(?:\.(.+)|)$/; + +function returnTrue() { + return true; +} + +function returnFalse() { + return false; +} + +function safeActiveElement() { + try { + return document.activeElement; + } catch ( err ) { } +} + +/* + * Helper functions for managing events -- not part of the public interface. + * Props to Dean Edwards' addEvent library for many of the ideas. + */ +jQuery.event = { + + global: {}, + + add: function( elem, types, handler, data, selector ) { + var tmp, events, t, handleObjIn, + special, eventHandle, handleObj, + handlers, type, namespaces, origType, + elemData = jQuery._data( elem ); + + // Don't attach events to noData or text/comment nodes (but allow plain objects) + if ( !elemData ) { + return; + } + + // Caller can pass in an object of custom data in lieu of the handler + if ( handler.handler ) { + handleObjIn = handler; + handler = handleObjIn.handler; + selector = handleObjIn.selector; + } + + // Make sure that the handler has a unique ID, used to find/remove it later + if ( !handler.guid ) { + handler.guid = jQuery.guid++; + } + + // Init the element's event structure and main handler, if this is the first + if ( !(events = elemData.events) ) { + events = elemData.events = {}; + } + if ( !(eventHandle = elemData.handle) ) { + eventHandle = elemData.handle = function( e ) { + // Discard the second event of a jQuery.event.trigger() and + // when an event is called after a page has unloaded + return typeof jQuery !== core_strundefined && (!e || jQuery.event.triggered !== e.type) ? + jQuery.event.dispatch.apply( eventHandle.elem, arguments ) : + undefined; + }; + // Add elem as a property of the handle fn to prevent a memory leak with IE non-native events + eventHandle.elem = elem; + } + + // Handle multiple events separated by a space + types = ( types || "" ).match( core_rnotwhite ) || [""]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[t] ) || []; + type = origType = tmp[1]; + namespaces = ( tmp[2] || "" ).split( "." ).sort(); + + // There *must* be a type, no attaching namespace-only handlers + if ( !type ) { + continue; + } + + // If event changes its type, use the special event handlers for the changed type + special = jQuery.event.special[ type ] || {}; + + // If selector defined, determine special event api type, otherwise given type + type = ( selector ? special.delegateType : special.bindType ) || type; + + // Update special based on newly reset type + special = jQuery.event.special[ type ] || {}; + + // handleObj is passed to all event handlers + handleObj = jQuery.extend({ + type: type, + origType: origType, + data: data, + handler: handler, + guid: handler.guid, + selector: selector, + needsContext: selector && jQuery.expr.match.needsContext.test( selector ), + namespace: namespaces.join(".") + }, handleObjIn ); + + // Init the event handler queue if we're the first + if ( !(handlers = events[ type ]) ) { + handlers = events[ type ] = []; + handlers.delegateCount = 0; + + // Only use addEventListener/attachEvent if the special events handler returns false + if ( !special.setup || special.setup.call( elem, data, namespaces, eventHandle ) === false ) { + // Bind the global event handler to the element + if ( elem.addEventListener ) { + elem.addEventListener( type, eventHandle, false ); + + } else if ( elem.attachEvent ) { + elem.attachEvent( "on" + type, eventHandle ); + } + } + } + + if ( special.add ) { + special.add.call( elem, handleObj ); + + if ( !handleObj.handler.guid ) { + handleObj.handler.guid = handler.guid; + } + } + + // Add to the element's handler list, delegates in front + if ( selector ) { + handlers.splice( handlers.delegateCount++, 0, handleObj ); + } else { + handlers.push( handleObj ); + } + + // Keep track of which events have ever been used, for event optimization + jQuery.event.global[ type ] = true; + } + + // Nullify elem to prevent memory leaks in IE + elem = null; + }, + + // Detach an event or set of events from an element + remove: function( elem, types, handler, selector, mappedTypes ) { + var j, handleObj, tmp, + origCount, t, events, + special, handlers, type, + namespaces, origType, + elemData = jQuery.hasData( elem ) && jQuery._data( elem ); + + if ( !elemData || !(events = elemData.events) ) { + return; + } + + // Once for each type.namespace in types; type may be omitted + types = ( types || "" ).match( core_rnotwhite ) || [""]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[t] ) || []; + type = origType = tmp[1]; + namespaces = ( tmp[2] || "" ).split( "." ).sort(); + + // Unbind all events (on this namespace, if provided) for the element + if ( !type ) { + for ( type in events ) { + jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); + } + continue; + } + + special = jQuery.event.special[ type ] || {}; + type = ( selector ? special.delegateType : special.bindType ) || type; + handlers = events[ type ] || []; + tmp = tmp[2] && new RegExp( "(^|\\.)" + namespaces.join("\\.(?:.*\\.|)") + "(\\.|$)" ); + + // Remove matching events + origCount = j = handlers.length; + while ( j-- ) { + handleObj = handlers[ j ]; + + if ( ( mappedTypes || origType === handleObj.origType ) && + ( !handler || handler.guid === handleObj.guid ) && + ( !tmp || tmp.test( handleObj.namespace ) ) && + ( !selector || selector === handleObj.selector || selector === "**" && handleObj.selector ) ) { + handlers.splice( j, 1 ); + + if ( handleObj.selector ) { + handlers.delegateCount--; + } + if ( special.remove ) { + special.remove.call( elem, handleObj ); + } + } + } + + // Remove generic event handler if we removed something and no more handlers exist + // (avoids potential for endless recursion during removal of special event handlers) + if ( origCount && !handlers.length ) { + if ( !special.teardown || special.teardown.call( elem, namespaces, elemData.handle ) === false ) { + jQuery.removeEvent( elem, type, elemData.handle ); + } + + delete events[ type ]; + } + } + + // Remove the expando if it's no longer used + if ( jQuery.isEmptyObject( events ) ) { + delete elemData.handle; + + // removeData also checks for emptiness and clears the expando if empty + // so use it instead of delete + jQuery._removeData( elem, "events" ); + } + }, + + trigger: function( event, data, elem, onlyHandlers ) { + var handle, ontype, cur, + bubbleType, special, tmp, i, + eventPath = [ elem || document ], + type = core_hasOwn.call( event, "type" ) ? event.type : event, + namespaces = core_hasOwn.call( event, "namespace" ) ? event.namespace.split(".") : []; + + cur = tmp = elem = elem || document; + + // Don't do events on text and comment nodes + if ( elem.nodeType === 3 || elem.nodeType === 8 ) { + return; + } + + // focus/blur morphs to focusin/out; ensure we're not firing them right now + if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { + return; + } + + if ( type.indexOf(".") >= 0 ) { + // Namespaced trigger; create a regexp to match event type in handle() + namespaces = type.split("."); + type = namespaces.shift(); + namespaces.sort(); + } + ontype = type.indexOf(":") < 0 && "on" + type; + + // Caller can pass in a jQuery.Event object, Object, or just an event type string + event = event[ jQuery.expando ] ? + event : + new jQuery.Event( type, typeof event === "object" && event ); + + // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) + event.isTrigger = onlyHandlers ? 2 : 3; + event.namespace = namespaces.join("."); + event.namespace_re = event.namespace ? + new RegExp( "(^|\\.)" + namespaces.join("\\.(?:.*\\.|)") + "(\\.|$)" ) : + null; + + // Clean up the event in case it is being reused + event.result = undefined; + if ( !event.target ) { + event.target = elem; + } + + // Clone any incoming data and prepend the event, creating the handler arg list + data = data == null ? + [ event ] : + jQuery.makeArray( data, [ event ] ); + + // Allow special events to draw outside the lines + special = jQuery.event.special[ type ] || {}; + if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { + return; + } + + // Determine event propagation path in advance, per W3C events spec (#9951) + // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) + if ( !onlyHandlers && !special.noBubble && !jQuery.isWindow( elem ) ) { + + bubbleType = special.delegateType || type; + if ( !rfocusMorph.test( bubbleType + type ) ) { + cur = cur.parentNode; + } + for ( ; cur; cur = cur.parentNode ) { + eventPath.push( cur ); + tmp = cur; + } + + // Only add window if we got to document (e.g., not plain obj or detached DOM) + if ( tmp === (elem.ownerDocument || document) ) { + eventPath.push( tmp.defaultView || tmp.parentWindow || window ); + } + } + + // Fire handlers on the event path + i = 0; + while ( (cur = eventPath[i++]) && !event.isPropagationStopped() ) { + + event.type = i > 1 ? + bubbleType : + special.bindType || type; + + // jQuery handler + handle = ( jQuery._data( cur, "events" ) || {} )[ event.type ] && jQuery._data( cur, "handle" ); + if ( handle ) { + handle.apply( cur, data ); + } + + // Native handler + handle = ontype && cur[ ontype ]; + if ( handle && jQuery.acceptData( cur ) && handle.apply && handle.apply( cur, data ) === false ) { + event.preventDefault(); + } + } + event.type = type; + + // If nobody prevented the default action, do it now + if ( !onlyHandlers && !event.isDefaultPrevented() ) { + + if ( (!special._default || special._default.apply( eventPath.pop(), data ) === false) && + jQuery.acceptData( elem ) ) { + + // Call a native DOM method on the target with the same name name as the event. + // Can't use an .isFunction() check here because IE6/7 fails that test. + // Don't do default actions on window, that's where global variables be (#6170) + if ( ontype && elem[ type ] && !jQuery.isWindow( elem ) ) { + + // Don't re-trigger an onFOO event when we call its FOO() method + tmp = elem[ ontype ]; + + if ( tmp ) { + elem[ ontype ] = null; + } + + // Prevent re-triggering of the same event, since we already bubbled it above + jQuery.event.triggered = type; + try { + elem[ type ](); + } catch ( e ) { + // IE<9 dies on focus/blur to hidden element (#1486,#12518) + // only reproducible on winXP IE8 native, not IE9 in IE8 mode + } + jQuery.event.triggered = undefined; + + if ( tmp ) { + elem[ ontype ] = tmp; + } + } + } + } + + return event.result; + }, + + dispatch: function( event ) { + + // Make a writable jQuery.Event from the native event object + event = jQuery.event.fix( event ); + + var i, ret, handleObj, matched, j, + handlerQueue = [], + args = core_slice.call( arguments ), + handlers = ( jQuery._data( this, "events" ) || {} )[ event.type ] || [], + special = jQuery.event.special[ event.type ] || {}; + + // Use the fix-ed jQuery.Event rather than the (read-only) native event + args[0] = event; + event.delegateTarget = this; + + // Call the preDispatch hook for the mapped type, and let it bail if desired + if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { + return; + } + + // Determine handlers + handlerQueue = jQuery.event.handlers.call( this, event, handlers ); + + // Run delegates first; they may want to stop propagation beneath us + i = 0; + while ( (matched = handlerQueue[ i++ ]) && !event.isPropagationStopped() ) { + event.currentTarget = matched.elem; + + j = 0; + while ( (handleObj = matched.handlers[ j++ ]) && !event.isImmediatePropagationStopped() ) { + + // Triggered event must either 1) have no namespace, or + // 2) have namespace(s) a subset or equal to those in the bound event (both can have no namespace). + if ( !event.namespace_re || event.namespace_re.test( handleObj.namespace ) ) { + + event.handleObj = handleObj; + event.data = handleObj.data; + + ret = ( (jQuery.event.special[ handleObj.origType ] || {}).handle || handleObj.handler ) + .apply( matched.elem, args ); + + if ( ret !== undefined ) { + if ( (event.result = ret) === false ) { + event.preventDefault(); + event.stopPropagation(); + } + } + } + } + } + + // Call the postDispatch hook for the mapped type + if ( special.postDispatch ) { + special.postDispatch.call( this, event ); + } + + return event.result; + }, + + handlers: function( event, handlers ) { + var sel, handleObj, matches, i, + handlerQueue = [], + delegateCount = handlers.delegateCount, + cur = event.target; + + // Find delegate handlers + // Black-hole SVG instance trees (#13180) + // Avoid non-left-click bubbling in Firefox (#3861) + if ( delegateCount && cur.nodeType && (!event.button || event.type !== "click") ) { + + /* jshint eqeqeq: false */ + for ( ; cur != this; cur = cur.parentNode || this ) { + /* jshint eqeqeq: true */ + + // Don't check non-elements (#13208) + // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) + if ( cur.nodeType === 1 && (cur.disabled !== true || event.type !== "click") ) { + matches = []; + for ( i = 0; i < delegateCount; i++ ) { + handleObj = handlers[ i ]; + + // Don't conflict with Object.prototype properties (#13203) + sel = handleObj.selector + " "; + + if ( matches[ sel ] === undefined ) { + matches[ sel ] = handleObj.needsContext ? + jQuery( sel, this ).index( cur ) >= 0 : + jQuery.find( sel, this, null, [ cur ] ).length; + } + if ( matches[ sel ] ) { + matches.push( handleObj ); + } + } + if ( matches.length ) { + handlerQueue.push({ elem: cur, handlers: matches }); + } + } + } + } + + // Add the remaining (directly-bound) handlers + if ( delegateCount < handlers.length ) { + handlerQueue.push({ elem: this, handlers: handlers.slice( delegateCount ) }); + } + + return handlerQueue; + }, + + fix: function( event ) { + if ( event[ jQuery.expando ] ) { + return event; + } + + // Create a writable copy of the event object and normalize some properties + var i, prop, copy, + type = event.type, + originalEvent = event, + fixHook = this.fixHooks[ type ]; + + if ( !fixHook ) { + this.fixHooks[ type ] = fixHook = + rmouseEvent.test( type ) ? this.mouseHooks : + rkeyEvent.test( type ) ? this.keyHooks : + {}; + } + copy = fixHook.props ? this.props.concat( fixHook.props ) : this.props; + + event = new jQuery.Event( originalEvent ); + + i = copy.length; + while ( i-- ) { + prop = copy[ i ]; + event[ prop ] = originalEvent[ prop ]; + } + + // Support: IE<9 + // Fix target property (#1925) + if ( !event.target ) { + event.target = originalEvent.srcElement || document; + } + + // Support: Chrome 23+, Safari? + // Target should not be a text node (#504, #13143) + if ( event.target.nodeType === 3 ) { + event.target = event.target.parentNode; + } + + // Support: IE<9 + // For mouse/key events, metaKey==false if it's undefined (#3368, #11328) + event.metaKey = !!event.metaKey; + + return fixHook.filter ? fixHook.filter( event, originalEvent ) : event; + }, + + // Includes some event props shared by KeyEvent and MouseEvent + props: "altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "), + + fixHooks: {}, + + keyHooks: { + props: "char charCode key keyCode".split(" "), + filter: function( event, original ) { + + // Add which for key events + if ( event.which == null ) { + event.which = original.charCode != null ? original.charCode : original.keyCode; + } + + return event; + } + }, + + mouseHooks: { + props: "button buttons clientX clientY fromElement offsetX offsetY pageX pageY screenX screenY toElement".split(" "), + filter: function( event, original ) { + var body, eventDoc, doc, + button = original.button, + fromElement = original.fromElement; + + // Calculate pageX/Y if missing and clientX/Y available + if ( event.pageX == null && original.clientX != null ) { + eventDoc = event.target.ownerDocument || document; + doc = eventDoc.documentElement; + body = eventDoc.body; + + event.pageX = original.clientX + ( doc && doc.scrollLeft || body && body.scrollLeft || 0 ) - ( doc && doc.clientLeft || body && body.clientLeft || 0 ); + event.pageY = original.clientY + ( doc && doc.scrollTop || body && body.scrollTop || 0 ) - ( doc && doc.clientTop || body && body.clientTop || 0 ); + } + + // Add relatedTarget, if necessary + if ( !event.relatedTarget && fromElement ) { + event.relatedTarget = fromElement === event.target ? original.toElement : fromElement; + } + + // Add which for click: 1 === left; 2 === middle; 3 === right + // Note: button is not normalized, so don't use it + if ( !event.which && button !== undefined ) { + event.which = ( button & 1 ? 1 : ( button & 2 ? 3 : ( button & 4 ? 2 : 0 ) ) ); + } + + return event; + } + }, + + special: { + load: { + // Prevent triggered image.load events from bubbling to window.load + noBubble: true + }, + focus: { + // Fire native event if possible so blur/focus sequence is correct + trigger: function() { + if ( this !== safeActiveElement() && this.focus ) { + try { + this.focus(); + return false; + } catch ( e ) { + // Support: IE<9 + // If we error on focus to hidden element (#1486, #12518), + // let .trigger() run the handlers + } + } + }, + delegateType: "focusin" + }, + blur: { + trigger: function() { + if ( this === safeActiveElement() && this.blur ) { + this.blur(); + return false; + } + }, + delegateType: "focusout" + }, + click: { + // For checkbox, fire native event so checked state will be right + trigger: function() { + if ( jQuery.nodeName( this, "input" ) && this.type === "checkbox" && this.click ) { + this.click(); + return false; + } + }, + + // For cross-browser consistency, don't fire native .click() on links + _default: function( event ) { + return jQuery.nodeName( event.target, "a" ); + } + }, + + beforeunload: { + postDispatch: function( event ) { + + // Even when returnValue equals to undefined Firefox will still show alert + if ( event.result !== undefined ) { + event.originalEvent.returnValue = event.result; + } + } + } + }, + + simulate: function( type, elem, event, bubble ) { + // Piggyback on a donor event to simulate a different one. + // Fake originalEvent to avoid donor's stopPropagation, but if the + // simulated event prevents default then we do the same on the donor. + var e = jQuery.extend( + new jQuery.Event(), + event, + { + type: type, + isSimulated: true, + originalEvent: {} + } + ); + if ( bubble ) { + jQuery.event.trigger( e, null, elem ); + } else { + jQuery.event.dispatch.call( elem, e ); + } + if ( e.isDefaultPrevented() ) { + event.preventDefault(); + } + } +}; + +jQuery.removeEvent = document.removeEventListener ? + function( elem, type, handle ) { + if ( elem.removeEventListener ) { + elem.removeEventListener( type, handle, false ); + } + } : + function( elem, type, handle ) { + var name = "on" + type; + + if ( elem.detachEvent ) { + + // #8545, #7054, preventing memory leaks for custom events in IE6-8 + // detachEvent needed property on element, by name of that event, to properly expose it to GC + if ( typeof elem[ name ] === core_strundefined ) { + elem[ name ] = null; + } + + elem.detachEvent( name, handle ); + } + }; + +jQuery.Event = function( src, props ) { + // Allow instantiation without the 'new' keyword + if ( !(this instanceof jQuery.Event) ) { + return new jQuery.Event( src, props ); + } + + // Event object + if ( src && src.type ) { + this.originalEvent = src; + this.type = src.type; + + // Events bubbling up the document may have been marked as prevented + // by a handler lower down the tree; reflect the correct value. + this.isDefaultPrevented = ( src.defaultPrevented || src.returnValue === false || + src.getPreventDefault && src.getPreventDefault() ) ? returnTrue : returnFalse; + + // Event type + } else { + this.type = src; + } + + // Put explicitly provided properties onto the event object + if ( props ) { + jQuery.extend( this, props ); + } + + // Create a timestamp if incoming event doesn't have one + this.timeStamp = src && src.timeStamp || jQuery.now(); + + // Mark it as fixed + this[ jQuery.expando ] = true; +}; + +// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding +// http://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html +jQuery.Event.prototype = { + isDefaultPrevented: returnFalse, + isPropagationStopped: returnFalse, + isImmediatePropagationStopped: returnFalse, + + preventDefault: function() { + var e = this.originalEvent; + + this.isDefaultPrevented = returnTrue; + if ( !e ) { + return; + } + + // If preventDefault exists, run it on the original event + if ( e.preventDefault ) { + e.preventDefault(); + + // Support: IE + // Otherwise set the returnValue property of the original event to false + } else { + e.returnValue = false; + } + }, + stopPropagation: function() { + var e = this.originalEvent; + + this.isPropagationStopped = returnTrue; + if ( !e ) { + return; + } + // If stopPropagation exists, run it on the original event + if ( e.stopPropagation ) { + e.stopPropagation(); + } + + // Support: IE + // Set the cancelBubble property of the original event to true + e.cancelBubble = true; + }, + stopImmediatePropagation: function() { + this.isImmediatePropagationStopped = returnTrue; + this.stopPropagation(); + } +}; + +// Create mouseenter/leave events using mouseover/out and event-time checks +jQuery.each({ + mouseenter: "mouseover", + mouseleave: "mouseout" +}, function( orig, fix ) { + jQuery.event.special[ orig ] = { + delegateType: fix, + bindType: fix, + + handle: function( event ) { + var ret, + target = this, + related = event.relatedTarget, + handleObj = event.handleObj; + + // For mousenter/leave call the handler if related is outside the target. + // NB: No relatedTarget if the mouse left/entered the browser window + if ( !related || (related !== target && !jQuery.contains( target, related )) ) { + event.type = handleObj.origType; + ret = handleObj.handler.apply( this, arguments ); + event.type = fix; + } + return ret; + } + }; +}); + +// IE submit delegation +if ( !jQuery.support.submitBubbles ) { + + jQuery.event.special.submit = { + setup: function() { + // Only need this for delegated form submit events + if ( jQuery.nodeName( this, "form" ) ) { + return false; + } + + // Lazy-add a submit handler when a descendant form may potentially be submitted + jQuery.event.add( this, "click._submit keypress._submit", function( e ) { + // Node name check avoids a VML-related crash in IE (#9807) + var elem = e.target, + form = jQuery.nodeName( elem, "input" ) || jQuery.nodeName( elem, "button" ) ? elem.form : undefined; + if ( form && !jQuery._data( form, "submitBubbles" ) ) { + jQuery.event.add( form, "submit._submit", function( event ) { + event._submit_bubble = true; + }); + jQuery._data( form, "submitBubbles", true ); + } + }); + // return undefined since we don't need an event listener + }, + + postDispatch: function( event ) { + // If form was submitted by the user, bubble the event up the tree + if ( event._submit_bubble ) { + delete event._submit_bubble; + if ( this.parentNode && !event.isTrigger ) { + jQuery.event.simulate( "submit", this.parentNode, event, true ); + } + } + }, + + teardown: function() { + // Only need this for delegated form submit events + if ( jQuery.nodeName( this, "form" ) ) { + return false; + } + + // Remove delegated handlers; cleanData eventually reaps submit handlers attached above + jQuery.event.remove( this, "._submit" ); + } + }; +} + +// IE change delegation and checkbox/radio fix +if ( !jQuery.support.changeBubbles ) { + + jQuery.event.special.change = { + + setup: function() { + + if ( rformElems.test( this.nodeName ) ) { + // IE doesn't fire change on a check/radio until blur; trigger it on click + // after a propertychange. Eat the blur-change in special.change.handle. + // This still fires onchange a second time for check/radio after blur. + if ( this.type === "checkbox" || this.type === "radio" ) { + jQuery.event.add( this, "propertychange._change", function( event ) { + if ( event.originalEvent.propertyName === "checked" ) { + this._just_changed = true; + } + }); + jQuery.event.add( this, "click._change", function( event ) { + if ( this._just_changed && !event.isTrigger ) { + this._just_changed = false; + } + // Allow triggered, simulated change events (#11500) + jQuery.event.simulate( "change", this, event, true ); + }); + } + return false; + } + // Delegated event; lazy-add a change handler on descendant inputs + jQuery.event.add( this, "beforeactivate._change", function( e ) { + var elem = e.target; + + if ( rformElems.test( elem.nodeName ) && !jQuery._data( elem, "changeBubbles" ) ) { + jQuery.event.add( elem, "change._change", function( event ) { + if ( this.parentNode && !event.isSimulated && !event.isTrigger ) { + jQuery.event.simulate( "change", this.parentNode, event, true ); + } + }); + jQuery._data( elem, "changeBubbles", true ); + } + }); + }, + + handle: function( event ) { + var elem = event.target; + + // Swallow native change events from checkbox/radio, we already triggered them above + if ( this !== elem || event.isSimulated || event.isTrigger || (elem.type !== "radio" && elem.type !== "checkbox") ) { + return event.handleObj.handler.apply( this, arguments ); + } + }, + + teardown: function() { + jQuery.event.remove( this, "._change" ); + + return !rformElems.test( this.nodeName ); + } + }; +} + +// Create "bubbling" focus and blur events +if ( !jQuery.support.focusinBubbles ) { + jQuery.each({ focus: "focusin", blur: "focusout" }, function( orig, fix ) { + + // Attach a single capturing handler while someone wants focusin/focusout + var attaches = 0, + handler = function( event ) { + jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ), true ); + }; + + jQuery.event.special[ fix ] = { + setup: function() { + if ( attaches++ === 0 ) { + document.addEventListener( orig, handler, true ); + } + }, + teardown: function() { + if ( --attaches === 0 ) { + document.removeEventListener( orig, handler, true ); + } + } + }; + }); +} + +jQuery.fn.extend({ + + on: function( types, selector, data, fn, /*INTERNAL*/ one ) { + var type, origFn; + + // Types can be a map of types/handlers + if ( typeof types === "object" ) { + // ( types-Object, selector, data ) + if ( typeof selector !== "string" ) { + // ( types-Object, data ) + data = data || selector; + selector = undefined; + } + for ( type in types ) { + this.on( type, selector, data, types[ type ], one ); + } + return this; + } + + if ( data == null && fn == null ) { + // ( types, fn ) + fn = selector; + data = selector = undefined; + } else if ( fn == null ) { + if ( typeof selector === "string" ) { + // ( types, selector, fn ) + fn = data; + data = undefined; + } else { + // ( types, data, fn ) + fn = data; + data = selector; + selector = undefined; + } + } + if ( fn === false ) { + fn = returnFalse; + } else if ( !fn ) { + return this; + } + + if ( one === 1 ) { + origFn = fn; + fn = function( event ) { + // Can use an empty set, since event contains the info + jQuery().off( event ); + return origFn.apply( this, arguments ); + }; + // Use same guid so caller can remove using origFn + fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); + } + return this.each( function() { + jQuery.event.add( this, types, fn, data, selector ); + }); + }, + one: function( types, selector, data, fn ) { + return this.on( types, selector, data, fn, 1 ); + }, + off: function( types, selector, fn ) { + var handleObj, type; + if ( types && types.preventDefault && types.handleObj ) { + // ( event ) dispatched jQuery.Event + handleObj = types.handleObj; + jQuery( types.delegateTarget ).off( + handleObj.namespace ? handleObj.origType + "." + handleObj.namespace : handleObj.origType, + handleObj.selector, + handleObj.handler + ); + return this; + } + if ( typeof types === "object" ) { + // ( types-object [, selector] ) + for ( type in types ) { + this.off( type, selector, types[ type ] ); + } + return this; + } + if ( selector === false || typeof selector === "function" ) { + // ( types [, fn] ) + fn = selector; + selector = undefined; + } + if ( fn === false ) { + fn = returnFalse; + } + return this.each(function() { + jQuery.event.remove( this, types, fn, selector ); + }); + }, + + trigger: function( type, data ) { + return this.each(function() { + jQuery.event.trigger( type, data, this ); + }); + }, + triggerHandler: function( type, data ) { + var elem = this[0]; + if ( elem ) { + return jQuery.event.trigger( type, data, elem, true ); + } + } +}); +var isSimple = /^.[^:#\[\.,]*$/, + rparentsprev = /^(?:parents|prev(?:Until|All))/, + rneedsContext = jQuery.expr.match.needsContext, + // methods guaranteed to produce a unique set when starting from a unique set + guaranteedUnique = { + children: true, + contents: true, + next: true, + prev: true + }; + +jQuery.fn.extend({ + find: function( selector ) { + var i, + ret = [], + self = this, + len = self.length; + + if ( typeof selector !== "string" ) { + return this.pushStack( jQuery( selector ).filter(function() { + for ( i = 0; i < len; i++ ) { + if ( jQuery.contains( self[ i ], this ) ) { + return true; + } + } + }) ); + } + + for ( i = 0; i < len; i++ ) { + jQuery.find( selector, self[ i ], ret ); + } + + // Needed because $( selector, context ) becomes $( context ).find( selector ) + ret = this.pushStack( len > 1 ? jQuery.unique( ret ) : ret ); + ret.selector = this.selector ? this.selector + " " + selector : selector; + return ret; + }, + + has: function( target ) { + var i, + targets = jQuery( target, this ), + len = targets.length; + + return this.filter(function() { + for ( i = 0; i < len; i++ ) { + if ( jQuery.contains( this, targets[i] ) ) { + return true; + } + } + }); + }, + + not: function( selector ) { + return this.pushStack( winnow(this, selector || [], true) ); + }, + + filter: function( selector ) { + return this.pushStack( winnow(this, selector || [], false) ); + }, + + is: function( selector ) { + return !!winnow( + this, + + // If this is a positional/relative selector, check membership in the returned set + // so $("p:first").is("p:last") won't return true for a doc with two "p". + typeof selector === "string" && rneedsContext.test( selector ) ? + jQuery( selector ) : + selector || [], + false + ).length; + }, + + closest: function( selectors, context ) { + var cur, + i = 0, + l = this.length, + ret = [], + pos = rneedsContext.test( selectors ) || typeof selectors !== "string" ? + jQuery( selectors, context || this.context ) : + 0; + + for ( ; i < l; i++ ) { + for ( cur = this[i]; cur && cur !== context; cur = cur.parentNode ) { + // Always skip document fragments + if ( cur.nodeType < 11 && (pos ? + pos.index(cur) > -1 : + + // Don't pass non-elements to Sizzle + cur.nodeType === 1 && + jQuery.find.matchesSelector(cur, selectors)) ) { + + cur = ret.push( cur ); + break; + } + } + } + + return this.pushStack( ret.length > 1 ? jQuery.unique( ret ) : ret ); + }, + + // Determine the position of an element within + // the matched set of elements + index: function( elem ) { + + // No argument, return index in parent + if ( !elem ) { + return ( this[0] && this[0].parentNode ) ? this.first().prevAll().length : -1; + } + + // index in selector + if ( typeof elem === "string" ) { + return jQuery.inArray( this[0], jQuery( elem ) ); + } + + // Locate the position of the desired element + return jQuery.inArray( + // If it receives a jQuery object, the first element is used + elem.jquery ? elem[0] : elem, this ); + }, + + add: function( selector, context ) { + var set = typeof selector === "string" ? + jQuery( selector, context ) : + jQuery.makeArray( selector && selector.nodeType ? [ selector ] : selector ), + all = jQuery.merge( this.get(), set ); + + return this.pushStack( jQuery.unique(all) ); + }, + + addBack: function( selector ) { + return this.add( selector == null ? + this.prevObject : this.prevObject.filter(selector) + ); + } +}); + +function sibling( cur, dir ) { + do { + cur = cur[ dir ]; + } while ( cur && cur.nodeType !== 1 ); + + return cur; +} + +jQuery.each({ + parent: function( elem ) { + var parent = elem.parentNode; + return parent && parent.nodeType !== 11 ? parent : null; + }, + parents: function( elem ) { + return jQuery.dir( elem, "parentNode" ); + }, + parentsUntil: function( elem, i, until ) { + return jQuery.dir( elem, "parentNode", until ); + }, + next: function( elem ) { + return sibling( elem, "nextSibling" ); + }, + prev: function( elem ) { + return sibling( elem, "previousSibling" ); + }, + nextAll: function( elem ) { + return jQuery.dir( elem, "nextSibling" ); + }, + prevAll: function( elem ) { + return jQuery.dir( elem, "previousSibling" ); + }, + nextUntil: function( elem, i, until ) { + return jQuery.dir( elem, "nextSibling", until ); + }, + prevUntil: function( elem, i, until ) { + return jQuery.dir( elem, "previousSibling", until ); + }, + siblings: function( elem ) { + return jQuery.sibling( ( elem.parentNode || {} ).firstChild, elem ); + }, + children: function( elem ) { + return jQuery.sibling( elem.firstChild ); + }, + contents: function( elem ) { + return jQuery.nodeName( elem, "iframe" ) ? + elem.contentDocument || elem.contentWindow.document : + jQuery.merge( [], elem.childNodes ); + } +}, function( name, fn ) { + jQuery.fn[ name ] = function( until, selector ) { + var ret = jQuery.map( this, fn, until ); + + if ( name.slice( -5 ) !== "Until" ) { + selector = until; + } + + if ( selector && typeof selector === "string" ) { + ret = jQuery.filter( selector, ret ); + } + + if ( this.length > 1 ) { + // Remove duplicates + if ( !guaranteedUnique[ name ] ) { + ret = jQuery.unique( ret ); + } + + // Reverse order for parents* and prev-derivatives + if ( rparentsprev.test( name ) ) { + ret = ret.reverse(); + } + } + + return this.pushStack( ret ); + }; +}); + +jQuery.extend({ + filter: function( expr, elems, not ) { + var elem = elems[ 0 ]; + + if ( not ) { + expr = ":not(" + expr + ")"; + } + + return elems.length === 1 && elem.nodeType === 1 ? + jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : [] : + jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { + return elem.nodeType === 1; + })); + }, + + dir: function( elem, dir, until ) { + var matched = [], + cur = elem[ dir ]; + + while ( cur && cur.nodeType !== 9 && (until === undefined || cur.nodeType !== 1 || !jQuery( cur ).is( until )) ) { + if ( cur.nodeType === 1 ) { + matched.push( cur ); + } + cur = cur[dir]; + } + return matched; + }, + + sibling: function( n, elem ) { + var r = []; + + for ( ; n; n = n.nextSibling ) { + if ( n.nodeType === 1 && n !== elem ) { + r.push( n ); + } + } + + return r; + } +}); + +// Implement the identical functionality for filter and not +function winnow( elements, qualifier, not ) { + if ( jQuery.isFunction( qualifier ) ) { + return jQuery.grep( elements, function( elem, i ) { + /* jshint -W018 */ + return !!qualifier.call( elem, i, elem ) !== not; + }); + + } + + if ( qualifier.nodeType ) { + return jQuery.grep( elements, function( elem ) { + return ( elem === qualifier ) !== not; + }); + + } + + if ( typeof qualifier === "string" ) { + if ( isSimple.test( qualifier ) ) { + return jQuery.filter( qualifier, elements, not ); + } + + qualifier = jQuery.filter( qualifier, elements ); + } + + return jQuery.grep( elements, function( elem ) { + return ( jQuery.inArray( elem, qualifier ) >= 0 ) !== not; + }); +} +function createSafeFragment( document ) { + var list = nodeNames.split( "|" ), + safeFrag = document.createDocumentFragment(); + + if ( safeFrag.createElement ) { + while ( list.length ) { + safeFrag.createElement( + list.pop() + ); + } + } + return safeFrag; +} + +var nodeNames = "abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|" + + "header|hgroup|mark|meter|nav|output|progress|section|summary|time|video", + rinlinejQuery = / jQuery\d+="(?:null|\d+)"/g, + rnoshimcache = new RegExp("<(?:" + nodeNames + ")[\\s/>]", "i"), + rleadingWhitespace = /^\s+/, + rxhtmlTag = /<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi, + rtagName = /<([\w:]+)/, + rtbody = /\s*$/g, + + // We have to close these tags to support XHTML (#13200) + wrapMap = { + option: [ 1, "" ], + legend: [ 1, "
", "
" ], + area: [ 1, "", "" ], + param: [ 1, "", "" ], + thead: [ 1, "", "
" ], + tr: [ 2, "", "
" ], + col: [ 2, "", "
" ], + td: [ 3, "", "
" ], + + // IE6-8 can't serialize link, script, style, or any html5 (NoScope) tags, + // unless wrapped in a div with non-breaking characters in front of it. + _default: jQuery.support.htmlSerialize ? [ 0, "", "" ] : [ 1, "X
", "
" ] + }, + safeFragment = createSafeFragment( document ), + fragmentDiv = safeFragment.appendChild( document.createElement("div") ); + +wrapMap.optgroup = wrapMap.option; +wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; +wrapMap.th = wrapMap.td; + +jQuery.fn.extend({ + text: function( value ) { + return jQuery.access( this, function( value ) { + return value === undefined ? + jQuery.text( this ) : + this.empty().append( ( this[0] && this[0].ownerDocument || document ).createTextNode( value ) ); + }, null, value, arguments.length ); + }, + + append: function() { + return this.domManip( arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.appendChild( elem ); + } + }); + }, + + prepend: function() { + return this.domManip( arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.insertBefore( elem, target.firstChild ); + } + }); + }, + + before: function() { + return this.domManip( arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this ); + } + }); + }, + + after: function() { + return this.domManip( arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this.nextSibling ); + } + }); + }, + + // keepData is for internal use only--do not document + remove: function( selector, keepData ) { + var elem, + elems = selector ? jQuery.filter( selector, this ) : this, + i = 0; + + for ( ; (elem = elems[i]) != null; i++ ) { + + if ( !keepData && elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem ) ); + } + + if ( elem.parentNode ) { + if ( keepData && jQuery.contains( elem.ownerDocument, elem ) ) { + setGlobalEval( getAll( elem, "script" ) ); + } + elem.parentNode.removeChild( elem ); + } + } + + return this; + }, + + empty: function() { + var elem, + i = 0; + + for ( ; (elem = this[i]) != null; i++ ) { + // Remove element nodes and prevent memory leaks + if ( elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem, false ) ); + } + + // Remove any remaining nodes + while ( elem.firstChild ) { + elem.removeChild( elem.firstChild ); + } + + // If this is a select, ensure that it displays empty (#12336) + // Support: IE<9 + if ( elem.options && jQuery.nodeName( elem, "select" ) ) { + elem.options.length = 0; + } + } + + return this; + }, + + clone: function( dataAndEvents, deepDataAndEvents ) { + dataAndEvents = dataAndEvents == null ? false : dataAndEvents; + deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; + + return this.map( function () { + return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); + }); + }, + + html: function( value ) { + return jQuery.access( this, function( value ) { + var elem = this[0] || {}, + i = 0, + l = this.length; + + if ( value === undefined ) { + return elem.nodeType === 1 ? + elem.innerHTML.replace( rinlinejQuery, "" ) : + undefined; + } + + // See if we can take a shortcut and just use innerHTML + if ( typeof value === "string" && !rnoInnerhtml.test( value ) && + ( jQuery.support.htmlSerialize || !rnoshimcache.test( value ) ) && + ( jQuery.support.leadingWhitespace || !rleadingWhitespace.test( value ) ) && + !wrapMap[ ( rtagName.exec( value ) || ["", ""] )[1].toLowerCase() ] ) { + + value = value.replace( rxhtmlTag, "<$1>" ); + + try { + for (; i < l; i++ ) { + // Remove element nodes and prevent memory leaks + elem = this[i] || {}; + if ( elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem, false ) ); + elem.innerHTML = value; + } + } + + elem = 0; + + // If using innerHTML throws an exception, use the fallback method + } catch(e) {} + } + + if ( elem ) { + this.empty().append( value ); + } + }, null, value, arguments.length ); + }, + + replaceWith: function() { + var + // Snapshot the DOM in case .domManip sweeps something relevant into its fragment + args = jQuery.map( this, function( elem ) { + return [ elem.nextSibling, elem.parentNode ]; + }), + i = 0; + + // Make the changes, replacing each context element with the new content + this.domManip( arguments, function( elem ) { + var next = args[ i++ ], + parent = args[ i++ ]; + + if ( parent ) { + // Don't use the snapshot next if it has moved (#13810) + if ( next && next.parentNode !== parent ) { + next = this.nextSibling; + } + jQuery( this ).remove(); + parent.insertBefore( elem, next ); + } + // Allow new content to include elements from the context set + }, true ); + + // Force removal if there was no new content (e.g., from empty arguments) + return i ? this : this.remove(); + }, + + detach: function( selector ) { + return this.remove( selector, true ); + }, + + domManip: function( args, callback, allowIntersection ) { + + // Flatten any nested arrays + args = core_concat.apply( [], args ); + + var first, node, hasScripts, + scripts, doc, fragment, + i = 0, + l = this.length, + set = this, + iNoClone = l - 1, + value = args[0], + isFunction = jQuery.isFunction( value ); + + // We can't cloneNode fragments that contain checked, in WebKit + if ( isFunction || !( l <= 1 || typeof value !== "string" || jQuery.support.checkClone || !rchecked.test( value ) ) ) { + return this.each(function( index ) { + var self = set.eq( index ); + if ( isFunction ) { + args[0] = value.call( this, index, self.html() ); + } + self.domManip( args, callback, allowIntersection ); + }); + } + + if ( l ) { + fragment = jQuery.buildFragment( args, this[ 0 ].ownerDocument, false, !allowIntersection && this ); + first = fragment.firstChild; + + if ( fragment.childNodes.length === 1 ) { + fragment = first; + } + + if ( first ) { + scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); + hasScripts = scripts.length; + + // Use the original fragment for the last item instead of the first because it can end up + // being emptied incorrectly in certain situations (#8070). + for ( ; i < l; i++ ) { + node = fragment; + + if ( i !== iNoClone ) { + node = jQuery.clone( node, true, true ); + + // Keep references to cloned scripts for later restoration + if ( hasScripts ) { + jQuery.merge( scripts, getAll( node, "script" ) ); + } + } + + callback.call( this[i], node, i ); + } + + if ( hasScripts ) { + doc = scripts[ scripts.length - 1 ].ownerDocument; + + // Reenable scripts + jQuery.map( scripts, restoreScript ); + + // Evaluate executable scripts on first document insertion + for ( i = 0; i < hasScripts; i++ ) { + node = scripts[ i ]; + if ( rscriptType.test( node.type || "" ) && + !jQuery._data( node, "globalEval" ) && jQuery.contains( doc, node ) ) { + + if ( node.src ) { + // Hope ajax is available... + jQuery._evalUrl( node.src ); + } else { + jQuery.globalEval( ( node.text || node.textContent || node.innerHTML || "" ).replace( rcleanScript, "" ) ); + } + } + } + } + + // Fix #11809: Avoid leaking memory + fragment = first = null; + } + } + + return this; + } +}); + +// Support: IE<8 +// Manipulating tables requires a tbody +function manipulationTarget( elem, content ) { + return jQuery.nodeName( elem, "table" ) && + jQuery.nodeName( content.nodeType === 1 ? content : content.firstChild, "tr" ) ? + + elem.getElementsByTagName("tbody")[0] || + elem.appendChild( elem.ownerDocument.createElement("tbody") ) : + elem; +} + +// Replace/restore the type attribute of script elements for safe DOM manipulation +function disableScript( elem ) { + elem.type = (jQuery.find.attr( elem, "type" ) !== null) + "/" + elem.type; + return elem; +} +function restoreScript( elem ) { + var match = rscriptTypeMasked.exec( elem.type ); + if ( match ) { + elem.type = match[1]; + } else { + elem.removeAttribute("type"); + } + return elem; +} + +// Mark scripts as having already been evaluated +function setGlobalEval( elems, refElements ) { + var elem, + i = 0; + for ( ; (elem = elems[i]) != null; i++ ) { + jQuery._data( elem, "globalEval", !refElements || jQuery._data( refElements[i], "globalEval" ) ); + } +} + +function cloneCopyEvent( src, dest ) { + + if ( dest.nodeType !== 1 || !jQuery.hasData( src ) ) { + return; + } + + var type, i, l, + oldData = jQuery._data( src ), + curData = jQuery._data( dest, oldData ), + events = oldData.events; + + if ( events ) { + delete curData.handle; + curData.events = {}; + + for ( type in events ) { + for ( i = 0, l = events[ type ].length; i < l; i++ ) { + jQuery.event.add( dest, type, events[ type ][ i ] ); + } + } + } + + // make the cloned public data object a copy from the original + if ( curData.data ) { + curData.data = jQuery.extend( {}, curData.data ); + } +} + +function fixCloneNodeIssues( src, dest ) { + var nodeName, e, data; + + // We do not need to do anything for non-Elements + if ( dest.nodeType !== 1 ) { + return; + } + + nodeName = dest.nodeName.toLowerCase(); + + // IE6-8 copies events bound via attachEvent when using cloneNode. + if ( !jQuery.support.noCloneEvent && dest[ jQuery.expando ] ) { + data = jQuery._data( dest ); + + for ( e in data.events ) { + jQuery.removeEvent( dest, e, data.handle ); + } + + // Event data gets referenced instead of copied if the expando gets copied too + dest.removeAttribute( jQuery.expando ); + } + + // IE blanks contents when cloning scripts, and tries to evaluate newly-set text + if ( nodeName === "script" && dest.text !== src.text ) { + disableScript( dest ).text = src.text; + restoreScript( dest ); + + // IE6-10 improperly clones children of object elements using classid. + // IE10 throws NoModificationAllowedError if parent is null, #12132. + } else if ( nodeName === "object" ) { + if ( dest.parentNode ) { + dest.outerHTML = src.outerHTML; + } + + // This path appears unavoidable for IE9. When cloning an object + // element in IE9, the outerHTML strategy above is not sufficient. + // If the src has innerHTML and the destination does not, + // copy the src.innerHTML into the dest.innerHTML. #10324 + if ( jQuery.support.html5Clone && ( src.innerHTML && !jQuery.trim(dest.innerHTML) ) ) { + dest.innerHTML = src.innerHTML; + } + + } else if ( nodeName === "input" && manipulation_rcheckableType.test( src.type ) ) { + // IE6-8 fails to persist the checked state of a cloned checkbox + // or radio button. Worse, IE6-7 fail to give the cloned element + // a checked appearance if the defaultChecked value isn't also set + + dest.defaultChecked = dest.checked = src.checked; + + // IE6-7 get confused and end up setting the value of a cloned + // checkbox/radio button to an empty string instead of "on" + if ( dest.value !== src.value ) { + dest.value = src.value; + } + + // IE6-8 fails to return the selected option to the default selected + // state when cloning options + } else if ( nodeName === "option" ) { + dest.defaultSelected = dest.selected = src.defaultSelected; + + // IE6-8 fails to set the defaultValue to the correct value when + // cloning other types of input fields + } else if ( nodeName === "input" || nodeName === "textarea" ) { + dest.defaultValue = src.defaultValue; + } +} + +jQuery.each({ + appendTo: "append", + prependTo: "prepend", + insertBefore: "before", + insertAfter: "after", + replaceAll: "replaceWith" +}, function( name, original ) { + jQuery.fn[ name ] = function( selector ) { + var elems, + i = 0, + ret = [], + insert = jQuery( selector ), + last = insert.length - 1; + + for ( ; i <= last; i++ ) { + elems = i === last ? this : this.clone(true); + jQuery( insert[i] )[ original ]( elems ); + + // Modern browsers can apply jQuery collections as arrays, but oldIE needs a .get() + core_push.apply( ret, elems.get() ); + } + + return this.pushStack( ret ); + }; +}); + +function getAll( context, tag ) { + var elems, elem, + i = 0, + found = typeof context.getElementsByTagName !== core_strundefined ? context.getElementsByTagName( tag || "*" ) : + typeof context.querySelectorAll !== core_strundefined ? context.querySelectorAll( tag || "*" ) : + undefined; + + if ( !found ) { + for ( found = [], elems = context.childNodes || context; (elem = elems[i]) != null; i++ ) { + if ( !tag || jQuery.nodeName( elem, tag ) ) { + found.push( elem ); + } else { + jQuery.merge( found, getAll( elem, tag ) ); + } + } + } + + return tag === undefined || tag && jQuery.nodeName( context, tag ) ? + jQuery.merge( [ context ], found ) : + found; +} + +// Used in buildFragment, fixes the defaultChecked property +function fixDefaultChecked( elem ) { + if ( manipulation_rcheckableType.test( elem.type ) ) { + elem.defaultChecked = elem.checked; + } +} + +jQuery.extend({ + clone: function( elem, dataAndEvents, deepDataAndEvents ) { + var destElements, node, clone, i, srcElements, + inPage = jQuery.contains( elem.ownerDocument, elem ); + + if ( jQuery.support.html5Clone || jQuery.isXMLDoc(elem) || !rnoshimcache.test( "<" + elem.nodeName + ">" ) ) { + clone = elem.cloneNode( true ); + + // IE<=8 does not properly clone detached, unknown element nodes + } else { + fragmentDiv.innerHTML = elem.outerHTML; + fragmentDiv.removeChild( clone = fragmentDiv.firstChild ); + } + + if ( (!jQuery.support.noCloneEvent || !jQuery.support.noCloneChecked) && + (elem.nodeType === 1 || elem.nodeType === 11) && !jQuery.isXMLDoc(elem) ) { + + // We eschew Sizzle here for performance reasons: http://jsperf.com/getall-vs-sizzle/2 + destElements = getAll( clone ); + srcElements = getAll( elem ); + + // Fix all IE cloning issues + for ( i = 0; (node = srcElements[i]) != null; ++i ) { + // Ensure that the destination node is not null; Fixes #9587 + if ( destElements[i] ) { + fixCloneNodeIssues( node, destElements[i] ); + } + } + } + + // Copy the events from the original to the clone + if ( dataAndEvents ) { + if ( deepDataAndEvents ) { + srcElements = srcElements || getAll( elem ); + destElements = destElements || getAll( clone ); + + for ( i = 0; (node = srcElements[i]) != null; i++ ) { + cloneCopyEvent( node, destElements[i] ); + } + } else { + cloneCopyEvent( elem, clone ); + } + } + + // Preserve script evaluation history + destElements = getAll( clone, "script" ); + if ( destElements.length > 0 ) { + setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); + } + + destElements = srcElements = node = null; + + // Return the cloned set + return clone; + }, + + buildFragment: function( elems, context, scripts, selection ) { + var j, elem, contains, + tmp, tag, tbody, wrap, + l = elems.length, + + // Ensure a safe fragment + safe = createSafeFragment( context ), + + nodes = [], + i = 0; + + for ( ; i < l; i++ ) { + elem = elems[ i ]; + + if ( elem || elem === 0 ) { + + // Add nodes directly + if ( jQuery.type( elem ) === "object" ) { + jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); + + // Convert non-html into a text node + } else if ( !rhtml.test( elem ) ) { + nodes.push( context.createTextNode( elem ) ); + + // Convert html into DOM nodes + } else { + tmp = tmp || safe.appendChild( context.createElement("div") ); + + // Deserialize a standard representation + tag = ( rtagName.exec( elem ) || ["", ""] )[1].toLowerCase(); + wrap = wrapMap[ tag ] || wrapMap._default; + + tmp.innerHTML = wrap[1] + elem.replace( rxhtmlTag, "<$1>" ) + wrap[2]; + + // Descend through wrappers to the right content + j = wrap[0]; + while ( j-- ) { + tmp = tmp.lastChild; + } + + // Manually add leading whitespace removed by IE + if ( !jQuery.support.leadingWhitespace && rleadingWhitespace.test( elem ) ) { + nodes.push( context.createTextNode( rleadingWhitespace.exec( elem )[0] ) ); + } + + // Remove IE's autoinserted from table fragments + if ( !jQuery.support.tbody ) { + + // String was a , *may* have spurious + elem = tag === "table" && !rtbody.test( elem ) ? + tmp.firstChild : + + // String was a bare or + wrap[1] === "
" && !rtbody.test( elem ) ? + tmp : + 0; + + j = elem && elem.childNodes.length; + while ( j-- ) { + if ( jQuery.nodeName( (tbody = elem.childNodes[j]), "tbody" ) && !tbody.childNodes.length ) { + elem.removeChild( tbody ); + } + } + } + + jQuery.merge( nodes, tmp.childNodes ); + + // Fix #12392 for WebKit and IE > 9 + tmp.textContent = ""; + + // Fix #12392 for oldIE + while ( tmp.firstChild ) { + tmp.removeChild( tmp.firstChild ); + } + + // Remember the top-level container for proper cleanup + tmp = safe.lastChild; + } + } + } + + // Fix #11356: Clear elements from fragment + if ( tmp ) { + safe.removeChild( tmp ); + } + + // Reset defaultChecked for any radios and checkboxes + // about to be appended to the DOM in IE 6/7 (#8060) + if ( !jQuery.support.appendChecked ) { + jQuery.grep( getAll( nodes, "input" ), fixDefaultChecked ); + } + + i = 0; + while ( (elem = nodes[ i++ ]) ) { + + // #4087 - If origin and destination elements are the same, and this is + // that element, do not do anything + if ( selection && jQuery.inArray( elem, selection ) !== -1 ) { + continue; + } + + contains = jQuery.contains( elem.ownerDocument, elem ); + + // Append to fragment + tmp = getAll( safe.appendChild( elem ), "script" ); + + // Preserve script evaluation history + if ( contains ) { + setGlobalEval( tmp ); + } + + // Capture executables + if ( scripts ) { + j = 0; + while ( (elem = tmp[ j++ ]) ) { + if ( rscriptType.test( elem.type || "" ) ) { + scripts.push( elem ); + } + } + } + } + + tmp = null; + + return safe; + }, + + cleanData: function( elems, /* internal */ acceptData ) { + var elem, type, id, data, + i = 0, + internalKey = jQuery.expando, + cache = jQuery.cache, + deleteExpando = jQuery.support.deleteExpando, + special = jQuery.event.special; + + for ( ; (elem = elems[i]) != null; i++ ) { + + if ( acceptData || jQuery.acceptData( elem ) ) { + + id = elem[ internalKey ]; + data = id && cache[ id ]; + + if ( data ) { + if ( data.events ) { + for ( type in data.events ) { + if ( special[ type ] ) { + jQuery.event.remove( elem, type ); + + // This is a shortcut to avoid jQuery.event.remove's overhead + } else { + jQuery.removeEvent( elem, type, data.handle ); + } + } + } + + // Remove cache only if it was not already removed by jQuery.event.remove + if ( cache[ id ] ) { + + delete cache[ id ]; + + // IE does not allow us to delete expando properties from nodes, + // nor does it have a removeAttribute function on Document nodes; + // we must handle all of these cases + if ( deleteExpando ) { + delete elem[ internalKey ]; + + } else if ( typeof elem.removeAttribute !== core_strundefined ) { + elem.removeAttribute( internalKey ); + + } else { + elem[ internalKey ] = null; + } + + core_deletedIds.push( id ); + } + } + } + } + }, + + _evalUrl: function( url ) { + return jQuery.ajax({ + url: url, + type: "GET", + dataType: "script", + async: false, + global: false, + "throws": true + }); + } +}); +jQuery.fn.extend({ + wrapAll: function( html ) { + if ( jQuery.isFunction( html ) ) { + return this.each(function(i) { + jQuery(this).wrapAll( html.call(this, i) ); + }); + } + + if ( this[0] ) { + // The elements to wrap the target around + var wrap = jQuery( html, this[0].ownerDocument ).eq(0).clone(true); + + if ( this[0].parentNode ) { + wrap.insertBefore( this[0] ); + } + + wrap.map(function() { + var elem = this; + + while ( elem.firstChild && elem.firstChild.nodeType === 1 ) { + elem = elem.firstChild; + } + + return elem; + }).append( this ); + } + + return this; + }, + + wrapInner: function( html ) { + if ( jQuery.isFunction( html ) ) { + return this.each(function(i) { + jQuery(this).wrapInner( html.call(this, i) ); + }); + } + + return this.each(function() { + var self = jQuery( this ), + contents = self.contents(); + + if ( contents.length ) { + contents.wrapAll( html ); + + } else { + self.append( html ); + } + }); + }, + + wrap: function( html ) { + var isFunction = jQuery.isFunction( html ); + + return this.each(function(i) { + jQuery( this ).wrapAll( isFunction ? html.call(this, i) : html ); + }); + }, + + unwrap: function() { + return this.parent().each(function() { + if ( !jQuery.nodeName( this, "body" ) ) { + jQuery( this ).replaceWith( this.childNodes ); + } + }).end(); + } +}); +var iframe, getStyles, curCSS, + ralpha = /alpha\([^)]*\)/i, + ropacity = /opacity\s*=\s*([^)]*)/, + rposition = /^(top|right|bottom|left)$/, + // swappable if display is none or starts with table except "table", "table-cell", or "table-caption" + // see here for display values: https://developer.mozilla.org/en-US/docs/CSS/display + rdisplayswap = /^(none|table(?!-c[ea]).+)/, + rmargin = /^margin/, + rnumsplit = new RegExp( "^(" + core_pnum + ")(.*)$", "i" ), + rnumnonpx = new RegExp( "^(" + core_pnum + ")(?!px)[a-z%]+$", "i" ), + rrelNum = new RegExp( "^([+-])=(" + core_pnum + ")", "i" ), + elemdisplay = { BODY: "block" }, + + cssShow = { position: "absolute", visibility: "hidden", display: "block" }, + cssNormalTransform = { + letterSpacing: 0, + fontWeight: 400 + }, + + cssExpand = [ "Top", "Right", "Bottom", "Left" ], + cssPrefixes = [ "Webkit", "O", "Moz", "ms" ]; + +// return a css property mapped to a potentially vendor prefixed property +function vendorPropName( style, name ) { + + // shortcut for names that are not vendor prefixed + if ( name in style ) { + return name; + } + + // check for vendor prefixed names + var capName = name.charAt(0).toUpperCase() + name.slice(1), + origName = name, + i = cssPrefixes.length; + + while ( i-- ) { + name = cssPrefixes[ i ] + capName; + if ( name in style ) { + return name; + } + } + + return origName; +} + +function isHidden( elem, el ) { + // isHidden might be called from jQuery#filter function; + // in that case, element will be second argument + elem = el || elem; + return jQuery.css( elem, "display" ) === "none" || !jQuery.contains( elem.ownerDocument, elem ); +} + +function showHide( elements, show ) { + var display, elem, hidden, + values = [], + index = 0, + length = elements.length; + + for ( ; index < length; index++ ) { + elem = elements[ index ]; + if ( !elem.style ) { + continue; + } + + values[ index ] = jQuery._data( elem, "olddisplay" ); + display = elem.style.display; + if ( show ) { + // Reset the inline display of this element to learn if it is + // being hidden by cascaded rules or not + if ( !values[ index ] && display === "none" ) { + elem.style.display = ""; + } + + // Set elements which have been overridden with display: none + // in a stylesheet to whatever the default browser style is + // for such an element + if ( elem.style.display === "" && isHidden( elem ) ) { + values[ index ] = jQuery._data( elem, "olddisplay", css_defaultDisplay(elem.nodeName) ); + } + } else { + + if ( !values[ index ] ) { + hidden = isHidden( elem ); + + if ( display && display !== "none" || !hidden ) { + jQuery._data( elem, "olddisplay", hidden ? display : jQuery.css( elem, "display" ) ); + } + } + } + } + + // Set the display of most of the elements in a second loop + // to avoid the constant reflow + for ( index = 0; index < length; index++ ) { + elem = elements[ index ]; + if ( !elem.style ) { + continue; + } + if ( !show || elem.style.display === "none" || elem.style.display === "" ) { + elem.style.display = show ? values[ index ] || "" : "none"; + } + } + + return elements; +} + +jQuery.fn.extend({ + css: function( name, value ) { + return jQuery.access( this, function( elem, name, value ) { + var len, styles, + map = {}, + i = 0; + + if ( jQuery.isArray( name ) ) { + styles = getStyles( elem ); + len = name.length; + + for ( ; i < len; i++ ) { + map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); + } + + return map; + } + + return value !== undefined ? + jQuery.style( elem, name, value ) : + jQuery.css( elem, name ); + }, name, value, arguments.length > 1 ); + }, + show: function() { + return showHide( this, true ); + }, + hide: function() { + return showHide( this ); + }, + toggle: function( state ) { + if ( typeof state === "boolean" ) { + return state ? this.show() : this.hide(); + } + + return this.each(function() { + if ( isHidden( this ) ) { + jQuery( this ).show(); + } else { + jQuery( this ).hide(); + } + }); + } +}); + +jQuery.extend({ + // Add in style property hooks for overriding the default + // behavior of getting and setting a style property + cssHooks: { + opacity: { + get: function( elem, computed ) { + if ( computed ) { + // We should always get a number back from opacity + var ret = curCSS( elem, "opacity" ); + return ret === "" ? "1" : ret; + } + } + } + }, + + // Don't automatically add "px" to these possibly-unitless properties + cssNumber: { + "columnCount": true, + "fillOpacity": true, + "fontWeight": true, + "lineHeight": true, + "opacity": true, + "order": true, + "orphans": true, + "widows": true, + "zIndex": true, + "zoom": true + }, + + // Add in properties whose names you wish to fix before + // setting or getting the value + cssProps: { + // normalize float css property + "float": jQuery.support.cssFloat ? "cssFloat" : "styleFloat" + }, + + // Get and set the style property on a DOM Node + style: function( elem, name, value, extra ) { + // Don't set styles on text and comment nodes + if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { + return; + } + + // Make sure that we're working with the right name + var ret, type, hooks, + origName = jQuery.camelCase( name ), + style = elem.style; + + name = jQuery.cssProps[ origName ] || ( jQuery.cssProps[ origName ] = vendorPropName( style, origName ) ); + + // gets hook for the prefixed version + // followed by the unprefixed version + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // Check if we're setting a value + if ( value !== undefined ) { + type = typeof value; + + // convert relative number strings (+= or -=) to relative numbers. #7345 + if ( type === "string" && (ret = rrelNum.exec( value )) ) { + value = ( ret[1] + 1 ) * ret[2] + parseFloat( jQuery.css( elem, name ) ); + // Fixes bug #9237 + type = "number"; + } + + // Make sure that NaN and null values aren't set. See: #7116 + if ( value == null || type === "number" && isNaN( value ) ) { + return; + } + + // If a number was passed in, add 'px' to the (except for certain CSS properties) + if ( type === "number" && !jQuery.cssNumber[ origName ] ) { + value += "px"; + } + + // Fixes #8908, it can be done more correctly by specifing setters in cssHooks, + // but it would mean to define eight (for every problematic property) identical functions + if ( !jQuery.support.clearCloneStyle && value === "" && name.indexOf("background") === 0 ) { + style[ name ] = "inherit"; + } + + // If a hook was provided, use that value, otherwise just set the specified value + if ( !hooks || !("set" in hooks) || (value = hooks.set( elem, value, extra )) !== undefined ) { + + // Wrapped to prevent IE from throwing errors when 'invalid' values are provided + // Fixes bug #5509 + try { + style[ name ] = value; + } catch(e) {} + } + + } else { + // If a hook was provided get the non-computed value from there + if ( hooks && "get" in hooks && (ret = hooks.get( elem, false, extra )) !== undefined ) { + return ret; + } + + // Otherwise just get the value from the style object + return style[ name ]; + } + }, + + css: function( elem, name, extra, styles ) { + var num, val, hooks, + origName = jQuery.camelCase( name ); + + // Make sure that we're working with the right name + name = jQuery.cssProps[ origName ] || ( jQuery.cssProps[ origName ] = vendorPropName( elem.style, origName ) ); + + // gets hook for the prefixed version + // followed by the unprefixed version + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // If a hook was provided get the computed value from there + if ( hooks && "get" in hooks ) { + val = hooks.get( elem, true, extra ); + } + + // Otherwise, if a way to get the computed value exists, use that + if ( val === undefined ) { + val = curCSS( elem, name, styles ); + } + + //convert "normal" to computed value + if ( val === "normal" && name in cssNormalTransform ) { + val = cssNormalTransform[ name ]; + } + + // Return, converting to number if forced or a qualifier was provided and val looks numeric + if ( extra === "" || extra ) { + num = parseFloat( val ); + return extra === true || jQuery.isNumeric( num ) ? num || 0 : val; + } + return val; + } +}); + +// NOTE: we've included the "window" in window.getComputedStyle +// because jsdom on node.js will break without it. +if ( window.getComputedStyle ) { + getStyles = function( elem ) { + return window.getComputedStyle( elem, null ); + }; + + curCSS = function( elem, name, _computed ) { + var width, minWidth, maxWidth, + computed = _computed || getStyles( elem ), + + // getPropertyValue is only needed for .css('filter') in IE9, see #12537 + ret = computed ? computed.getPropertyValue( name ) || computed[ name ] : undefined, + style = elem.style; + + if ( computed ) { + + if ( ret === "" && !jQuery.contains( elem.ownerDocument, elem ) ) { + ret = jQuery.style( elem, name ); + } + + // A tribute to the "awesome hack by Dean Edwards" + // Chrome < 17 and Safari 5.0 uses "computed value" instead of "used value" for margin-right + // Safari 5.1.7 (at least) returns percentage for a larger set of values, but width seems to be reliably pixels + // this is against the CSSOM draft spec: http://dev.w3.org/csswg/cssom/#resolved-values + if ( rnumnonpx.test( ret ) && rmargin.test( name ) ) { + + // Remember the original values + width = style.width; + minWidth = style.minWidth; + maxWidth = style.maxWidth; + + // Put in the new values to get a computed value out + style.minWidth = style.maxWidth = style.width = ret; + ret = computed.width; + + // Revert the changed values + style.width = width; + style.minWidth = minWidth; + style.maxWidth = maxWidth; + } + } + + return ret; + }; +} else if ( document.documentElement.currentStyle ) { + getStyles = function( elem ) { + return elem.currentStyle; + }; + + curCSS = function( elem, name, _computed ) { + var left, rs, rsLeft, + computed = _computed || getStyles( elem ), + ret = computed ? computed[ name ] : undefined, + style = elem.style; + + // Avoid setting ret to empty string here + // so we don't default to auto + if ( ret == null && style && style[ name ] ) { + ret = style[ name ]; + } + + // From the awesome hack by Dean Edwards + // http://erik.eae.net/archives/2007/07/27/18.54.15/#comment-102291 + + // If we're not dealing with a regular pixel number + // but a number that has a weird ending, we need to convert it to pixels + // but not position css attributes, as those are proportional to the parent element instead + // and we can't measure the parent instead because it might trigger a "stacking dolls" problem + if ( rnumnonpx.test( ret ) && !rposition.test( name ) ) { + + // Remember the original values + left = style.left; + rs = elem.runtimeStyle; + rsLeft = rs && rs.left; + + // Put in the new values to get a computed value out + if ( rsLeft ) { + rs.left = elem.currentStyle.left; + } + style.left = name === "fontSize" ? "1em" : ret; + ret = style.pixelLeft + "px"; + + // Revert the changed values + style.left = left; + if ( rsLeft ) { + rs.left = rsLeft; + } + } + + return ret === "" ? "auto" : ret; + }; +} + +function setPositiveNumber( elem, value, subtract ) { + var matches = rnumsplit.exec( value ); + return matches ? + // Guard against undefined "subtract", e.g., when used as in cssHooks + Math.max( 0, matches[ 1 ] - ( subtract || 0 ) ) + ( matches[ 2 ] || "px" ) : + value; +} + +function augmentWidthOrHeight( elem, name, extra, isBorderBox, styles ) { + var i = extra === ( isBorderBox ? "border" : "content" ) ? + // If we already have the right measurement, avoid augmentation + 4 : + // Otherwise initialize for horizontal or vertical properties + name === "width" ? 1 : 0, + + val = 0; + + for ( ; i < 4; i += 2 ) { + // both box models exclude margin, so add it if we want it + if ( extra === "margin" ) { + val += jQuery.css( elem, extra + cssExpand[ i ], true, styles ); + } + + if ( isBorderBox ) { + // border-box includes padding, so remove it if we want content + if ( extra === "content" ) { + val -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + } + + // at this point, extra isn't border nor margin, so remove border + if ( extra !== "margin" ) { + val -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + } else { + // at this point, extra isn't content, so add padding + val += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + + // at this point, extra isn't content nor padding, so add border + if ( extra !== "padding" ) { + val += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + } + } + + return val; +} + +function getWidthOrHeight( elem, name, extra ) { + + // Start with offset property, which is equivalent to the border-box value + var valueIsBorderBox = true, + val = name === "width" ? elem.offsetWidth : elem.offsetHeight, + styles = getStyles( elem ), + isBorderBox = jQuery.support.boxSizing && jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; + + // some non-html elements return undefined for offsetWidth, so check for null/undefined + // svg - https://bugzilla.mozilla.org/show_bug.cgi?id=649285 + // MathML - https://bugzilla.mozilla.org/show_bug.cgi?id=491668 + if ( val <= 0 || val == null ) { + // Fall back to computed then uncomputed css if necessary + val = curCSS( elem, name, styles ); + if ( val < 0 || val == null ) { + val = elem.style[ name ]; + } + + // Computed unit is not pixels. Stop here and return. + if ( rnumnonpx.test(val) ) { + return val; + } + + // we need the check for style in case a browser which returns unreliable values + // for getComputedStyle silently falls back to the reliable elem.style + valueIsBorderBox = isBorderBox && ( jQuery.support.boxSizingReliable || val === elem.style[ name ] ); + + // Normalize "", auto, and prepare for extra + val = parseFloat( val ) || 0; + } + + // use the active box-sizing model to add/subtract irrelevant styles + return ( val + + augmentWidthOrHeight( + elem, + name, + extra || ( isBorderBox ? "border" : "content" ), + valueIsBorderBox, + styles + ) + ) + "px"; +} + +// Try to determine the default display value of an element +function css_defaultDisplay( nodeName ) { + var doc = document, + display = elemdisplay[ nodeName ]; + + if ( !display ) { + display = actualDisplay( nodeName, doc ); + + // If the simple way fails, read from inside an iframe + if ( display === "none" || !display ) { + // Use the already-created iframe if possible + iframe = ( iframe || + jQuery("