1 | /* |
---|
2 | * FCKeditor - The text editor for Internet - http://www.fckeditor.net |
---|
3 | * Copyright (C) 2003-2009 Frederico Caldeira Knabben |
---|
4 | * |
---|
5 | * == BEGIN LICENSE == |
---|
6 | * |
---|
7 | * Licensed under the terms of any of the following licenses at your |
---|
8 | * choice: |
---|
9 | * |
---|
10 | * - GNU General Public License Version 2 or later (the "GPL") |
---|
11 | * http://www.gnu.org/licenses/gpl.html |
---|
12 | * |
---|
13 | * - GNU Lesser General Public License Version 2.1 or later (the "LGPL") |
---|
14 | * http://www.gnu.org/licenses/lgpl.html |
---|
15 | * |
---|
16 | * - Mozilla Public License Version 1.1 or later (the "MPL") |
---|
17 | * http://www.mozilla.org/MPL/MPL-1.1.html |
---|
18 | * |
---|
19 | * == END LICENSE == |
---|
20 | * |
---|
21 | * This class can be used to interate through nodes inside a range. |
---|
22 | * |
---|
23 | * During interation, the provided range can become invalid, due to document |
---|
24 | * mutations, so CreateBookmark() used to restore it after processing, if |
---|
25 | * needed. |
---|
26 | */ |
---|
27 | |
---|
28 | var FCKDomRangeIterator = function( range ) |
---|
29 | { |
---|
30 | /** |
---|
31 | * The FCKDomRange object that marks the interation boundaries. |
---|
32 | */ |
---|
33 | this.Range = range ; |
---|
34 | |
---|
35 | /** |
---|
36 | * Indicates that <br> elements must be used as paragraph boundaries. |
---|
37 | */ |
---|
38 | this.ForceBrBreak = false ; |
---|
39 | |
---|
40 | /** |
---|
41 | * Guarantees that the iterator will always return "real" block elements. |
---|
42 | * If "false", elements like <li>, <th> and <td> are returned. If "true", a |
---|
43 | * dedicated block element block element will be created inside those |
---|
44 | * elements to hold the selected content. |
---|
45 | */ |
---|
46 | this.EnforceRealBlocks = false ; |
---|
47 | } |
---|
48 | |
---|
49 | FCKDomRangeIterator.CreateFromSelection = function( targetWindow ) |
---|
50 | { |
---|
51 | var range = new FCKDomRange( targetWindow ) ; |
---|
52 | range.MoveToSelection() ; |
---|
53 | return new FCKDomRangeIterator( range ) ; |
---|
54 | } |
---|
55 | |
---|
56 | FCKDomRangeIterator.prototype = |
---|
57 | { |
---|
58 | /** |
---|
59 | * Get the next paragraph element. It automatically breaks the document |
---|
60 | * when necessary to generate block elements for the paragraphs. |
---|
61 | */ |
---|
62 | GetNextParagraph : function() |
---|
63 | { |
---|
64 | // The block element to be returned. |
---|
65 | var block ; |
---|
66 | |
---|
67 | // The range object used to identify the paragraph contents. |
---|
68 | var range ; |
---|
69 | |
---|
70 | // Indicated that the current element in the loop is the last one. |
---|
71 | var isLast ; |
---|
72 | |
---|
73 | // Instructs to cleanup remaining BRs. |
---|
74 | var removePreviousBr ; |
---|
75 | var removeLastBr ; |
---|
76 | |
---|
77 | var boundarySet = this.ForceBrBreak ? FCKListsLib.ListBoundaries : FCKListsLib.BlockBoundaries ; |
---|
78 | |
---|
79 | // This is the first iteration. Let's initialize it. |
---|
80 | if ( !this._LastNode ) |
---|
81 | { |
---|
82 | var range = this.Range.Clone() ; |
---|
83 | range.Expand( this.ForceBrBreak ? 'list_contents' : 'block_contents' ) ; |
---|
84 | |
---|
85 | this._NextNode = range.GetTouchedStartNode() ; |
---|
86 | this._LastNode = range.GetTouchedEndNode() ; |
---|
87 | |
---|
88 | // Let's reuse this variable. |
---|
89 | range = null ; |
---|
90 | } |
---|
91 | |
---|
92 | var currentNode = this._NextNode ; |
---|
93 | var lastNode = this._LastNode ; |
---|
94 | |
---|
95 | this._NextNode = null ; |
---|
96 | |
---|
97 | while ( currentNode ) |
---|
98 | { |
---|
99 | // closeRange indicates that a paragraph boundary has been found, |
---|
100 | // so the range can be closed. |
---|
101 | var closeRange = false ; |
---|
102 | |
---|
103 | // includeNode indicates that the current node is good to be part |
---|
104 | // of the range. By default, any non-element node is ok for it. |
---|
105 | var includeNode = ( currentNode.nodeType != 1 ) ; |
---|
106 | |
---|
107 | var continueFromSibling = false ; |
---|
108 | |
---|
109 | // If it is an element node, let's check if it can be part of the |
---|
110 | // range. |
---|
111 | if ( !includeNode ) |
---|
112 | { |
---|
113 | var nodeName = currentNode.nodeName.toLowerCase() ; |
---|
114 | |
---|
115 | if ( boundarySet[ nodeName ] && ( !FCKBrowserInfo.IsIE || currentNode.scopeName == 'HTML' ) ) |
---|
116 | { |
---|
117 | // <br> boundaries must be part of the range. It will |
---|
118 | // happen only if ForceBrBreak. |
---|
119 | if ( nodeName == 'br' ) |
---|
120 | includeNode = true ; |
---|
121 | else if ( !range && currentNode.childNodes.length == 0 && nodeName != 'hr' ) |
---|
122 | { |
---|
123 | // If we have found an empty block, and haven't started |
---|
124 | // the range yet, it means we must return this block. |
---|
125 | block = currentNode ; |
---|
126 | isLast = currentNode == lastNode ; |
---|
127 | break ; |
---|
128 | } |
---|
129 | |
---|
130 | // The range must finish right before the boundary, |
---|
131 | // including possibly skipped empty spaces. (#1603) |
---|
132 | if ( range ) |
---|
133 | { |
---|
134 | range.SetEnd( currentNode, 3, true ) ; |
---|
135 | |
---|
136 | // The found boundary must be set as the next one at this |
---|
137 | // point. (#1717) |
---|
138 | if ( nodeName != 'br' ) |
---|
139 | this._NextNode = FCKDomTools.GetNextSourceNode( currentNode, true, null, lastNode ) || currentNode ; |
---|
140 | } |
---|
141 | |
---|
142 | closeRange = true ; |
---|
143 | } |
---|
144 | else |
---|
145 | { |
---|
146 | // If we have child nodes, let's check them. |
---|
147 | if ( currentNode.firstChild ) |
---|
148 | { |
---|
149 | // If we don't have a range yet, let's start it. |
---|
150 | if ( !range ) |
---|
151 | { |
---|
152 | range = new FCKDomRange( this.Range.Window ) ; |
---|
153 | range.SetStart( currentNode, 3, true ) ; |
---|
154 | } |
---|
155 | |
---|
156 | currentNode = currentNode.firstChild ; |
---|
157 | continue ; |
---|
158 | } |
---|
159 | includeNode = true ; |
---|
160 | } |
---|
161 | } |
---|
162 | else if ( currentNode.nodeType == 3 ) |
---|
163 | { |
---|
164 | // Ignore normal whitespaces (i.e. not including or |
---|
165 | // other unicode whitespaces) before/after a block node. |
---|
166 | if ( /^[\r\n\t ]+$/.test( currentNode.nodeValue ) ) |
---|
167 | includeNode = false ; |
---|
168 | } |
---|
169 | |
---|
170 | // The current node is good to be part of the range and we are |
---|
171 | // starting a new range, initialize it first. |
---|
172 | if ( includeNode && !range ) |
---|
173 | { |
---|
174 | range = new FCKDomRange( this.Range.Window ) ; |
---|
175 | range.SetStart( currentNode, 3, true ) ; |
---|
176 | } |
---|
177 | |
---|
178 | // The last node has been found. |
---|
179 | isLast = ( ( !closeRange || includeNode ) && currentNode == lastNode ) ; |
---|
180 | // isLast = ( currentNode == lastNode && ( currentNode.nodeType != 1 || currentNode.childNodes.length == 0 ) ) ; |
---|
181 | |
---|
182 | // If we are in an element boundary, let's check if it is time |
---|
183 | // to close the range, otherwise we include the parent within it. |
---|
184 | if ( range && !closeRange ) |
---|
185 | { |
---|
186 | while ( !currentNode.nextSibling && !isLast ) |
---|
187 | { |
---|
188 | var parentNode = currentNode.parentNode ; |
---|
189 | |
---|
190 | if ( boundarySet[ parentNode.nodeName.toLowerCase() ] ) |
---|
191 | { |
---|
192 | closeRange = true ; |
---|
193 | isLast = isLast || ( parentNode == lastNode ) ; |
---|
194 | break ; |
---|
195 | } |
---|
196 | |
---|
197 | currentNode = parentNode ; |
---|
198 | includeNode = true ; |
---|
199 | isLast = ( currentNode == lastNode ) ; |
---|
200 | continueFromSibling = true ; |
---|
201 | } |
---|
202 | } |
---|
203 | |
---|
204 | // Now finally include the node. |
---|
205 | if ( includeNode ) |
---|
206 | range.SetEnd( currentNode, 4, true ) ; |
---|
207 | |
---|
208 | // We have found a block boundary. Let's close the range and move out of the |
---|
209 | // loop. |
---|
210 | if ( ( closeRange || isLast ) && range ) |
---|
211 | { |
---|
212 | range._UpdateElementInfo() ; |
---|
213 | |
---|
214 | if ( range.StartNode == range.EndNode |
---|
215 | && range.StartNode.parentNode == range.StartBlockLimit |
---|
216 | && range.StartNode.getAttribute && range.StartNode.getAttribute( '_fck_bookmark' ) ) |
---|
217 | range = null ; |
---|
218 | else |
---|
219 | break ; |
---|
220 | } |
---|
221 | |
---|
222 | if ( isLast ) |
---|
223 | break ; |
---|
224 | |
---|
225 | currentNode = FCKDomTools.GetNextSourceNode( currentNode, continueFromSibling, null, lastNode ) ; |
---|
226 | } |
---|
227 | |
---|
228 | // Now, based on the processed range, look for (or create) the block to be returned. |
---|
229 | if ( !block ) |
---|
230 | { |
---|
231 | // If no range has been found, this is the end. |
---|
232 | if ( !range ) |
---|
233 | { |
---|
234 | this._NextNode = null ; |
---|
235 | return null ; |
---|
236 | } |
---|
237 | |
---|
238 | block = range.StartBlock ; |
---|
239 | |
---|
240 | if ( !block |
---|
241 | && !this.EnforceRealBlocks |
---|
242 | && range.StartBlockLimit.nodeName.IEquals( 'DIV', 'TH', 'TD' ) |
---|
243 | && range.CheckStartOfBlock() |
---|
244 | && range.CheckEndOfBlock() ) |
---|
245 | { |
---|
246 | block = range.StartBlockLimit ; |
---|
247 | } |
---|
248 | else if ( !block || ( this.EnforceRealBlocks && block.nodeName.toLowerCase() == 'li' ) ) |
---|
249 | { |
---|
250 | // Create the fixed block. |
---|
251 | block = this.Range.Window.document.createElement( FCKConfig.EnterMode == 'p' ? 'p' : 'div' ) ; |
---|
252 | |
---|
253 | // Move the contents of the temporary range to the fixed block. |
---|
254 | range.ExtractContents().AppendTo( block ) ; |
---|
255 | FCKDomTools.TrimNode( block ) ; |
---|
256 | |
---|
257 | // Insert the fixed block into the DOM. |
---|
258 | range.InsertNode( block ) ; |
---|
259 | |
---|
260 | removePreviousBr = true ; |
---|
261 | removeLastBr = true ; |
---|
262 | } |
---|
263 | else if ( block.nodeName.toLowerCase() != 'li' ) |
---|
264 | { |
---|
265 | // If the range doesn't includes the entire contents of the |
---|
266 | // block, we must split it, isolating the range in a dedicated |
---|
267 | // block. |
---|
268 | if ( !range.CheckStartOfBlock() || !range.CheckEndOfBlock() ) |
---|
269 | { |
---|
270 | // The resulting block will be a clone of the current one. |
---|
271 | block = block.cloneNode( false ) ; |
---|
272 | |
---|
273 | // Extract the range contents, moving it to the new block. |
---|
274 | range.ExtractContents().AppendTo( block ) ; |
---|
275 | FCKDomTools.TrimNode( block ) ; |
---|
276 | |
---|
277 | // Split the block. At this point, the range will be in the |
---|
278 | // right position for our intents. |
---|
279 | var splitInfo = range.SplitBlock() ; |
---|
280 | |
---|
281 | removePreviousBr = !splitInfo.WasStartOfBlock ; |
---|
282 | removeLastBr = !splitInfo.WasEndOfBlock ; |
---|
283 | |
---|
284 | // Insert the new block into the DOM. |
---|
285 | range.InsertNode( block ) ; |
---|
286 | } |
---|
287 | } |
---|
288 | else if ( !isLast ) |
---|
289 | { |
---|
290 | // LIs are returned as is, with all their children (due to the |
---|
291 | // nested lists). But, the next node is the node right after |
---|
292 | // the current range, which could be an <li> child (nested |
---|
293 | // lists) or the next sibling <li>. |
---|
294 | |
---|
295 | this._NextNode = block == lastNode ? null : FCKDomTools.GetNextSourceNode( range.EndNode, true, null, lastNode ) ; |
---|
296 | return block ; |
---|
297 | } |
---|
298 | } |
---|
299 | |
---|
300 | if ( removePreviousBr ) |
---|
301 | { |
---|
302 | var previousSibling = block.previousSibling ; |
---|
303 | if ( previousSibling && previousSibling.nodeType == 1 ) |
---|
304 | { |
---|
305 | if ( previousSibling.nodeName.toLowerCase() == 'br' ) |
---|
306 | previousSibling.parentNode.removeChild( previousSibling ) ; |
---|
307 | else if ( previousSibling.lastChild && previousSibling.lastChild.nodeName.IEquals( 'br' ) ) |
---|
308 | previousSibling.removeChild( previousSibling.lastChild ) ; |
---|
309 | } |
---|
310 | } |
---|
311 | |
---|
312 | if ( removeLastBr ) |
---|
313 | { |
---|
314 | var lastChild = block.lastChild ; |
---|
315 | if ( lastChild && lastChild.nodeType == 1 && lastChild.nodeName.toLowerCase() == 'br' ) |
---|
316 | block.removeChild( lastChild ) ; |
---|
317 | } |
---|
318 | |
---|
319 | // Get a reference for the next element. This is important because the |
---|
320 | // above block can be removed or changed, so we can rely on it for the |
---|
321 | // next interation. |
---|
322 | if ( !this._NextNode ) |
---|
323 | this._NextNode = ( isLast || block == lastNode ) ? null : FCKDomTools.GetNextSourceNode( block, true, null, lastNode ) ; |
---|
324 | |
---|
325 | return block ; |
---|
326 | } |
---|
327 | } ; |
---|