fckdomrangeiterator.js
上传用户:ah_jiwei
上传日期:2022-07-24
资源大小:54044k
文件大小:9k
源码类别:

数据库编程

开发平台:

Visual C++

  1. /*
  2.  * FCKeditor - The text editor for Internet - http://www.fckeditor.net
  3.  * Copyright (C) 2003-2007 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. var FCKDomRangeIterator = function( range )
  28. {
  29. /**
  30.  * The FCKDomRange object that marks the interation boundaries.
  31.  */
  32. this.Range = range ;
  33. /**
  34.  * Indicates that <br> elements must be used as paragraph boundaries.
  35.  */
  36. this.ForceBrBreak = false ;
  37. /**
  38.  * Guarantees that the iterator will always return "real" block elements.
  39.  * If "false", elements like <li>, <th> and <td> are returned. If "true", a
  40.  * dedicated block element block element will be created inside those
  41.  * elements to hold the selected content.
  42.  */
  43. this.EnforceRealBlocks = false ;
  44. }
  45. FCKDomRangeIterator.CreateFromSelection = function( targetWindow )
  46. {
  47. var range = new FCKDomRange( targetWindow ) ;
  48. range.MoveToSelection() ;
  49. return new FCKDomRangeIterator( range ) ;
  50. }
  51. FCKDomRangeIterator.prototype =
  52. {
  53. /**
  54.  * Get the next paragraph element. It automatically breaks the document
  55.  * when necessary to generate block elements for the paragraphs.
  56.  */
  57. GetNextParagraph : function()
  58. {
  59. // The block element to be returned.
  60. var block ;
  61. // The range object used to identify the paragraph contents.
  62. var range ;
  63. // Indicated that the current element in the loop is the last one.
  64. var isLast ;
  65. // Instructs to cleanup remaining BRs.
  66. var removePreviousBr ;
  67. var removeLastBr ;
  68. var boundarySet = this.ForceBrBreak ? FCKListsLib.ListBoundaries : FCKListsLib.BlockBoundaries ;
  69. // This is the first iteration. Let's initialize it.
  70. if ( !this._LastNode )
  71. {
  72. var range = this.Range.Clone() ;
  73. range.Expand( this.ForceBrBreak ? 'list_contents' : 'block_contents' ) ;
  74. this._NextNode = range.GetTouchedStartNode() ;
  75. this._LastNode = range.GetTouchedEndNode() ;
  76. // Let's reuse this variable.
  77. range = null ;
  78. }
  79. var currentNode = this._NextNode ;
  80. var lastNode = this._LastNode ;
  81. while ( currentNode )
  82. {
  83. // closeRange indicates that a paragraph boundary has been found,
  84. // so the range can be closed.
  85. var closeRange = false ;
  86. // includeNode indicates that the current node is good to be part
  87. // of the range. By default, any non-element node is ok for it.
  88. var includeNode = ( currentNode.nodeType != 1 ) ;
  89. var continueFromSibling = false ;
  90. // If it is an element node, let's check if it can be part of the
  91. // range.
  92. if ( !includeNode )
  93. {
  94. var nodeName = currentNode.nodeName.toLowerCase() ;
  95. if ( boundarySet[ nodeName ] )
  96. {
  97. // <br> boundaries must be part of the range. It will
  98. // happen only if ForceBrBreak.
  99. if ( nodeName == 'br' )
  100. includeNode = true ;
  101. else if ( !range && currentNode.childNodes.length == 0 && nodeName != 'hr' )
  102. {
  103. // If we have found an empty block, and haven't started
  104. // the range yet, it means we must return this block.
  105. block = currentNode ;
  106. isLast = currentNode == lastNode ;
  107. break ;
  108. }
  109. closeRange = true ;
  110. }
  111. else
  112. {
  113. // If we have child nodes, let's check them.
  114. if ( currentNode.firstChild )
  115. {
  116. // If we don't have a range yet, let's start it.
  117. if ( !range )
  118. {
  119. range = new FCKDomRange( this.Range.Window ) ;
  120. range.SetStart( currentNode, 3, true ) ;
  121. }
  122. currentNode = currentNode.firstChild ;
  123. continue ;
  124. }
  125. includeNode = true ;
  126. }
  127. }
  128. else if ( currentNode.nodeType == 3 )
  129. {
  130. // Ignore normal whitespaces (i.e. not including &nbsp; or
  131. // other unicode whitespaces) before/after a block node.
  132. if ( /^[rnt ]+$/.test( currentNode.nodeValue ) )
  133. includeNode = false ;
  134. }
  135. // The current node is good to be part of the range and we are
  136. // starting a new range, initialize it first.
  137. if ( includeNode && !range )
  138. {
  139. range = new FCKDomRange( this.Range.Window ) ;
  140. range.SetStart( currentNode, 3, true ) ;
  141. }
  142. // The last node has been found.
  143. isLast = ( ( !closeRange || includeNode ) && currentNode == lastNode ) ;
  144. // isLast = ( currentNode == lastNode && ( currentNode.nodeType != 1 || currentNode.childNodes.length == 0 ) ) ;
  145. // If we are in an element boundary, let's check if it is time
  146. // to close the range, otherwise we include the parent within it.
  147. if ( range && !closeRange )
  148. {
  149. while ( !currentNode.nextSibling && !isLast )
  150. {
  151. var parentNode = currentNode.parentNode ;
  152. if ( boundarySet[ parentNode.nodeName.toLowerCase() ] )
  153. {
  154. closeRange = true ;
  155. isLast = isLast || ( parentNode == lastNode ) ;
  156. break ;
  157. }
  158. currentNode = parentNode ;
  159. isLast = ( currentNode == lastNode ) ;
  160. continueFromSibling = true ;
  161. }
  162. }
  163. // Now finally include the node.
  164. if ( includeNode )
  165. range.SetEnd( currentNode, 4, true ) ;
  166. // We have found a block boundary. Let's close the range and move out of the
  167. // loop.
  168. if ( ( closeRange || isLast ) && range )
  169. {
  170. range._UpdateElementInfo() ;
  171. if ( range.StartNode == range.EndNode 
  172. && range.StartNode.parentNode == range.StartBlockLimit 
  173. && range.StartNode.getAttribute && range.StartNode.getAttribute( '_fck_bookmark' ) )
  174. range = null ;
  175. else
  176. break ;
  177. }
  178. if ( isLast )
  179. break ;
  180. currentNode = FCKDomTools.GetNextSourceNode( currentNode, continueFromSibling, null, lastNode ) ;
  181. }
  182. // Now, based on the processed range, look for (or create) the block to be returned.
  183. if ( !block )
  184. {
  185. // If no range has been found, this is the end.
  186. if ( !range )
  187. {
  188. this._NextNode = null ;
  189. return null ;
  190. }
  191. block = range.StartBlock ;
  192. if ( !block
  193. && !this.EnforceRealBlocks
  194. && range.StartBlockLimit.nodeName.IEquals( 'DIV', 'TH', 'TD' )
  195. && range.CheckStartOfBlock()
  196. && range.CheckEndOfBlock() )
  197. {
  198. block = range.StartBlockLimit ;
  199. }
  200. else if ( !block || ( this.EnforceRealBlocks && block.nodeName.toLowerCase() == 'li' ) )
  201. {
  202. // Create the fixed block.
  203. block = this.Range.Window.document.createElement( FCKConfig.EnterMode == 'p' ? 'p' : 'div' ) ;
  204. // Move the contents of the temporary range to the fixed block.
  205. range.ExtractContents().AppendTo( block ) ;
  206. FCKDomTools.TrimNode( block ) ;
  207. // Insert the fixed block into the DOM.
  208. range.InsertNode( block ) ;
  209. removePreviousBr = true ;
  210. removeLastBr = true ;
  211. }
  212. else if ( block.nodeName.toLowerCase() != 'li' )
  213. {
  214. // If the range doesn't includes the entire contents of the
  215. // block, we must split it, isolating the range in a dedicated
  216. // block.
  217. if ( !range.CheckStartOfBlock() || !range.CheckEndOfBlock() )
  218. {
  219. // The resulting block will be a clone of the current one.
  220. block = block.cloneNode( false ) ;
  221. // Extract the range contents, moving it to the new block.
  222. range.ExtractContents().AppendTo( block ) ;
  223. FCKDomTools.TrimNode( block ) ;
  224. // Split the block. At this point, the range will be in the
  225. // right position for our intents.
  226. var splitInfo = range.SplitBlock() ;
  227. removePreviousBr = !splitInfo.WasStartOfBlock ;
  228. removeLastBr = !splitInfo.WasEndOfBlock ;
  229. // Insert the new block into the DOM.
  230. range.InsertNode( block ) ;
  231. }
  232. }
  233. else if ( !isLast )
  234. {
  235. // LIs are returned as is, with all their children (due to the
  236. // nested lists). But, the next node is the node right after
  237. // the current range, which could be an <li> child (nested
  238. // lists) or the next sibling <li>.
  239. this._NextNode = block == lastNode ? null : FCKDomTools.GetNextSourceNode( range.EndNode, true, null, lastNode ) ;
  240. return block ;
  241. }
  242. }
  243. if ( removePreviousBr )
  244. {
  245. var previousSibling = block.previousSibling ;
  246. if ( previousSibling && previousSibling.nodeType == 1 && previousSibling.nodeName.toLowerCase() == 'br' )
  247. previousSibling.parentNode.removeChild( previousSibling ) ;
  248. }
  249. if ( removeLastBr )
  250. {
  251. var lastChild = block.lastChild ;
  252. if ( lastChild && lastChild.nodeType == 1 && lastChild.nodeName.toLowerCase() == 'br' )
  253. block.removeChild( lastChild ) ;
  254. }
  255. // Get a reference for the next element. This is important because the
  256. // above block can be removed or changed, so we can rely on it for the
  257. // next interation.
  258. this._NextNode = ( isLast || block == lastNode ) ? null : FCKDomTools.GetNextSourceNode( block, true, null, lastNode ) ;
  259. return block ;
  260. }
  261. } ;