fckdomtools.js
上传用户:dbstep
上传日期:2022-08-06
资源大小:2803k
文件大小:31k
源码类别:

WEB源码(ASP,PHP,...)

开发平台:

ASP/ASPX

  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.  * Utility functions to work with the DOM.
  22.  */
  23. var FCKDomTools =
  24. {
  25. /**
  26.  * Move all child nodes from one node to another.
  27.  */
  28. MoveChildren : function( source, target, toTargetStart )
  29. {
  30. if ( source == target )
  31. return ;
  32. var eChild ;
  33. if ( toTargetStart )
  34. {
  35. while ( (eChild = source.lastChild) )
  36. target.insertBefore( source.removeChild( eChild ), target.firstChild ) ;
  37. }
  38. else
  39. {
  40. while ( (eChild = source.firstChild) )
  41. target.appendChild( source.removeChild( eChild ) ) ;
  42. }
  43. },
  44. MoveNode : function( source, target, toTargetStart )
  45. {
  46. if ( toTargetStart )
  47. target.insertBefore( FCKDomTools.RemoveNode( source ), target.firstChild ) ;
  48. else
  49. target.appendChild( FCKDomTools.RemoveNode( source ) ) ;
  50. },
  51. // Remove blank spaces from the beginning and the end of the contents of a node.
  52. TrimNode : function( node )
  53. {
  54. this.LTrimNode( node ) ;
  55. this.RTrimNode( node ) ;
  56. },
  57. LTrimNode : function( node )
  58. {
  59. var eChildNode ;
  60. while ( (eChildNode = node.firstChild) )
  61. {
  62. if ( eChildNode.nodeType == 3 )
  63. {
  64. var sTrimmed = eChildNode.nodeValue.LTrim() ;
  65. var iOriginalLength = eChildNode.nodeValue.length ;
  66. if ( sTrimmed.length == 0 )
  67. {
  68. node.removeChild( eChildNode ) ;
  69. continue ;
  70. }
  71. else if ( sTrimmed.length < iOriginalLength )
  72. {
  73. eChildNode.splitText( iOriginalLength - sTrimmed.length ) ;
  74. node.removeChild( node.firstChild ) ;
  75. }
  76. }
  77. break ;
  78. }
  79. },
  80. RTrimNode : function( node )
  81. {
  82. var eChildNode ;
  83. while ( (eChildNode = node.lastChild) )
  84. {
  85. if ( eChildNode.nodeType == 3 )
  86. {
  87. var sTrimmed = eChildNode.nodeValue.RTrim() ;
  88. var iOriginalLength = eChildNode.nodeValue.length ;
  89. if ( sTrimmed.length == 0 )
  90. {
  91. // If the trimmed text node is empty, just remove it.
  92. // Use "eChildNode.parentNode" instead of "node" to avoid IE bug (#81).
  93. eChildNode.parentNode.removeChild( eChildNode ) ;
  94. continue ;
  95. }
  96. else if ( sTrimmed.length < iOriginalLength )
  97. {
  98. // If the trimmed text length is less than the original
  99. // length, strip all spaces from the end by splitting
  100. // the text and removing the resulting useless node.
  101. eChildNode.splitText( sTrimmed.length ) ;
  102. // Use "node.lastChild.parentNode" instead of "node" to avoid IE bug (#81).
  103. node.lastChild.parentNode.removeChild( node.lastChild ) ;
  104. }
  105. }
  106. break ;
  107. }
  108. if ( !FCKBrowserInfo.IsIE && !FCKBrowserInfo.IsOpera )
  109. {
  110. eChildNode = node.lastChild ;
  111. if ( eChildNode && eChildNode.nodeType == 1 && eChildNode.nodeName.toLowerCase() == 'br' )
  112. {
  113. // Use "eChildNode.parentNode" instead of "node" to avoid IE bug (#324).
  114. eChildNode.parentNode.removeChild( eChildNode ) ;
  115. }
  116. }
  117. },
  118. RemoveNode : function( node, excludeChildren )
  119. {
  120. if ( excludeChildren )
  121. {
  122. // Move all children before the node.
  123. var eChild ;
  124. while ( (eChild = node.firstChild) )
  125. node.parentNode.insertBefore( node.removeChild( eChild ), node ) ;
  126. }
  127. return node.parentNode.removeChild( node ) ;
  128. },
  129. GetFirstChild : function( node, childNames )
  130. {
  131. // If childNames is a string, transform it in a Array.
  132. if ( typeof ( childNames ) == 'string' )
  133. childNames = [ childNames ] ;
  134. var eChild = node.firstChild ;
  135. while( eChild )
  136. {
  137. if ( eChild.nodeType == 1 && eChild.tagName.Equals.apply( eChild.tagName, childNames ) )
  138. return eChild ;
  139. eChild = eChild.nextSibling ;
  140. }
  141. return null ;
  142. },
  143. GetLastChild : function( node, childNames )
  144. {
  145. // If childNames is a string, transform it in a Array.
  146. if ( typeof ( childNames ) == 'string' )
  147. childNames = [ childNames ] ;
  148. var eChild = node.lastChild ;
  149. while( eChild )
  150. {
  151. if ( eChild.nodeType == 1 && ( !childNames || eChild.tagName.Equals( childNames ) ) )
  152. return eChild ;
  153. eChild = eChild.previousSibling ;
  154. }
  155. return null ;
  156. },
  157. /*
  158.  * Gets the previous element (nodeType=1) in the source order. Returns
  159.  * "null" If no element is found.
  160.  * @param {Object} currentNode The node to start searching from.
  161.  * @param {Boolean} ignoreSpaceTextOnly Sets how text nodes will be
  162.  * handled. If set to "true", only white spaces text nodes
  163.  * will be ignored, while non white space text nodes will stop
  164.  * the search, returning null. If "false" or omitted, all
  165.  * text nodes are ignored.
  166.  * @param {string[]} stopSearchElements An array of element names that
  167.  * will cause the search to stop when found, returning null.
  168.  * May be omitted (or null).
  169.  * @param {string[]} ignoreElements An array of element names that
  170.  * must be ignored during the search.
  171.  */
  172. GetPreviousSourceElement : function( currentNode, ignoreSpaceTextOnly, stopSearchElements, ignoreElements )
  173. {
  174. if ( !currentNode )
  175. return null ;
  176. if ( stopSearchElements && currentNode.nodeType == 1 && currentNode.nodeName.IEquals( stopSearchElements ) )
  177. return null ;
  178. if ( currentNode.previousSibling )
  179. currentNode = currentNode.previousSibling ;
  180. else
  181. return this.GetPreviousSourceElement( currentNode.parentNode, ignoreSpaceTextOnly, stopSearchElements, ignoreElements ) ;
  182. while ( currentNode )
  183. {
  184. if ( currentNode.nodeType == 1 )
  185. {
  186. if ( stopSearchElements && currentNode.nodeName.IEquals( stopSearchElements ) )
  187. break ;
  188. if ( !ignoreElements || !currentNode.nodeName.IEquals( ignoreElements ) )
  189. return currentNode ;
  190. }
  191. else if ( ignoreSpaceTextOnly && currentNode.nodeType == 3 && currentNode.nodeValue.RTrim().length > 0 )
  192. break ;
  193. if ( currentNode.lastChild )
  194. currentNode = currentNode.lastChild ;
  195. else
  196. return this.GetPreviousSourceElement( currentNode, ignoreSpaceTextOnly, stopSearchElements, ignoreElements ) ;
  197. }
  198. return null ;
  199. },
  200. /*
  201.  * Gets the next element (nodeType=1) in the source order. Returns
  202.  * "null" If no element is found.
  203.  * @param {Object} currentNode The node to start searching from.
  204.  * @param {Boolean} ignoreSpaceTextOnly Sets how text nodes will be
  205.  * handled. If set to "true", only white spaces text nodes
  206.  * will be ignored, while non white space text nodes will stop
  207.  * the search, returning null. If "false" or omitted, all
  208.  * text nodes are ignored.
  209.  * @param {string[]} stopSearchElements An array of element names that
  210.  * will cause the search to stop when found, returning null.
  211.  * May be omitted (or null).
  212.  * @param {string[]} ignoreElements An array of element names that
  213.  * must be ignored during the search.
  214.  */
  215. GetNextSourceElement : function( currentNode, ignoreSpaceTextOnly, stopSearchElements, ignoreElements, startFromSibling )
  216. {
  217. while( ( currentNode = this.GetNextSourceNode( currentNode, startFromSibling ) ) ) // Only one "=".
  218. {
  219. if ( currentNode.nodeType == 1 )
  220. {
  221. if ( stopSearchElements && currentNode.nodeName.IEquals( stopSearchElements ) )
  222. break ;
  223. if ( ignoreElements && currentNode.nodeName.IEquals( ignoreElements ) )
  224. return this.GetNextSourceElement( currentNode, ignoreSpaceTextOnly, stopSearchElements, ignoreElements ) ;
  225. return currentNode ;
  226. }
  227. else if ( ignoreSpaceTextOnly && currentNode.nodeType == 3 && currentNode.nodeValue.RTrim().length > 0 )
  228. break ;
  229. }
  230. return null ;
  231. },
  232. /*
  233.  * Get the next DOM node available in source order.
  234.  */
  235. GetNextSourceNode : function( currentNode, startFromSibling, nodeType, stopSearchNode )
  236. {
  237. if ( !currentNode )
  238. return null ;
  239. var node ;
  240. if ( !startFromSibling && currentNode.firstChild )
  241. node = currentNode.firstChild ;
  242. else
  243. {
  244. if ( stopSearchNode && currentNode == stopSearchNode )
  245. return null ;
  246. node = currentNode.nextSibling ;
  247. if ( !node && ( !stopSearchNode || stopSearchNode != currentNode.parentNode ) )
  248. return this.GetNextSourceNode( currentNode.parentNode, true, nodeType, stopSearchNode ) ;
  249. }
  250. if ( nodeType && node && node.nodeType != nodeType )
  251. return this.GetNextSourceNode( node, false, nodeType, stopSearchNode ) ;
  252. return node ;
  253. },
  254. /*
  255.  * Get the next DOM node available in source order.
  256.  */
  257. GetPreviousSourceNode : function( currentNode, startFromSibling, nodeType, stopSearchNode )
  258. {
  259. if ( !currentNode )
  260. return null ;
  261. var node ;
  262. if ( !startFromSibling && currentNode.lastChild )
  263. node = currentNode.lastChild ;
  264. else
  265. {
  266. if ( stopSearchNode && currentNode == stopSearchNode )
  267. return null ;
  268. node = currentNode.previousSibling ;
  269. if ( !node && ( !stopSearchNode || stopSearchNode != currentNode.parentNode ) )
  270. return this.GetPreviousSourceNode( currentNode.parentNode, true, nodeType, stopSearchNode ) ;
  271. }
  272. if ( nodeType && node && node.nodeType != nodeType )
  273. return this.GetPreviousSourceNode( node, false, nodeType, stopSearchNode ) ;
  274. return node ;
  275. },
  276. // Inserts a element after a existing one.
  277. InsertAfterNode : function( existingNode, newNode )
  278. {
  279. return existingNode.parentNode.insertBefore( newNode, existingNode.nextSibling ) ;
  280. },
  281. GetParents : function( node )
  282. {
  283. var parents = new Array() ;
  284. while ( node )
  285. {
  286. parents.unshift( node ) ;
  287. node = node.parentNode ;
  288. }
  289. return parents ;
  290. },
  291. GetCommonParents : function( node1, node2 )
  292. {
  293. var p1 = this.GetParents( node1 ) ;
  294. var p2 = this.GetParents( node2 ) ;
  295. var retval = [] ;
  296. for ( var i = 0 ; i < p1.length ; i++ )
  297. {
  298. if ( p1[i] == p2[i] )
  299. retval.push( p1[i] ) ;
  300. }
  301. return retval ;
  302. },
  303. GetCommonParentNode : function( node1, node2, tagList )
  304. {
  305. var tagMap = {} ;
  306. if ( ! tagList.pop )
  307. tagList = [ tagList ] ;
  308. while ( tagList.length > 0 )
  309. tagMap[tagList.pop().toLowerCase()] = 1 ;
  310. var commonParents = this.GetCommonParents( node1, node2 ) ;
  311. var currentParent = null ;
  312. while ( ( currentParent = commonParents.pop() ) )
  313. {
  314. if ( tagMap[currentParent.nodeName.toLowerCase()] )
  315. return currentParent ;
  316. }
  317. return null ;
  318. },
  319. GetIndexOf : function( node )
  320. {
  321. var currentNode = node.parentNode ? node.parentNode.firstChild : null ;
  322. var currentIndex = -1 ;
  323. while ( currentNode )
  324. {
  325. currentIndex++ ;
  326. if ( currentNode == node )
  327. return currentIndex ;
  328. currentNode = currentNode.nextSibling ;
  329. }
  330. return -1 ;
  331. },
  332. PaddingNode : null,
  333. EnforcePaddingNode : function( doc, tagName )
  334. {
  335. // In IE it can happen when the page is reloaded that doc or doc.body is null, so exit here
  336. try
  337. {
  338. if ( !doc || !doc.body )
  339. return ;
  340. }
  341. catch (e)
  342. {
  343. return ;
  344. }
  345. this.CheckAndRemovePaddingNode( doc, tagName, true ) ;
  346. try
  347. {
  348. if ( doc.body.lastChild && ( doc.body.lastChild.nodeType != 1
  349. || doc.body.lastChild.tagName.toLowerCase() == tagName.toLowerCase() ) )
  350. return ;
  351. }
  352. catch (e)
  353. {
  354. return ;
  355. }
  356. var node = doc.createElement( tagName ) ;
  357. if ( FCKBrowserInfo.IsGecko && FCKListsLib.NonEmptyBlockElements[ tagName ] )
  358. FCKTools.AppendBogusBr( node ) ;
  359. this.PaddingNode = node ;
  360. if ( doc.body.childNodes.length == 1
  361. && doc.body.firstChild.nodeType == 1
  362. && doc.body.firstChild.tagName.toLowerCase() == 'br'
  363. && ( doc.body.firstChild.getAttribute( '_moz_dirty' ) != null
  364. || doc.body.firstChild.getAttribute( 'type' ) == '_moz' ) )
  365. doc.body.replaceChild( node, doc.body.firstChild ) ;
  366. else
  367. doc.body.appendChild( node ) ;
  368. },
  369. CheckAndRemovePaddingNode : function( doc, tagName, dontRemove )
  370. {
  371. var paddingNode = this.PaddingNode ;
  372. if ( ! paddingNode )
  373. return ;
  374. // If the padding node is changed, remove its status as a padding node.
  375. try
  376. {
  377. if ( paddingNode.parentNode != doc.body
  378. || paddingNode.tagName.toLowerCase() != tagName
  379. || ( paddingNode.childNodes.length > 1 )
  380. || ( paddingNode.firstChild && paddingNode.firstChild.nodeValue != 'xa0'
  381. && String(paddingNode.firstChild.tagName).toLowerCase() != 'br' ) )
  382. {
  383. this.PaddingNode = null ;
  384. return ;
  385. }
  386. }
  387. catch (e)
  388. {
  389. this.PaddingNode = null ;
  390. return ;
  391. }
  392. // Now we're sure the padding node exists, and it is unchanged, and it
  393. // isn't the only node in doc.body, remove it.
  394. if ( !dontRemove )
  395. {
  396. if ( paddingNode.parentNode.childNodes.length > 1 )
  397. paddingNode.parentNode.removeChild( paddingNode ) ;
  398. this.PaddingNode = null ;
  399. }
  400. },
  401. HasAttribute : function( element, attributeName )
  402. {
  403. if ( element.hasAttribute )
  404. return element.hasAttribute( attributeName ) ;
  405. else
  406. {
  407. var att = element.attributes[ attributeName ] ;
  408. return ( att != undefined && att.specified ) ;
  409. }
  410. },
  411. /**
  412.  * Checks if an element has "specified" attributes.
  413.  */
  414. HasAttributes : function( element )
  415. {
  416. var attributes = element.attributes ;
  417. for ( var i = 0 ; i < attributes.length ; i++ )
  418. {
  419. if ( FCKBrowserInfo.IsIE && attributes[i].nodeName == 'class' )
  420. {
  421. // IE has a strange bug. If calling removeAttribute('className'),
  422. // the attributes collection will still contain the "class"
  423. // attribute, which will be marked as "specified", even if the
  424. // outerHTML of the element is not displaying the class attribute.
  425. // Note : I was not able to reproduce it outside the editor,
  426. // but I've faced it while working on the TC of #1391.
  427. if ( element.className.length > 0 )
  428. return true ;
  429. }
  430. else if ( attributes[i].specified )
  431. return true ;
  432. }
  433. return false ;
  434. },
  435. /**
  436.  * Remove an attribute from an element.
  437.  */
  438. RemoveAttribute : function( element, attributeName )
  439. {
  440. if ( FCKBrowserInfo.IsIE && attributeName.toLowerCase() == 'class' )
  441. attributeName = 'className' ;
  442. return element.removeAttribute( attributeName, 0 ) ;
  443. },
  444. /**
  445.  * Removes an array of attributes from an element
  446.  */
  447. RemoveAttributes : function (element, aAttributes )
  448. {
  449. for ( var i = 0 ; i < aAttributes.length ; i++ )
  450. this.RemoveAttribute( element, aAttributes[i] );
  451. },
  452. GetAttributeValue : function( element, att )
  453. {
  454. var attName = att ;
  455. if ( typeof att == 'string' )
  456. att = element.attributes[ att ] ;
  457. else
  458. attName = att.nodeName ;
  459. if ( att && att.specified )
  460. {
  461. // IE returns "null" for the nodeValue of a "style" attribute.
  462. if ( attName == 'style' )
  463. return element.style.cssText ;
  464. // There are two cases when the nodeValue must be used:
  465. // - for the "class" attribute (all browsers).
  466. // - for events attributes (IE only).
  467. else if ( attName == 'class' || attName.indexOf('on') == 0 )
  468. return att.nodeValue ;
  469. else
  470. {
  471. // Use getAttribute to get its value  exactly as it is
  472. // defined.
  473. return element.getAttribute( attName, 2 ) ;
  474. }
  475. }
  476. return null ;
  477. },
  478. /**
  479.  * Checks whether one element contains the other.
  480.  */
  481. Contains : function( mainElement, otherElement )
  482. {
  483. // IE supports contains, but only for element nodes.
  484. if ( mainElement.contains && otherElement.nodeType == 1 )
  485. return mainElement.contains( otherElement ) ;
  486. while ( ( otherElement = otherElement.parentNode ) ) // Only one "="
  487. {
  488. if ( otherElement == mainElement )
  489. return true ;
  490. }
  491. return false ;
  492. },
  493. /**
  494.  * Breaks a parent element in the position of one of its contained elements.
  495.  * For example, in the following case:
  496.  * <b>This <i>is some<span /> sample</i> test text</b>
  497.  * If element = <span />, we have these results:
  498.  * <b>This <i>is some</i><span /><i> sample</i> test text</b> (If parent = <i>)
  499.  * <b>This <i>is some</i></b><span /><b><i> sample</i> test text</b> (If parent = <b>)
  500.  */
  501. BreakParent : function( element, parent, reusableRange )
  502. {
  503. var range = reusableRange || new FCKDomRange( FCKTools.GetElementWindow( element ) ) ;
  504. // We'll be extracting part of this element, so let's use our
  505. // range to get the correct piece.
  506. range.SetStart( element, 4 ) ;
  507. range.SetEnd( parent, 4 ) ;
  508. // Extract it.
  509. var docFrag = range.ExtractContents() ;
  510. // Move the element outside the broken element.
  511. range.InsertNode( element.parentNode.removeChild( element ) ) ;
  512. // Re-insert the extracted piece after the element.
  513. docFrag.InsertAfterNode( element ) ;
  514. range.Release( !!reusableRange ) ;
  515. },
  516. /**
  517.  * Retrieves a uniquely identifiable tree address of a DOM tree node.
  518.  * The tree address returns is an array of integers, with each integer
  519.  * indicating a child index from a DOM tree node, starting from
  520.  * document.documentElement.
  521.  *
  522.  * For example, assuming <body> is the second child from <html> (<head>
  523.  * being the first), and we'd like to address the third child under the
  524.  * fourth child of body, the tree address returned would be:
  525.  * [1, 3, 2]
  526.  *
  527.  * The tree address cannot be used for finding back the DOM tree node once
  528.  * the DOM tree structure has been modified.
  529.  */
  530. GetNodeAddress : function( node, normalized )
  531. {
  532. var retval = [] ;
  533. while ( node && node != FCKTools.GetElementDocument( node ).documentElement )
  534. {
  535. var parentNode = node.parentNode ;
  536. var currentIndex = -1 ;
  537. for( var i = 0 ; i < parentNode.childNodes.length ; i++ )
  538. {
  539. var candidate = parentNode.childNodes[i] ;
  540. if ( normalized === true &&
  541. candidate.nodeType == 3 &&
  542. candidate.previousSibling &&
  543. candidate.previousSibling.nodeType == 3 )
  544. continue;
  545. currentIndex++ ;
  546. if ( parentNode.childNodes[i] == node )
  547. break ;
  548. }
  549. retval.unshift( currentIndex ) ;
  550. node = node.parentNode ;
  551. }
  552. return retval ;
  553. },
  554. /**
  555.  * The reverse transformation of FCKDomTools.GetNodeAddress(). This
  556.  * function returns the DOM node pointed to by its index address.
  557.  */
  558. GetNodeFromAddress : function( doc, addr, normalized )
  559. {
  560. var cursor = doc.documentElement ;
  561. for ( var i = 0 ; i < addr.length ; i++ )
  562. {
  563. var target = addr[i] ;
  564. if ( ! normalized )
  565. {
  566. cursor = cursor.childNodes[target] ;
  567. continue ;
  568. }
  569. var currentIndex = -1 ;
  570. for (var j = 0 ; j < cursor.childNodes.length ; j++ )
  571. {
  572. var candidate = cursor.childNodes[j] ;
  573. if ( normalized === true &&
  574. candidate.nodeType == 3 &&
  575. candidate.previousSibling &&
  576. candidate.previousSibling.nodeType == 3 )
  577. continue ;
  578. currentIndex++ ;
  579. if ( currentIndex == target )
  580. {
  581. cursor = candidate ;
  582. break ;
  583. }
  584. }
  585. }
  586. return cursor ;
  587. },
  588. CloneElement : function( element )
  589. {
  590. element = element.cloneNode( false ) ;
  591. // The "id" attribute should never be cloned to avoid duplication.
  592. element.removeAttribute( 'id', false ) ;
  593. return element ;
  594. },
  595. ClearElementJSProperty : function( element, attrName )
  596. {
  597. if ( FCKBrowserInfo.IsIE )
  598. element.removeAttribute( attrName ) ;
  599. else
  600. delete element[attrName] ;
  601. },
  602. SetElementMarker : function ( markerObj, element, attrName, value)
  603. {
  604. var id = String( parseInt( Math.random() * 0xffffffff, 10 ) ) ;
  605. element._FCKMarkerId = id ;
  606. element[attrName] = value ;
  607. if ( ! markerObj[id] )
  608. markerObj[id] = { 'element' : element, 'markers' : {} } ;
  609. markerObj[id]['markers'][attrName] = value ;
  610. },
  611. ClearElementMarkers : function( markerObj, element, clearMarkerObj )
  612. {
  613. var id = element._FCKMarkerId ;
  614. if ( ! id )
  615. return ;
  616. this.ClearElementJSProperty( element, '_FCKMarkerId' ) ;
  617. for ( var j in markerObj[id]['markers'] )
  618. this.ClearElementJSProperty( element, j ) ;
  619. if ( clearMarkerObj )
  620. delete markerObj[id] ;
  621. },
  622. ClearAllMarkers : function( markerObj )
  623. {
  624. for ( var i in markerObj )
  625. this.ClearElementMarkers( markerObj, markerObj[i]['element'], true ) ;
  626. },
  627. /**
  628.  * Convert a DOM list tree into a data structure that is easier to
  629.  * manipulate. This operation should be non-intrusive in the sense that it
  630.  * does not change the DOM tree, with the exception that it may add some
  631.  * markers to the list item nodes when markerObj is specified.
  632.  */
  633. ListToArray : function( listNode, markerObj, baseArray, baseIndentLevel, grandparentNode )
  634. {
  635. if ( ! listNode.nodeName.IEquals( ['ul', 'ol'] ) )
  636. return [] ;
  637. if ( ! baseIndentLevel )
  638. baseIndentLevel = 0 ;
  639. if ( ! baseArray )
  640. baseArray = [] ;
  641. // Iterate over all list items to get their contents and look for inner lists.
  642. for ( var i = 0 ; i < listNode.childNodes.length ; i++ )
  643. {
  644. var listItem = listNode.childNodes[i] ;
  645. if ( ! listItem.nodeName.IEquals( 'li' ) )
  646. continue ;
  647. var itemObj = { 'parent' : listNode, 'indent' : baseIndentLevel, 'contents' : [] } ;
  648. if ( ! grandparentNode )
  649. {
  650. itemObj.grandparent = listNode.parentNode ;
  651. if ( itemObj.grandparent && itemObj.grandparent.nodeName.IEquals( 'li' ) )
  652. itemObj.grandparent = itemObj.grandparent.parentNode ;
  653. }
  654. else
  655. itemObj.grandparent = grandparentNode ;
  656. if ( markerObj )
  657. this.SetElementMarker( markerObj, listItem, '_FCK_ListArray_Index', baseArray.length ) ;
  658. baseArray.push( itemObj ) ;
  659. for ( var j = 0 ; j < listItem.childNodes.length ; j++ )
  660. {
  661. var child = listItem.childNodes[j] ;
  662. if ( child.nodeName.IEquals( ['ul', 'ol'] ) )
  663. // Note the recursion here, it pushes inner list items with
  664. // +1 indentation in the correct order.
  665. this.ListToArray( child, markerObj, baseArray, baseIndentLevel + 1, itemObj.grandparent ) ;
  666. else
  667. itemObj.contents.push( child ) ;
  668. }
  669. }
  670. return baseArray ;
  671. },
  672. // Convert our internal representation of a list back to a DOM forest.
  673. ArrayToList : function( listArray, markerObj, baseIndex )
  674. {
  675. if ( baseIndex == undefined )
  676. baseIndex = 0 ;
  677. if ( ! listArray || listArray.length < baseIndex + 1 )
  678. return null ;
  679. var doc = FCKTools.GetElementDocument( listArray[baseIndex].parent ) ;
  680. var retval = doc.createDocumentFragment() ;
  681. var rootNode = null ;
  682. var currentIndex = baseIndex ;
  683. var indentLevel = Math.max( listArray[baseIndex].indent, 0 ) ;
  684. var currentListItem = null ;
  685. while ( true )
  686. {
  687. var item = listArray[currentIndex] ;
  688. if ( item.indent == indentLevel )
  689. {
  690. if ( ! rootNode || listArray[currentIndex].parent.nodeName != rootNode.nodeName )
  691. {
  692. rootNode = listArray[currentIndex].parent.cloneNode( false ) ;
  693. retval.appendChild( rootNode ) ;
  694. }
  695. currentListItem = doc.createElement( 'li' ) ;
  696. rootNode.appendChild( currentListItem ) ;
  697. for ( var i = 0 ; i < item.contents.length ; i++ )
  698. currentListItem.appendChild( item.contents[i].cloneNode( true ) ) ;
  699. currentIndex++ ;
  700. }
  701. else if ( item.indent == Math.max( indentLevel, 0 ) + 1 )
  702. {
  703. var listData = this.ArrayToList( listArray, null, currentIndex ) ;
  704. currentListItem.appendChild( listData.listNode ) ;
  705. currentIndex = listData.nextIndex ;
  706. }
  707. else if ( item.indent == -1 && baseIndex == 0 && item.grandparent )
  708. {
  709. var currentListItem ;
  710. if ( item.grandparent.nodeName.IEquals( ['ul', 'ol'] ) )
  711. currentListItem = doc.createElement( 'li' ) ;
  712. else
  713. {
  714. if ( FCKConfig.EnterMode.IEquals( ['div', 'p'] ) && ! item.grandparent.nodeName.IEquals( 'td' ) )
  715. currentListItem = doc.createElement( FCKConfig.EnterMode ) ;
  716. else
  717. currentListItem = doc.createDocumentFragment() ;
  718. }
  719. for ( var i = 0 ; i < item.contents.length ; i++ )
  720. currentListItem.appendChild( item.contents[i].cloneNode( true ) ) ;
  721. if ( currentListItem.nodeType == 11 )
  722. {
  723. if ( currentListItem.lastChild &&
  724. currentListItem.lastChild.getAttribute &&
  725. currentListItem.lastChild.getAttribute( 'type' ) == '_moz' )
  726. currentListItem.removeChild( currentListItem.lastChild );
  727. currentListItem.appendChild( doc.createElement( 'br' ) ) ;
  728. }
  729. if ( currentListItem.nodeName.IEquals( FCKConfig.EnterMode ) && currentListItem.firstChild )
  730. {
  731. this.TrimNode( currentListItem ) ;
  732. if ( FCKListsLib.BlockBoundaries[currentListItem.firstChild.nodeName.toLowerCase()] )
  733. {
  734. var tmp = doc.createDocumentFragment() ;
  735. while ( currentListItem.firstChild )
  736. tmp.appendChild( currentListItem.removeChild( currentListItem.firstChild ) ) ;
  737. currentListItem = tmp ;
  738. }
  739. }
  740. if ( FCKBrowserInfo.IsGeckoLike && currentListItem.nodeName.IEquals( ['div', 'p'] ) )
  741. FCKTools.AppendBogusBr( currentListItem ) ;
  742. retval.appendChild( currentListItem ) ;
  743. rootNode = null ;
  744. currentIndex++ ;
  745. }
  746. else
  747. return null ;
  748. if ( listArray.length <= currentIndex || Math.max( listArray[currentIndex].indent, 0 ) < indentLevel )
  749. {
  750. break ;
  751. }
  752. }
  753. // Clear marker attributes for the new list tree made of cloned nodes, if any.
  754. if ( markerObj )
  755. {
  756. var currentNode = retval.firstChild ;
  757. while ( currentNode )
  758. {
  759. if ( currentNode.nodeType == 1 )
  760. this.ClearElementMarkers( markerObj, currentNode ) ;
  761. currentNode = this.GetNextSourceNode( currentNode ) ;
  762. }
  763. }
  764. return { 'listNode' : retval, 'nextIndex' : currentIndex } ;
  765. },
  766. /**
  767.  * Get the next sibling node for a node. If "includeEmpties" is false,
  768.  * only element or non empty text nodes are returned.
  769.  */
  770. GetNextSibling : function( node, includeEmpties )
  771. {
  772. node = node.nextSibling ;
  773. while ( node && !includeEmpties && node.nodeType != 1 && ( node.nodeType != 3 || node.nodeValue.length == 0 ) )
  774. node = node.nextSibling ;
  775. return node ;
  776. },
  777. /**
  778.  * Get the previous sibling node for a node. If "includeEmpties" is false,
  779.  * only element or non empty text nodes are returned.
  780.  */
  781. GetPreviousSibling : function( node, includeEmpties )
  782. {
  783. node = node.previousSibling ;
  784. while ( node && !includeEmpties && node.nodeType != 1 && ( node.nodeType != 3 || node.nodeValue.length == 0 ) )
  785. node = node.previousSibling ;
  786. return node ;
  787. },
  788. /**
  789.  * Checks if an element has no "useful" content inside of it
  790.  * node tree. No "useful" content means empty text node or a signle empty
  791.  * inline node.
  792.  * elementCheckCallback may point to a function that returns a boolean
  793.  * indicating that a child element must be considered in the element check.
  794.  */
  795. CheckIsEmptyElement : function( element, elementCheckCallback )
  796. {
  797. var child = element.firstChild ;
  798. var elementChild ;
  799. while ( child )
  800. {
  801. if ( child.nodeType == 1 )
  802. {
  803. if ( elementChild || !FCKListsLib.InlineNonEmptyElements[ child.nodeName.toLowerCase() ] )
  804. return false ;
  805. if ( !elementCheckCallback || elementCheckCallback( child ) === true )
  806. elementChild = child ;
  807. }
  808. else if ( child.nodeType == 3 && child.nodeValue.length > 0 )
  809. return false ;
  810. child = child.nextSibling ;
  811. }
  812. return elementChild ? this.CheckIsEmptyElement( elementChild, elementCheckCallback ) : true ;
  813. },
  814. SetElementStyles : function( element, styleDict )
  815. {
  816. var style = element.style ;
  817. for ( var styleName in styleDict )
  818. style[ styleName ] = styleDict[ styleName ] ;
  819. },
  820. SetOpacity : function( element, opacity )
  821. {
  822. if ( FCKBrowserInfo.IsIE )
  823. {
  824. opacity = Math.round( opacity * 100 ) ;
  825. element.style.filter = ( opacity > 100 ? '' : 'progid:DXImageTransform.Microsoft.Alpha(opacity=' + opacity + ')' ) ;
  826. }
  827. else
  828. element.style.opacity = opacity ;
  829. },
  830. GetCurrentElementStyle : function( element, propertyName )
  831. {
  832. if ( FCKBrowserInfo.IsIE )
  833. return element.currentStyle[ propertyName ] ;
  834. else
  835. return element.ownerDocument.defaultView.getComputedStyle( element, '' ).getPropertyValue( propertyName ) ;
  836. },
  837. GetPositionedAncestor : function( element )
  838. {
  839. var currentElement = element ;
  840. while ( currentElement != FCKTools.GetElementDocument( currentElement ).documentElement )
  841. {
  842. if ( this.GetCurrentElementStyle( currentElement, 'position' ) != 'static' )
  843. return currentElement ;
  844. if ( currentElement == FCKTools.GetElementDocument( currentElement ).documentElement
  845. && currentWindow != w )
  846. currentElement = currentWindow.frameElement ;
  847. else
  848. currentElement = currentElement.parentNode ;
  849. }
  850. return null ;
  851. },
  852. /**
  853.  * Current implementation for ScrollIntoView (due to #1462 and #2279). We
  854.  * don't have a complete implementation here, just the things that fit our
  855.  * needs.
  856.  */
  857. ScrollIntoView : function( element, alignTop )
  858. {
  859. // Get the element window.
  860. var window = FCKTools.GetElementWindow( element ) ;
  861. var windowHeight = FCKTools.GetViewPaneSize( window ).Height ;
  862. // Starts the offset that will be scrolled with the negative value of
  863. // the visible window height.
  864. var offset = windowHeight * -1 ;
  865. // Appends the height it we are about to align the bottoms.
  866. if ( alignTop === false )
  867. {
  868. offset += element.offsetHeight || 0 ;
  869. // Consider the margin in the scroll, which is ok for our current
  870. // needs, but needs investigation if we will be using this function
  871. // in other places.
  872. offset += parseInt( this.GetCurrentElementStyle( element, 'marginBottom' ) || 0, 10 ) || 0 ;
  873. }
  874. // Appends the offsets for the entire element hierarchy.
  875. var elementPosition = FCKTools.GetDocumentPosition( window, element ) ;
  876. offset += elementPosition.y ;
  877. // Scroll the window to the desired position, if not already visible.
  878. var currentScroll = FCKTools.GetScrollPosition( window ).Y ;
  879. if ( offset > 0 && ( offset > currentScroll || offset < currentScroll - windowHeight ) )
  880. window.scrollTo( 0, offset ) ;
  881. },
  882. /**
  883.  * Check if the element can be edited inside the browser.
  884.  */
  885. CheckIsEditable : function( element )
  886. {
  887. // Get the element name.
  888. var nodeName = element.nodeName.toLowerCase() ;
  889. // Get the element DTD (defaults to span for unknown elements).
  890. var childDTD = FCK.DTD[ nodeName ] || FCK.DTD.span ;
  891. // In the DTD # == text node.
  892. return ( childDTD['#'] && !FCKListsLib.NonEditableElements[ nodeName ] ) ;
  893. },
  894. GetSelectedDivContainers : function()
  895. {
  896. var currentBlocks = [] ;
  897. var range = new FCKDomRange( FCK.EditorWindow ) ;
  898. range.MoveToSelection() ;
  899. var startNode = range.GetTouchedStartNode() ;
  900. var endNode = range.GetTouchedEndNode() ;
  901. var currentNode = startNode ;
  902. if ( startNode == endNode )
  903. {
  904. while ( endNode.nodeType == 1 && endNode.lastChild )
  905. endNode = endNode.lastChild ;
  906. endNode = FCKDomTools.GetNextSourceNode( endNode ) ;
  907. }
  908. while ( currentNode && currentNode != endNode )
  909. {
  910. if ( currentNode.nodeType != 3 || !/^[ tn]*$/.test( currentNode.nodeValue ) )
  911. {
  912. var path = new FCKElementPath( currentNode ) ;
  913. var blockLimit = path.BlockLimit ;
  914. if ( blockLimit && blockLimit.nodeName.IEquals( 'div' ) && currentBlocks.IndexOf( blockLimit ) == -1 )
  915. currentBlocks.push( blockLimit ) ;
  916. }
  917. currentNode = FCKDomTools.GetNextSourceNode( currentNode ) ;
  918. }
  919. return currentBlocks ;
  920. }
  921. } ;