[1575] | 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 | } ;
|
---|