JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
vanilla ckeditor-3.6.3
[ckeditor.git] / _source / core / dom / elementpath.js
1 /*\r
2 Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.\r
3 For licensing, see LICENSE.html or http://ckeditor.com/license\r
4 */\r
5 \r
6 (function()\r
7 {\r
8         // Elements that may be considered the "Block boundary" in an element path.\r
9         var pathBlockElements = { address:1,blockquote:1,dl:1,h1:1,h2:1,h3:1,h4:1,h5:1,h6:1,p:1,pre:1,li:1,dt:1,dd:1, legend:1,caption:1 };\r
10 \r
11         // Elements that may be considered the "Block limit" in an element path.\r
12         var pathBlockLimitElements = { body:1,div:1,table:1,tbody:1,tr:1,td:1,th:1,form:1,fieldset:1 };\r
13 \r
14         // Check if an element contains any block element.\r
15         var checkHasBlock = function( element )\r
16         {\r
17                 var childNodes = element.getChildren();\r
18 \r
19                 for ( var i = 0, count = childNodes.count() ; i < count ; i++ )\r
20                 {\r
21                         var child = childNodes.getItem( i );\r
22 \r
23                         if ( child.type == CKEDITOR.NODE_ELEMENT && CKEDITOR.dtd.$block[ child.getName() ] )\r
24                                 return true;\r
25                 }\r
26 \r
27                 return false;\r
28         };\r
29 \r
30         /**\r
31          * @class\r
32          */\r
33         CKEDITOR.dom.elementPath = function( lastNode )\r
34         {\r
35                 var block = null;\r
36                 var blockLimit = null;\r
37                 var elements = [];\r
38 \r
39                 var e = lastNode;\r
40 \r
41                 while ( e )\r
42                 {\r
43                         if ( e.type == CKEDITOR.NODE_ELEMENT )\r
44                         {\r
45                                 if ( !this.lastElement )\r
46                                         this.lastElement = e;\r
47 \r
48                                 var elementName = e.getName();\r
49 \r
50                                 if ( !blockLimit )\r
51                                 {\r
52                                         if ( !block && pathBlockElements[ elementName ] )\r
53                                                 block = e;\r
54 \r
55                                         if ( pathBlockLimitElements[ elementName ] )\r
56                                         {\r
57                                                 // DIV is considered the Block, if no block is available (#525)\r
58                                                 // and if it doesn't contain other blocks.\r
59                                                 if ( !block && elementName == 'div' && !checkHasBlock( e ) )\r
60                                                         block = e;\r
61                                                 else\r
62                                                         blockLimit = e;\r
63                                         }\r
64                                 }\r
65 \r
66                                 elements.push( e );\r
67 \r
68                                 if ( elementName == 'body' )\r
69                                         break;\r
70                         }\r
71                         e = e.getParent();\r
72                 }\r
73 \r
74                 this.block = block;\r
75                 this.blockLimit = blockLimit;\r
76                 this.elements = elements;\r
77         };\r
78 })();\r
79 \r
80 CKEDITOR.dom.elementPath.prototype =\r
81 {\r
82         /**\r
83          * Compares this element path with another one.\r
84          * @param {CKEDITOR.dom.elementPath} otherPath The elementPath object to be\r
85          * compared with this one.\r
86          * @returns {Boolean} "true" if the paths are equal, containing the same\r
87          * number of elements and the same elements in the same order.\r
88          */\r
89         compare : function( otherPath )\r
90         {\r
91                 var thisElements = this.elements;\r
92                 var otherElements = otherPath && otherPath.elements;\r
93 \r
94                 if ( !otherElements || thisElements.length != otherElements.length )\r
95                         return false;\r
96 \r
97                 for ( var i = 0 ; i < thisElements.length ; i++ )\r
98                 {\r
99                         if ( !thisElements[ i ].equals( otherElements[ i ] ) )\r
100                                 return false;\r
101                 }\r
102 \r
103                 return true;\r
104         },\r
105 \r
106         contains : function( tagNames )\r
107         {\r
108                 var elements = this.elements;\r
109                 for ( var i = 0 ; i < elements.length ; i++ )\r
110                 {\r
111                         if ( elements[ i ].getName() in tagNames )\r
112                                 return elements[ i ];\r
113                 }\r
114 \r
115                 return null;\r
116         }\r
117 };\r