JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
vanilla ckeditor-3.6.1
[ckeditor.git] / _source / core / dom / element.js
index 48b0d26..5df3d19 100644 (file)
@@ -1,5 +1,5 @@
 /*\r
-Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved.\r
+Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.\r
 For licensing, see LICENSE.html or http://ckeditor.com/license\r
 */\r
 \r
@@ -307,12 +307,17 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
 \r
                /**\r
                 * Moves the selection focus to this element.\r
+                * @function\r
+                * @param  {Boolean} defer Whether to asynchronously defer the\r
+                *              execution by 100 ms.\r
                 * @example\r
                 * var element = CKEDITOR.document.getById( 'myTextarea' );\r
                 * <b>element.focus()</b>;\r
                 */\r
-               focus : function()\r
+               focus : ( function()\r
                {\r
+                       function exec()\r
+                       {\r
                        // IE throws error if the element is not visible.\r
                        try\r
                        {\r
@@ -320,7 +325,16 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                        }\r
                        catch (e)\r
                        {}\r
-               },\r
+                       }\r
+\r
+                       return function( defer )\r
+                       {\r
+                               if ( defer )\r
+                                       CKEDITOR.tools.setTimeout( exec, 100, this );\r
+                               else\r
+                                       exec.call( this );\r
+                       };\r
+               })(),\r
 \r
                /**\r
                 * Gets the inner HTML of this element.\r
@@ -415,6 +429,13 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                                                        name = 'className';\r
                                                        break;\r
 \r
+                                               case 'http-equiv':\r
+                                                       name = 'httpEquiv';\r
+                                                       break;\r
+\r
+                                               case 'name':\r
+                                                       return this.$.name;\r
+\r
                                                case 'tabindex':\r
                                                        var tabIndex = standard.call( this, name );\r
 \r
@@ -439,7 +460,8 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                                                }\r
 \r
                                                case 'hspace':\r
-                                                       return this.$.hspace;\r
+                                               case 'value':\r
+                                                       return this.$[ name ];\r
 \r
                                                case 'style':\r
                                                        // IE does not return inline styles via getAttribute(). See #2947.\r
@@ -699,6 +721,9 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
 \r
                isEditable : function()\r
                {\r
+                       if ( this.isReadOnly() )\r
+                               return false;\r
+\r
                        // Get the element name.\r
                        var name = this.getName();\r
 \r
@@ -725,7 +750,10 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                        {\r
                                var attribute = thisAttribs[ i ];\r
 \r
-                               if ( ( !CKEDITOR.env.ie || ( attribute.specified && attribute.nodeName != '_cke_expando' ) ) && attribute.nodeValue != otherElement.getAttribute( attribute.nodeName ) )\r
+                               if ( attribute.nodeName == '_moz_dirty' )\r
+                                       continue;\r
+\r
+                               if ( ( !CKEDITOR.env.ie || ( attribute.specified && attribute.nodeName != 'data-cke-expando' ) ) && attribute.nodeValue != otherElement.getAttribute( attribute.nodeName ) )\r
                                        return false;\r
                        }\r
 \r
@@ -736,7 +764,7 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                                for ( i = 0 ; i < otherLength ; i++ )\r
                                {\r
                                        attribute = otherAttribs[ i ];\r
-                                       if ( attribute.specified && attribute.nodeName != '_cke_expando'\r
+                                       if ( attribute.specified && attribute.nodeName != 'data-cke-expando'\r
                                                        && attribute.nodeValue != this.getAttribute( attribute.nodeName ) )\r
                                                return false;\r
                                }\r
@@ -786,7 +814,7 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                        {\r
                                var child = children.getItem( i );\r
 \r
-                               if ( child.type == CKEDITOR.NODE_ELEMENT && child.getAttribute( '_cke_bookmark' ) )\r
+                               if ( child.type == CKEDITOR.NODE_ELEMENT && child.data( 'cke-bookmark' ) )\r
                                        continue;\r
 \r
                                if ( child.type == CKEDITOR.NODE_ELEMENT && !child.isEmptyInlineRemoveable()\r
@@ -799,14 +827,15 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                },\r
 \r
                /**\r
-                * Indicates that the element has defined attributes.\r
+                * Checks if the element has any defined attributes.\r
+                * @function\r
                 * @returns {Boolean} True if the element has attributes.\r
                 * @example\r
-                * var element = CKEDITOR.dom.element.createFromHtml( '<div title="Test">Example</div>' );\r
-                * alert( <b>element.hasAttributes()</b> );  "true"\r
+                * var element = CKEDITOR.dom.element.createFromHtml( '&lt;div title="Test"&gt;Example&lt;/div&gt;' );\r
+                * alert( <b>element.hasAttributes()</b> );  // "true"\r
                 * @example\r
-                * var element = CKEDITOR.dom.element.createFromHtml( '<div>Example</div>' );\r
-                * alert( <b>element.hasAttributes()</b> );  "false"\r
+                * var element = CKEDITOR.dom.element.createFromHtml( '&lt;div&gt;Example&lt;/div&gt;' );\r
+                * alert( <b>element.hasAttributes()</b> );  // "false"\r
                 */\r
                hasAttributes :\r
                        CKEDITOR.env.ie && ( CKEDITOR.env.ie7Compat || CKEDITOR.env.ie6Compat ) ?\r
@@ -831,7 +860,7 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                                                                        return true;\r
 \r
                                                        // Attributes to be ignored.\r
-                                                       case '_cke_expando' :\r
+                                                       case 'data-cke-expando' :\r
                                                                continue;\r
 \r
                                                        /*jsl:fallthru*/\r
@@ -851,7 +880,7 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                                                attrsNum = attrs.length;\r
 \r
                                        // The _moz_dirty attribute might get into the element after pasting (#5455)\r
-                                       var execludeAttrs = { _cke_expando : 1, _moz_dirty : 1 };\r
+                                       var execludeAttrs = { 'data-cke-expando' : 1, _moz_dirty : 1 };\r
 \r
                                        return attrsNum > 0 &&\r
                                                ( attrsNum > 2 ||\r
@@ -860,16 +889,33 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                                },\r
 \r
                /**\r
-                * Indicates whether a specified attribute is defined for this element.\r
+                * Checks if the specified attribute is defined for this element.\r
                 * @returns {Boolean} True if the specified attribute is defined.\r
-                * @param (String) name The attribute name.\r
+                * @param {String} name The attribute name.\r
                 * @example\r
                 */\r
-               hasAttribute : function( name )\r
+               hasAttribute : (function()\r
                {\r
-                       var $attr = this.$.attributes.getNamedItem( name );\r
-                       return !!( $attr && $attr.specified );\r
-               },\r
+                       function standard( name )\r
+                       {\r
+                               var $attr = this.$.attributes.getNamedItem( name );\r
+                               return !!( $attr && $attr.specified );\r
+                       }\r
+\r
+                       return ( CKEDITOR.env.ie && CKEDITOR.env.version < 8 ) ?\r
+                                       function( name )\r
+                                       {\r
+                                               // On IE < 8 the name attribute cannot be retrieved\r
+                                               // right after the element creation and setting the\r
+                                               // name with setAttribute.\r
+                                               if ( name == 'name' )\r
+                                                       return !!this.$.name;\r
+\r
+                                               return standard.call( this, name );\r
+                                       }\r
+                               :\r
+                                       standard;\r
+               })(),\r
 \r
                /**\r
                 * Hides this element (display:none).\r
@@ -904,6 +950,14 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                        }\r
                },\r
 \r
+               /**\r
+                * Merges sibling elements that are identical to this one.<br>\r
+                * <br>\r
+                * Identical child elements are also merged. For example:<br>\r
+                * &lt;b&gt;&lt;i&gt;&lt;/i&gt;&lt;/b&gt;&lt;b&gt;&lt;i&gt;&lt;/i&gt;&lt;/b&gt; =&gt; &lt;b&gt;&lt;i&gt;&lt;/i&gt;&lt;/b&gt;\r
+                * @function\r
+                * @param {Boolean} [inlineOnly] Allow only inline elements to be merged. Defaults to "true".\r
+                */\r
                mergeSiblings : ( function()\r
                {\r
                        function mergeElements( element, sibling, isNext )\r
@@ -914,7 +968,7 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                                        // queuing them to be moved later. (#5567)\r
                                        var pendingNodes = [];\r
 \r
-                                       while ( sibling.getAttribute( '_cke_bookmark' )\r
+                                       while ( sibling.data( 'cke-bookmark' )\r
                                                || sibling.isEmptyInlineRemoveable() )\r
                                        {\r
                                                pendingNodes.push( sibling );\r
@@ -943,11 +997,14 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                                }\r
                        }\r
 \r
-                       return function()\r
+                       return function( inlineOnly )\r
                                {\r
-                                       // Merge empty links and anchors also. (#5567)\r
-                                       if ( !( CKEDITOR.dtd.$removeEmpty[ this.getName() ] || this.is( 'a' ) ) )\r
+                                       if ( ! ( inlineOnly === false\r
+                                                       || CKEDITOR.dtd.$removeEmpty[ this.getName() ]\r
+                                                       || this.is( 'a' ) ) )   // Merge empty links and anchors also. (#5567)\r
+                                       {\r
                                                return;\r
+                                       }\r
 \r
                                        mergeElements( this, this.getNext(), true );\r
                                        mergeElements( this, this.getPrevious() );\r
@@ -1005,6 +1062,18 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                                        return this;\r
                                };\r
                        }\r
+                       else if ( CKEDITOR.env.ie8Compat && CKEDITOR.env.secure )\r
+                       {\r
+                               return function( name, value )\r
+                               {\r
+                                       // IE8 throws error when setting src attribute to non-ssl value. (#7847)\r
+                                       if ( name == 'src' && value.match( /^http:\/\// ) )\r
+                                               try { standard.apply( this, arguments ); } catch( e ){}\r
+                                       else\r
+                                               standard.apply( this, arguments );\r
+                                       return this;\r
+                               };\r
+                       }\r
                        else\r
                                return standard;\r
                })(),\r
@@ -1480,7 +1549,7 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
 \r
                        // Replace the node.\r
                        this.getParent() && this.$.parentNode.replaceChild( newNode.$, this.$ );\r
-                       newNode.$._cke_expando = this.$._cke_expando;\r
+                       newNode.$[ 'data-cke-expando' ] = this.$[ 'data-cke-expando' ];\r
                        this.$ = newNode.$;\r
                },\r
 \r
@@ -1522,40 +1591,91 @@ CKEDITOR.tools.extend( CKEDITOR.dom.element.prototype,
                },\r
 \r
                /**\r
-                *  Update the element's size with box model awareness.\r
-                * @name CKEDITOR.dom.element.setSize\r
-                * @param {String} type [width|height]\r
-                * @param {Number} size The length unit in px.\r
-                * @param isBorderBox Apply the {@param width} and {@param height} based on border box model.\r
+                * Gets element's direction. Supports both CSS 'direction' prop and 'dir' attr.\r
                 */\r
-               setSize : ( function()\r
+               getDirection : function( useComputed )\r
                {\r
-                       var sides = {\r
-                               width : [ "border-left-width", "border-right-width","padding-left", "padding-right" ],\r
-                               height : [ "border-top-width", "border-bottom-width", "padding-top",  "padding-bottom" ]\r
-                       };\r
-\r
-                       return function( type, size, isBorderBox )\r
-                               {\r
-                                       if ( typeof size == 'number' )\r
-                                       {\r
-                                               if ( isBorderBox && !( CKEDITOR.env.ie && CKEDITOR.env.quirks ) )\r
-                                               {\r
-                                                       var     adjustment = 0;\r
-                                                       for ( var i = 0, len = sides[ type ].length; i < len; i++ )\r
-                                                               adjustment += parseInt( this.getComputedStyle( sides [ type ][ i ] ) || 0, 10 ) || 0;\r
-                                                       size -= adjustment;\r
-                                               }\r
-                                               this.setStyle( type, size + 'px' );\r
-                                       }\r
-                               };\r
-               })(),\r
+                       return useComputed ?\r
+                               this.getComputedStyle( 'direction' )\r
+                                       // Webkit: offline element returns empty direction (#8053).\r
+                                       || this.getDirection()\r
+                                       || this.getDocument().$.dir\r
+                                       || this.getDocument().getBody().getDirection( 1 )\r
+                               : this.getStyle( 'direction' ) || this.getAttribute( 'dir' );\r
+               },\r
 \r
                /**\r
-                * Gets element's direction. Supports both CSS 'direction' prop and 'dir' attr.\r
+                * Gets, sets and removes custom data to be stored as HTML5 data-* attributes.\r
+                * @param {String} name The name of the attribute, excluding the 'data-' part.\r
+                * @param {String} [value] The value to set. If set to false, the attribute will be removed.\r
+                * @example\r
+                * element.data( 'extra-info', 'test' );   // appended the attribute data-extra-info="test" to the element\r
+                * alert( element.data( 'extra-info' ) );  // "test"\r
+                * element.data( 'extra-info', false );    // remove the data-extra-info attribute from the element\r
                 */\r
-               getDirection : function( useComputed )\r
+               data : function ( name, value )\r
                {\r
-                       return useComputed ? this.getComputedStyle( 'direction' ) : this.getStyle( 'direction' ) || this.getAttribute( 'dir' );\r
+                       name = 'data-' + name;\r
+                       if ( value === undefined )\r
+                               return this.getAttribute( name );\r
+                       else if ( value === false )\r
+                               this.removeAttribute( name );\r
+                       else\r
+                               this.setAttribute( name, value );\r
+\r
+                       return null;\r
                }\r
        });\r
+\r
+( function()\r
+{\r
+       var sides = {\r
+               width : [ "border-left-width", "border-right-width","padding-left", "padding-right" ],\r
+               height : [ "border-top-width", "border-bottom-width", "padding-top",  "padding-bottom" ]\r
+       };\r
+\r
+       function marginAndPaddingSize( type )\r
+       {\r
+               var adjustment = 0;\r
+               for ( var i = 0, len = sides[ type ].length; i < len; i++ )\r
+                       adjustment += parseInt( this.getComputedStyle( sides [ type ][ i ] ) || 0, 10 ) || 0;\r
+               return adjustment;\r
+       }\r
+\r
+       /**\r
+        * Sets the element size considering the box model.\r
+        * @name CKEDITOR.dom.element.prototype.setSize\r
+        * @function\r
+        * @param {String} type The dimension to set. It accepts "width" and "height".\r
+        * @param {Number} size The length unit in px.\r
+        * @param {Boolean} isBorderBox Apply the size based on the border box model.\r
+        */\r
+       CKEDITOR.dom.element.prototype.setSize = function( type, size, isBorderBox )\r
+               {\r
+                       if ( typeof size == 'number' )\r
+                       {\r
+                               if ( isBorderBox && !( CKEDITOR.env.ie && CKEDITOR.env.quirks ) )\r
+                                       size -= marginAndPaddingSize.call( this, type );\r
+\r
+                               this.setStyle( type, size + 'px' );\r
+                       }\r
+               };\r
+\r
+       /**\r
+        * Gets the element size, possibly considering the box model.\r
+        * @name CKEDITOR.dom.element.prototype.getSize\r
+        * @function\r
+        * @param {String} type The dimension to get. It accepts "width" and "height".\r
+        * @param {Boolean} isBorderBox Get the size based on the border box model.\r
+        */\r
+       CKEDITOR.dom.element.prototype.getSize = function( type, isBorderBox )\r
+               {\r
+                       var size = Math.max( this.$[ 'offset' + CKEDITOR.tools.capitalize( type )  ],\r
+                               this.$[ 'client' + CKEDITOR.tools.capitalize( type )  ] ) || 0;\r
+\r
+                       if ( isBorderBox )\r
+                               size -= marginAndPaddingSize.call( this, type );\r
+\r
+                       return size;\r
+               };\r
+})();\r