2
* FCKeditor - The text editor for Internet - http://www.fckeditor.net
3
* Copyright (C) 2003-2009 Frederico Caldeira Knabben
7
* Licensed under the terms of any of the following licenses at your
10
* - GNU General Public License Version 2 or later (the "GPL")
11
* http://www.gnu.org/licenses/gpl.html
13
* - GNU Lesser General Public License Version 2.1 or later (the "LGPL")
14
* http://www.gnu.org/licenses/lgpl.html
16
* - Mozilla Public License Version 1.1 or later (the "MPL")
17
* http://www.mozilla.org/MPL/MPL-1.1.html
21
* FCKStyle Class: contains a style definition, and all methods to work with
22
* the style in a document.
26
* @param {Object} styleDesc A "style descriptor" object, containing the raw
27
* style definition in the following format:
29
* Element : '<element name>',
31
* '<att name>' : '<att value>',
35
* '<style name>' : '<style value>',
38
* Overrides : '<element name>'|{
39
* Element : '<element name>',
41
* '<att name>' : '<att value>'|/<att regex>/
44
* '<style name>' : '<style value>'|/<style regex>/
49
var FCKStyle = function( styleDesc )
51
this.Element = ( styleDesc.Element || 'span' ).toLowerCase() ;
52
this._StyleDesc = styleDesc ;
58
* Get the style type, based on its element name:
59
* - FCK_STYLE_BLOCK (0): Block Style
60
* - FCK_STYLE_INLINE (1): Inline Style
61
* - FCK_STYLE_OBJECT (2): Object Style
65
var type = this.GetType_$ ;
67
if ( type != undefined )
70
var elementName = this.Element ;
72
if ( elementName == '#' || FCKListsLib.StyleBlockElements[ elementName ] )
73
type = FCK_STYLE_BLOCK ;
74
else if ( FCKListsLib.StyleObjectElements[ elementName ] )
75
type = FCK_STYLE_OBJECT ;
77
type = FCK_STYLE_INLINE ;
79
return ( this.GetType_$ = type ) ;
83
* Apply the style to the current selection.
85
ApplyToSelection : function( targetWindow )
87
// Create a range for the current selection.
88
var range = new FCKDomRange( targetWindow ) ;
89
range.MoveToSelection() ;
91
this.ApplyToRange( range, true ) ;
95
* Apply the style to a FCKDomRange.
97
ApplyToRange : function( range, selectIt, updateRange )
99
// ApplyToRange is not valid for FCK_STYLE_OBJECT types.
100
// Use ApplyToObject instead.
102
switch ( this.GetType() )
104
case FCK_STYLE_BLOCK :
105
this.ApplyToRange = this._ApplyBlockStyle ;
107
case FCK_STYLE_INLINE :
108
this.ApplyToRange = this._ApplyInlineStyle ;
114
this.ApplyToRange( range, selectIt, updateRange ) ;
118
* Apply the style to an object. Valid for FCK_STYLE_BLOCK types only.
120
ApplyToObject : function( objectElement )
122
if ( !objectElement )
125
this.BuildElement( null, objectElement ) ;
129
* Remove the style from the current selection.
131
RemoveFromSelection : function( targetWindow )
133
// Create a range for the current selection.
134
var range = new FCKDomRange( targetWindow ) ;
135
range.MoveToSelection() ;
137
this.RemoveFromRange( range, true ) ;
141
* Remove the style from a FCKDomRange. Block type styles will have no
144
RemoveFromRange : function( range, selectIt, updateRange )
148
// Create the attribute list to be used later for element comparisons.
149
var styleAttribs = this._GetAttribsForComparison() ;
150
var styleOverrides = this._GetOverridesForComparison() ;
152
// If collapsed, we are removing all conflicting styles from the range
154
if ( range.CheckIsCollapsed() )
156
// Bookmark the range so we can re-select it after processing.
157
var bookmark = range.CreateBookmark( true ) ;
159
// Let's start from the bookmark <span> parent.
160
var bookmarkStart = range.GetBookmarkNode( bookmark, true ) ;
162
var path = new FCKElementPath( bookmarkStart.parentNode ) ;
164
// While looping through the path, we'll be saving references to
165
// parent elements if the range is in one of their boundaries. In
166
// this way, we are able to create a copy of those elements when
167
// removing a style if the range is in a boundary limit (see #1270).
168
var boundaryElements = [] ;
170
// Check if the range is in the boundary limits of an element
171
// (related to #1270).
172
var isBoundaryRight = !FCKDomTools.GetNextSibling( bookmarkStart ) ;
173
var isBoundary = isBoundaryRight || !FCKDomTools.GetPreviousSibling( bookmarkStart ) ;
175
// This is the last element to be removed in the boundary situation
176
// described at #1270.
177
var lastBoundaryElement ;
178
var boundaryLimitIndex = -1 ;
180
for ( var i = 0 ; i < path.Elements.length ; i++ )
182
var pathElement = path.Elements[i] ;
183
if ( this.CheckElementRemovable( pathElement ) )
186
&& !FCKDomTools.CheckIsEmptyElement( pathElement,
189
return ( el != bookmarkStart ) ;
193
lastBoundaryElement = pathElement ;
195
// We'll be continuously including elements in the
196
// boundaryElements array, but only those added before
197
// setting lastBoundaryElement must be used later, so
198
// let's mark the current index here.
199
boundaryLimitIndex = boundaryElements.length - 1 ;
203
var pathElementName = pathElement.nodeName.toLowerCase() ;
205
if ( pathElementName == this.Element )
207
// Remove any attribute that conflict with this style, no
208
// matter their values.
209
for ( var att in styleAttribs )
211
if ( FCKDomTools.HasAttribute( pathElement, att ) )
216
this._RemoveStylesFromElement( pathElement ) ;
220
// The 'class' element value must match (#1318).
221
if ( FCKDomTools.GetAttributeValue( pathElement, att ) != this.GetFinalAttributeValue( att ) )
227
FCKDomTools.RemoveAttribute( pathElement, att ) ;
233
// Remove overrides defined to the same element name.
234
this._RemoveOverrides( pathElement, styleOverrides[ pathElementName ] ) ;
236
// Remove the element if no more attributes are available and it's an inline style element
237
if ( this.GetType() == FCK_STYLE_INLINE)
238
this._RemoveNoAttribElement( pathElement ) ;
241
else if ( isBoundary )
242
boundaryElements.push( pathElement ) ;
244
// Check if we are still in a boundary (at the same side).
245
isBoundary = isBoundary && ( ( isBoundaryRight && !FCKDomTools.GetNextSibling( pathElement ) ) || ( !isBoundaryRight && !FCKDomTools.GetPreviousSibling( pathElement ) ) ) ;
247
// If we are in an element that is not anymore a boundary, or
248
// we are at the last element, let's move things outside the
249
// boundary (if available).
250
if ( lastBoundaryElement && ( !isBoundary || ( i == path.Elements.length - 1 ) ) )
252
// Remove the bookmark node from the DOM.
253
var currentElement = FCKDomTools.RemoveNode( bookmarkStart ) ;
255
// Build the collapsed group of elements that are not
256
// removed by this style, but share the boundary.
257
// (see comment 1 and 2 at #1270)
258
for ( var j = 0 ; j <= boundaryLimitIndex ; j++ )
260
var newElement = FCKDomTools.CloneElement( boundaryElements[j] ) ;
261
newElement.appendChild( currentElement ) ;
262
currentElement = newElement ;
265
// Re-insert the bookmark node (and the collapsed elements)
266
// in the DOM, in the new position next to the styled element.
267
if ( isBoundaryRight )
268
FCKDomTools.InsertAfterNode( lastBoundaryElement, currentElement ) ;
270
lastBoundaryElement.parentNode.insertBefore( currentElement, lastBoundaryElement ) ;
273
lastBoundaryElement = null ;
277
// Re-select the original range.
279
range.SelectBookmark( bookmark ) ;
282
range.MoveToBookmark( bookmark ) ;
287
// Expand the range, if inside inline element boundaries.
288
range.Expand( 'inline_elements' ) ;
290
// Bookmark the range so we can re-select it after processing.
291
bookmark = range.CreateBookmark( true ) ;
293
// The style will be applied within the bookmark boundaries.
294
var startNode = range.GetBookmarkNode( bookmark, true ) ;
295
var endNode = range.GetBookmarkNode( bookmark, false ) ;
297
range.Release( true ) ;
299
// We need to check the selection boundaries (bookmark spans) to break
300
// the code in a way that we can properly remove partially selected nodes.
301
// For example, removing a <b> style from
302
// <b>This is [some text</b> to show <b>the] problem</b>
303
// ... where [ and ] represent the selection, must result:
304
// <b>This is </b>[some text to show the]<b> problem</b>
305
// The strategy is simple, we just break the partial nodes before the
306
// removal logic, having something that could be represented this way:
307
// <b>This is </b>[<b>some text</b> to show <b>the</b>]<b> problem</b>
309
// Let's start checking the start boundary.
310
var path = new FCKElementPath( startNode ) ;
311
var pathElements = path.Elements ;
314
for ( var i = 1 ; i < pathElements.length ; i++ )
316
pathElement = pathElements[i] ;
318
if ( pathElement == path.Block || pathElement == path.BlockLimit )
321
// If this element can be removed (even partially).
322
if ( this.CheckElementRemovable( pathElement ) )
323
FCKDomTools.BreakParent( startNode, pathElement, range ) ;
326
// Now the end boundary.
327
path = new FCKElementPath( endNode ) ;
328
pathElements = path.Elements ;
330
for ( var i = 1 ; i < pathElements.length ; i++ )
332
pathElement = pathElements[i] ;
334
if ( pathElement == path.Block || pathElement == path.BlockLimit )
337
elementName = pathElement.nodeName.toLowerCase() ;
339
// If this element can be removed (even partially).
340
if ( this.CheckElementRemovable( pathElement ) )
341
FCKDomTools.BreakParent( endNode, pathElement, range ) ;
344
// Navigate through all nodes between the bookmarks.
345
var currentNode = FCKDomTools.GetNextSourceNode( startNode, true ) ;
347
while ( currentNode )
349
// Cache the next node to be processed. Do it now, because
350
// currentNode may be removed.
351
var nextNode = FCKDomTools.GetNextSourceNode( currentNode ) ;
353
// Remove elements nodes that match with this style rules.
354
if ( currentNode.nodeType == 1 )
356
var elementName = currentNode.nodeName.toLowerCase() ;
358
var mayRemove = ( elementName == this.Element ) ;
361
// Remove any attribute that conflict with this style, no matter
363
for ( var att in styleAttribs )
365
if ( FCKDomTools.HasAttribute( currentNode, att ) )
370
this._RemoveStylesFromElement( currentNode ) ;
374
// The 'class' element value must match (#1318).
375
if ( FCKDomTools.GetAttributeValue( currentNode, att ) != this.GetFinalAttributeValue( att ) )
381
FCKDomTools.RemoveAttribute( currentNode, att ) ;
387
mayRemove = !!styleOverrides[ elementName ] ;
391
// Remove overrides defined to the same element name.
392
this._RemoveOverrides( currentNode, styleOverrides[ elementName ] ) ;
394
// Remove the element if no more attributes are available.
395
this._RemoveNoAttribElement( currentNode ) ;
399
// If we have reached the end of the selection, stop looping.
400
if ( nextNode == endNode )
403
currentNode = nextNode ;
406
this._FixBookmarkStart( startNode ) ;
408
// Re-select the original range.
410
range.SelectBookmark( bookmark ) ;
413
range.MoveToBookmark( bookmark ) ;
417
* Checks if an element, or any of its attributes, is removable by the
418
* current style definition.
420
CheckElementRemovable : function( element, fullMatch )
425
var elementName = element.nodeName.toLowerCase() ;
427
// If the element name is the same as the style name.
428
if ( elementName == this.Element )
430
// If no attributes are defined in the element.
431
if ( !fullMatch && !FCKDomTools.HasAttributes( element ) )
434
// If any attribute conflicts with the style attributes.
435
var attribs = this._GetAttribsForComparison() ;
436
var allMatched = ( attribs._length == 0 ) ;
437
for ( var att in attribs )
439
if ( att == '_length' )
442
if ( this._CompareAttributeValues( att, FCKDomTools.GetAttributeValue( element, att ), ( this.GetFinalAttributeValue( att ) || '' ) ) )
459
// Check if the element can be somehow overriden.
460
var override = this._GetOverridesForComparison()[ elementName ] ;
463
// If no attributes have been defined, remove the element.
464
if ( !( attribs = override.Attributes ) ) // Only one "="
467
for ( var i = 0 ; i < attribs.length ; i++ )
469
var attName = attribs[i][0] ;
470
if ( FCKDomTools.HasAttribute( element, attName ) )
472
var attValue = attribs[i][1] ;
474
// Remove the attribute if:
475
// - The override definition value is null ;
476
// - The override definition valie is a string that
477
// matches the attribute value exactly.
478
// - The override definition value is a regex that
479
// has matches in the attribute value.
480
if ( attValue == null ||
481
( typeof attValue == 'string' && FCKDomTools.GetAttributeValue( element, attName ) == attValue ) ||
482
attValue.test( FCKDomTools.GetAttributeValue( element, attName ) ) )
492
* Get the style state for an element path. Returns "true" if the element
493
* is active in the path.
495
CheckActive : function( elementPath )
497
switch ( this.GetType() )
499
case FCK_STYLE_BLOCK :
500
return this.CheckElementRemovable( elementPath.Block || elementPath.BlockLimit, true ) ;
502
case FCK_STYLE_INLINE :
504
var elements = elementPath.Elements ;
506
for ( var i = 0 ; i < elements.length ; i++ )
508
var element = elements[i] ;
510
if ( element == elementPath.Block || element == elementPath.BlockLimit )
513
if ( this.CheckElementRemovable( element, true ) )
521
* Removes an inline style from inside an element tree. The element node
522
* itself is not checked or removed, only the child tree inside of it.
524
RemoveFromElement : function( element )
526
var attribs = this._GetAttribsForComparison() ;
527
var overrides = this._GetOverridesForComparison() ;
529
// Get all elements with the same name.
530
var innerElements = element.getElementsByTagName( this.Element ) ;
532
for ( var i = innerElements.length - 1 ; i >= 0 ; i-- )
534
var innerElement = innerElements[i] ;
536
// Remove any attribute that conflict with this style, no matter
538
for ( var att in attribs )
540
if ( FCKDomTools.HasAttribute( innerElement, att ) )
545
this._RemoveStylesFromElement( innerElement ) ;
549
// The 'class' element value must match (#1318).
550
if ( FCKDomTools.GetAttributeValue( innerElement, att ) != this.GetFinalAttributeValue( att ) )
556
FCKDomTools.RemoveAttribute( innerElement, att ) ;
561
// Remove overrides defined to the same element name.
562
this._RemoveOverrides( innerElement, overrides[ this.Element ] ) ;
564
// Remove the element if no more attributes are available.
565
this._RemoveNoAttribElement( innerElement ) ;
568
// Now remove any other element with different name that is
569
// defined to be overriden.
570
for ( var overrideElement in overrides )
572
if ( overrideElement != this.Element )
575
innerElements = element.getElementsByTagName( overrideElement ) ;
577
for ( var i = innerElements.length - 1 ; i >= 0 ; i-- )
579
var innerElement = innerElements[i] ;
580
this._RemoveOverrides( innerElement, overrides[ overrideElement ] ) ;
581
this._RemoveNoAttribElement( innerElement ) ;
587
_RemoveStylesFromElement : function( element )
589
var elementStyle = element.style.cssText ;
590
var pattern = this.GetFinalStyleValue() ;
592
if ( elementStyle.length > 0 && pattern.length == 0 )
595
pattern = '(^|;)\\s*(' +
596
pattern.replace( /\s*([^ ]+):.*?(;|$)/g, '$1|' ).replace( /\|$/, '' ) +
599
var regex = new RegExp( pattern, 'gi' ) ;
601
elementStyle = elementStyle.replace( regex, '' ).Trim() ;
603
if ( elementStyle.length == 0 || elementStyle == ';' )
604
FCKDomTools.RemoveAttribute( element, 'style' ) ;
606
element.style.cssText = elementStyle.replace( regex, '' ) ;
610
* Remove all attributes that are defined to be overriden,
612
_RemoveOverrides : function( element, override )
614
var attributes = override && override.Attributes ;
618
for ( var i = 0 ; i < attributes.length ; i++ )
620
var attName = attributes[i][0] ;
622
if ( FCKDomTools.HasAttribute( element, attName ) )
624
var attValue = attributes[i][1] ;
626
// Remove the attribute if:
627
// - The override definition value is null ;
628
// - The override definition valie is a string that
629
// matches the attribute value exactly.
630
// - The override definition value is a regex that
631
// has matches in the attribute value.
632
if ( attValue == null ||
633
( attValue.test && attValue.test( FCKDomTools.GetAttributeValue( element, attName ) ) ) ||
634
( typeof attValue == 'string' && FCKDomTools.GetAttributeValue( element, attName ) == attValue ) )
635
FCKDomTools.RemoveAttribute( element, attName ) ;
642
* If the element has no more attributes, remove it.
644
_RemoveNoAttribElement : function( element )
646
// If no more attributes remained in the element, remove it,
647
// leaving its children.
648
if ( !FCKDomTools.HasAttributes( element ) )
650
// Removing elements may open points where merging is possible,
651
// so let's cache the first and last nodes for later checking.
652
var firstChild = element.firstChild ;
653
var lastChild = element.lastChild ;
655
FCKDomTools.RemoveNode( element, true ) ;
657
// Check the cached nodes for merging.
658
this._MergeSiblings( firstChild ) ;
660
if ( firstChild != lastChild )
661
this._MergeSiblings( lastChild ) ;
666
* Creates a DOM element for this style object.
668
BuildElement : function( targetDoc, element )
670
// Create the element.
671
var el = element || targetDoc.createElement( this.Element ) ;
673
// Assign all defined attributes.
674
var attribs = this._StyleDesc.Attributes ;
678
for ( var att in attribs )
680
attValue = this.GetFinalAttributeValue( att ) ;
682
if ( att.toLowerCase() == 'class' )
683
el.className = attValue ;
685
el.setAttribute( att, attValue ) ;
689
// Assign the style attribute.
690
if ( this._GetStyleText().length > 0 )
691
el.style.cssText = this.GetFinalStyleValue() ;
696
_CompareAttributeValues : function( attName, valueA, valueB )
698
if ( attName == 'style' && valueA && valueB )
700
valueA = valueA.replace( /;$/, '' ).toLowerCase() ;
701
valueB = valueB.replace( /;$/, '' ).toLowerCase() ;
704
// Return true if they match or if valueA is null and valueB is an empty string
705
return ( valueA == valueB || ( ( valueA === null || valueA === '' ) && ( valueB === null || valueB === '' ) ) )
708
GetFinalAttributeValue : function( attName )
710
var attValue = this._StyleDesc.Attributes ;
711
var attValue = attValue ? attValue[ attName ] : null ;
713
if ( !attValue && attName == 'style' )
714
return this.GetFinalStyleValue() ;
716
if ( attValue && this._Variables )
717
// Using custom Replace() to guarantee the correct scope.
718
attValue = attValue.Replace( FCKRegexLib.StyleVariableAttName, this._GetVariableReplace, this ) ;
723
GetFinalStyleValue : function()
725
var attValue = this._GetStyleText() ;
727
if ( attValue.length > 0 && this._Variables )
729
// Using custom Replace() to guarantee the correct scope.
730
attValue = attValue.Replace( FCKRegexLib.StyleVariableAttName, this._GetVariableReplace, this ) ;
731
attValue = FCKTools.NormalizeCssText( attValue ) ;
737
_GetVariableReplace : function()
739
// The second group in the regex is the variable name.
740
return this._Variables[ arguments[2] ] || arguments[0] ;
744
* Set the value of a variable attribute or style, to be used when
745
* appliying the style.
747
SetVariable : function( name, value )
749
var variables = this._Variables ;
752
variables = this._Variables = {} ;
754
this._Variables[ name ] = value ;
758
* Converting from a PRE block to a non-PRE block in formatting operations.
760
_FromPre : function( doc, block, newBlock )
762
var innerHTML = block.innerHTML ;
764
// Trim the first and last linebreaks immediately after and before <pre>, </pre>,
766
// This is done because the linebreaks are not rendered.
767
innerHTML = innerHTML.replace( /(\r\n|\r)/g, '\n' ) ;
768
innerHTML = innerHTML.replace( /^[ \t]*\n/, '' ) ;
769
innerHTML = innerHTML.replace( /\n$/, '' ) ;
771
// 1. Convert spaces or tabs at the beginning or at the end to
772
innerHTML = innerHTML.replace( /^[ \t]+|[ \t]+$/g, function( match, offset, s )
774
if ( match.length == 1 ) // one space, preserve it
776
else if ( offset == 0 ) // beginning of block
777
return new Array( match.length ).join( ' ' ) + ' ' ;
779
return ' ' + new Array( match.length ).join( ' ' ) ;
782
// 2. Convert \n to <BR>.
783
// 3. Convert contiguous (i.e. non-singular) spaces or tabs to
784
var htmlIterator = new FCKHtmlIterator( innerHTML ) ;
786
htmlIterator.Each( function( isTag, value )
790
value = value.replace( /\n/g, '<br>' ) ;
791
value = value.replace( /[ \t]{2,}/g,
794
return new Array( match.length ).join( ' ' ) + ' ' ;
797
results.push( value ) ;
799
newBlock.innerHTML = results.join( '' ) ;
804
* Converting from a non-PRE block to a PRE block in formatting operations.
806
_ToPre : function( doc, block, newBlock )
808
// Handle converting from a regular block to a <pre> block.
809
var innerHTML = block.innerHTML.Trim() ;
811
// 1. Delete ANSI whitespaces immediately before and after <BR> because
812
// they are not visible.
813
// 2. Mark down any <BR /> nodes here so they can be turned into \n in
814
// the next step and avoid being compressed.
815
innerHTML = innerHTML.replace( /[ \t\r\n]*(<br[^>]*>)[ \t\r\n]*/gi, '<br />' ) ;
817
// 3. Compress other ANSI whitespaces since they're only visible as one
818
// single space previously.
819
// 4. Convert to spaces since is no longer needed in <PRE>.
820
// 5. Convert any <BR /> to \n. This must not be done earlier because
821
// the \n would then get compressed.
822
var htmlIterator = new FCKHtmlIterator( innerHTML ) ;
824
htmlIterator.Each( function( isTag, value )
827
value = value.replace( /([ \t\n\r]+| )/g, ' ' ) ;
828
else if ( isTag && value == '<br />' )
830
results.push( value ) ;
833
// Assigning innerHTML to <PRE> in IE causes all linebreaks to be
834
// reduced to spaces.
835
// Assigning outerHTML to <PRE> in IE doesn't work if the <PRE> isn't
836
// contained in another node since the node reference is changed after
837
// outerHTML assignment.
838
// So, we need some hacks to workaround IE bugs here.
839
if ( FCKBrowserInfo.IsIE )
841
var temp = doc.createElement( 'div' ) ;
842
temp.appendChild( newBlock ) ;
843
newBlock.outerHTML = '<pre>\n' + results.join( '' ) + '</pre>' ;
844
newBlock = temp.removeChild( temp.firstChild ) ;
847
newBlock.innerHTML = results.join( '' ) ;
853
* Merge a <pre> block with a previous <pre> block, if available.
855
_CheckAndMergePre : function( previousBlock, preBlock )
857
// Check if the previous block and the current block are next
859
if ( previousBlock != FCKDomTools.GetPreviousSourceElement( preBlock, true ) )
862
// Merge the previous <pre> block contents into the current <pre>
865
// Another thing to be careful here is that currentBlock might contain
866
// a '\n' at the beginning, and previousBlock might contain a '\n'
867
// towards the end. These new lines are not normally displayed but they
868
// become visible after merging.
869
var innerHTML = previousBlock.innerHTML.replace( /\n$/, '' ) + '\n\n' +
870
preBlock.innerHTML.replace( /^\n/, '' ) ;
872
// Buggy IE normalizes innerHTML from <pre>, breaking whitespaces.
873
if ( FCKBrowserInfo.IsIE )
874
preBlock.outerHTML = '<pre>' + innerHTML + '</pre>' ;
876
preBlock.innerHTML = innerHTML ;
878
// Remove the previous <pre> block.
880
// The preBlock must not be moved or deleted from the DOM tree. This
881
// guarantees the FCKDomRangeIterator in _ApplyBlockStyle would not
882
// get lost at the next iteration.
883
FCKDomTools.RemoveNode( previousBlock ) ;
886
_CheckAndSplitPre : function( newBlock )
890
var cursor = newBlock.firstChild ;
892
// We are not splitting <br><br> at the beginning of the block, so
893
// we'll start from the second child.
894
cursor = cursor && cursor.nextSibling ;
898
var next = cursor.nextSibling ;
900
// If we have two <BR>s, and they're not at the beginning or the end,
901
// then we'll split up the contents following them into another block.
902
// Stop processing if we are at the last child couple.
903
if ( next && next.nextSibling && cursor.nodeName.IEquals( 'br' ) && next.nodeName.IEquals( 'br' ) )
905
// Remove the first <br>.
906
FCKDomTools.RemoveNode( cursor ) ;
908
// Move to the node after the second <br>.
909
cursor = next.nextSibling ;
911
// Remove the second <br>.
912
FCKDomTools.RemoveNode( next ) ;
914
// Create the block that will hold the child nodes from now on.
915
lastNewBlock = FCKDomTools.InsertAfterNode( lastNewBlock || newBlock, FCKDomTools.CloneElement( newBlock ) ) ;
920
// If we split it, then start moving the nodes to the new block.
923
cursor = cursor.previousSibling ;
924
FCKDomTools.MoveNode(cursor.nextSibling, lastNewBlock ) ;
927
cursor = cursor.nextSibling ;
932
* Apply an inline style to a FCKDomRange.
935
* - Implement the "#" style handling.
936
* - Properly handle block containers like <div> and <blockquote>.
938
_ApplyBlockStyle : function( range, selectIt, updateRange )
940
// Bookmark the range so we can re-select it after processing.
944
bookmark = range.CreateBookmark() ;
946
var iterator = new FCKDomRangeIterator( range ) ;
947
iterator.EnforceRealBlocks = true ;
950
var doc = range.Window.document ;
951
var previousPreBlock ;
953
while( ( block = iterator.GetNextParagraph() ) ) // Only one =
955
// Create the new node right before the current one.
956
var newBlock = this.BuildElement( doc ) ;
958
// Check if we are changing from/to <pre>.
959
var newBlockIsPre = newBlock.nodeName.IEquals( 'pre' ) ;
960
var blockIsPre = block.nodeName.IEquals( 'pre' ) ;
962
var toPre = newBlockIsPre && !blockIsPre ;
963
var fromPre = !newBlockIsPre && blockIsPre ;
965
// Move everything from the current node to the new one.
967
newBlock = this._ToPre( doc, block, newBlock ) ;
969
newBlock = this._FromPre( doc, block, newBlock ) ;
970
else // Convering from a regular block to another regular block.
971
FCKDomTools.MoveChildren( block, newBlock ) ;
973
// Replace the current block.
974
block.parentNode.insertBefore( newBlock, block ) ;
975
FCKDomTools.RemoveNode( block ) ;
977
// Complete other tasks after inserting the node in the DOM.
980
if ( previousPreBlock )
981
this._CheckAndMergePre( previousPreBlock, newBlock ) ; // Merge successive <pre> blocks.
982
previousPreBlock = newBlock ;
985
this._CheckAndSplitPre( newBlock ) ; // Split <br><br> in successive <pre>s.
988
// Re-select the original range.
990
range.SelectBookmark( bookmark ) ;
993
range.MoveToBookmark( bookmark ) ;
997
* Apply an inline style to a FCKDomRange.
1000
* - Merge elements, when applying styles to similar elements that enclose
1001
* the entire selection, outputing:
1002
* <span style="color: #ff0000; background-color: #ffffff">XYZ</span>
1004
* <span style="color: #ff0000;"><span style="background-color: #ffffff">XYZ</span></span>
1006
_ApplyInlineStyle : function( range, selectIt, updateRange )
1008
var doc = range.Window.document ;
1010
if ( range.CheckIsCollapsed() )
1012
// Create the element to be inserted in the DOM.
1013
var collapsedElement = this.BuildElement( doc ) ;
1014
range.InsertNode( collapsedElement ) ;
1015
range.MoveToPosition( collapsedElement, 2 ) ;
1021
// The general idea here is navigating through all nodes inside the
1022
// current selection, working on distinct range blocks, defined by the
1023
// DTD compatibility between the style element and the nodes inside the
1026
// For example, suppose we have the following selection (where [ and ]
1027
// are the boundaries), and we apply a <b> style there:
1029
// <p>Here we [have <b>some</b> text.<p>
1030
// <p>And some here] here.</p>
1032
// Two different ranges will be detected:
1034
// "have <b>some</b> text."
1037
// Both ranges will be extracted, moved to a <b> element, and
1038
// re-inserted, resulting in the following output:
1040
// <p>Here we [<b>have some text.</b><p>
1041
// <p><b>And some here</b>] here.</p>
1043
// Note that the <b> element at <b>some</b> is also removed because it
1044
// is not needed anymore.
1046
var elementName = this.Element ;
1048
// Get the DTD definition for the element. Defaults to "span".
1049
var elementDTD = FCK.DTD[ elementName ] || FCK.DTD.span ;
1051
// Create the attribute list to be used later for element comparisons.
1052
var styleAttribs = this._GetAttribsForComparison() ;
1055
// Expand the range, if inside inline element boundaries.
1056
range.Expand( 'inline_elements' ) ;
1058
// Bookmark the range so we can re-select it after processing.
1059
var bookmark = range.CreateBookmark( true ) ;
1061
// The style will be applied within the bookmark boundaries.
1062
var startNode = range.GetBookmarkNode( bookmark, true ) ;
1063
var endNode = range.GetBookmarkNode( bookmark, false ) ;
1065
// We'll be reusing the range to apply the styles. So, release it here
1066
// to indicate that it has not been initialized.
1067
range.Release( true ) ;
1069
// Let's start the nodes lookup from the node right after the bookmark
1071
var currentNode = FCKDomTools.GetNextSourceNode( startNode, true ) ;
1073
while ( currentNode )
1075
var applyStyle = false ;
1077
var nodeType = currentNode.nodeType ;
1078
var nodeName = nodeType == 1 ? currentNode.nodeName.toLowerCase() : null ;
1080
// Check if the current node can be a child of the style element.
1081
if ( !nodeName || elementDTD[ nodeName ] )
1083
// Check if the style element can be a child of the current
1084
// node parent or if the element is not defined in the DTD.
1085
if ( ( FCK.DTD[ currentNode.parentNode.nodeName.toLowerCase() ] || FCK.DTD.span )[ elementName ] || !FCK.DTD[ elementName ] )
1087
// This node will be part of our range, so if it has not
1088
// been started, place its start right before the node.
1089
if ( !range.CheckHasRange() )
1090
range.SetStart( currentNode, 3 ) ;
1092
// Non element nodes, or empty elements can be added
1093
// completely to the range.
1094
if ( nodeType != 1 || currentNode.childNodes.length == 0 )
1096
var includedNode = currentNode ;
1097
var parentNode = includedNode.parentNode ;
1099
// This node is about to be included completelly, but,
1100
// if this is the last node in its parent, we must also
1101
// check if the parent itself can be added completelly
1103
while ( includedNode == parentNode.lastChild
1104
&& elementDTD[ parentNode.nodeName.toLowerCase() ] )
1106
includedNode = parentNode ;
1109
range.SetEnd( includedNode, 4 ) ;
1111
// If the included node is the last node in its parent
1112
// and its parent can't be inside the style node, apply
1113
// the style immediately.
1114
if ( includedNode == includedNode.parentNode.lastChild && !elementDTD[ includedNode.parentNode.nodeName.toLowerCase() ] )
1119
// Element nodes will not be added directly. We need to
1120
// check their children because the selection could end
1121
// inside the node, so let's place the range end right
1122
// before the element.
1123
range.SetEnd( currentNode, 3 ) ;
1132
// Get the next node to be processed.
1133
currentNode = FCKDomTools.GetNextSourceNode( currentNode ) ;
1135
// If we have reached the end of the selection, just apply the
1136
// style ot the range, and stop looping.
1137
if ( currentNode == endNode )
1139
currentNode = null ;
1143
// Apply the style if we have something to which apply it.
1144
if ( applyStyle && range.CheckHasRange() && !range.CheckIsCollapsed() )
1146
// Build the style element, based on the style object definition.
1147
styleNode = this.BuildElement( doc ) ;
1149
// Move the contents of the range to the style element.
1150
range.ExtractContents().AppendTo( styleNode ) ;
1152
// If it is not empty.
1153
if ( styleNode.innerHTML.RTrim().length > 0 )
1155
// Insert it in the range position (it is collapsed after
1157
range.InsertNode( styleNode ) ;
1159
// Here we do some cleanup, removing all duplicated
1160
// elements from the style element.
1161
this.RemoveFromElement( styleNode ) ;
1163
// Let's merge our new style with its neighbors, if possible.
1164
this._MergeSiblings( styleNode, this._GetAttribsForComparison() ) ;
1166
// As the style system breaks text nodes constantly, let's normalize
1167
// things for performance.
1168
// With IE, some paragraphs get broken when calling normalize()
1169
// repeatedly. Also, for IE, we must normalize body, not documentElement.
1170
// IE is also known for having a "crash effect" with normalize().
1171
// We should try to normalize with IE too in some way, somewhere.
1172
if ( !FCKBrowserInfo.IsIE )
1173
styleNode.normalize() ;
1176
// Style applied, let's release the range, so it gets marked to
1177
// re-initialization in the next loop.
1178
range.Release( true ) ;
1182
this._FixBookmarkStart( startNode ) ;
1184
// Re-select the original range.
1186
range.SelectBookmark( bookmark ) ;
1189
range.MoveToBookmark( bookmark ) ;
1192
_FixBookmarkStart : function( startNode )
1194
// After appliying or removing an inline style, the start boundary of
1195
// the selection must be placed inside all inline elements it is
1198
while ( ( startSibling = startNode.nextSibling ) ) // Only one "=".
1200
if ( startSibling.nodeType == 1
1201
&& FCKListsLib.InlineNonEmptyElements[ startSibling.nodeName.toLowerCase() ] )
1203
// If it is an empty inline element, we can safely remove it.
1204
if ( !startSibling.firstChild )
1205
FCKDomTools.RemoveNode( startSibling ) ;
1207
FCKDomTools.MoveNode( startNode, startSibling, true ) ;
1211
// Empty text nodes can be safely removed to not disturb.
1212
if ( startSibling.nodeType == 3 && startSibling.length == 0 )
1214
FCKDomTools.RemoveNode( startSibling ) ;
1223
* Merge an element with its similar siblings.
1224
* "attribs" is and object computed with _CreateAttribsForComparison.
1226
_MergeSiblings : function( element, attribs )
1228
if ( !element || element.nodeType != 1 || !FCKListsLib.InlineNonEmptyElements[ element.nodeName.toLowerCase() ] )
1231
this._MergeNextSibling( element, attribs ) ;
1232
this._MergePreviousSibling( element, attribs ) ;
1236
* Merge an element with its similar siblings after it.
1237
* "attribs" is and object computed with _CreateAttribsForComparison.
1239
_MergeNextSibling : function( element, attribs )
1241
// Check the next sibling.
1242
var sibling = element.nextSibling ;
1244
// Check if the next sibling is a bookmark element. In this case, jump it.
1245
var hasBookmark = ( sibling && sibling.nodeType == 1 && sibling.getAttribute( '_fck_bookmark' ) ) ;
1247
sibling = sibling.nextSibling ;
1249
if ( sibling && sibling.nodeType == 1 && sibling.nodeName == element.nodeName )
1252
attribs = this._CreateElementAttribsForComparison( element ) ;
1254
if ( this._CheckAttributesMatch( sibling, attribs ) )
1256
// Save the last child to be checked too (to merge things like <b><i></i></b><b><i></i></b>).
1257
var innerSibling = element.lastChild ;
1260
FCKDomTools.MoveNode( element.nextSibling, element ) ;
1262
// Move contents from the sibling.
1263
FCKDomTools.MoveChildren( sibling, element ) ;
1264
FCKDomTools.RemoveNode( sibling ) ;
1266
// Now check the last inner child (see two comments above).
1268
this._MergeNextSibling( innerSibling ) ;
1274
* Merge an element with its similar siblings before it.
1275
* "attribs" is and object computed with _CreateAttribsForComparison.
1277
_MergePreviousSibling : function( element, attribs )
1279
// Check the previous sibling.
1280
var sibling = element.previousSibling ;
1282
// Check if the previous sibling is a bookmark element. In this case, jump it.
1283
var hasBookmark = ( sibling && sibling.nodeType == 1 && sibling.getAttribute( '_fck_bookmark' ) ) ;
1285
sibling = sibling.previousSibling ;
1287
if ( sibling && sibling.nodeType == 1 && sibling.nodeName == element.nodeName )
1290
attribs = this._CreateElementAttribsForComparison( element ) ;
1292
if ( this._CheckAttributesMatch( sibling, attribs ) )
1294
// Save the first child to be checked too (to merge things like <b><i></i></b><b><i></i></b>).
1295
var innerSibling = element.firstChild ;
1298
FCKDomTools.MoveNode( element.previousSibling, element, true ) ;
1300
// Move contents to the sibling.
1301
FCKDomTools.MoveChildren( sibling, element, true ) ;
1302
FCKDomTools.RemoveNode( sibling ) ;
1304
// Now check the first inner child (see two comments above).
1306
this._MergePreviousSibling( innerSibling ) ;
1312
* Build the cssText based on the styles definition.
1314
_GetStyleText : function()
1316
var stylesDef = this._StyleDesc.Styles ;
1318
// Builds the StyleText.
1319
var stylesText = ( this._StyleDesc.Attributes ? this._StyleDesc.Attributes['style'] || '' : '' ) ;
1321
if ( stylesText.length > 0 )
1324
for ( var style in stylesDef )
1325
stylesText += style + ':' + stylesDef[style] + ';' ;
1327
// Browsers make some changes to the style when applying them. So, here
1328
// we normalize it to the browser format. We'll not do that if there
1329
// are variables inside the style.
1330
if ( stylesText.length > 0 && !( /#\(/.test( stylesText ) ) )
1332
stylesText = FCKTools.NormalizeCssText( stylesText ) ;
1335
return (this._GetStyleText = function() { return stylesText ; })() ;
1339
* Get the the collection used to compare the attributes defined in this
1340
* style with attributes in an element. All information in it is lowercased.
1342
_GetAttribsForComparison : function()
1344
// If we have already computed it, just return it.
1345
var attribs = this._GetAttribsForComparison_$ ;
1349
attribs = new Object() ;
1351
// Loop through all defined attributes.
1352
var styleAttribs = this._StyleDesc.Attributes ;
1355
for ( var styleAtt in styleAttribs )
1357
attribs[ styleAtt.toLowerCase() ] = styleAttribs[ styleAtt ].toLowerCase() ;
1361
// Includes the style definitions.
1362
if ( this._GetStyleText().length > 0 )
1364
attribs['style'] = this._GetStyleText().toLowerCase() ;
1367
// Appends the "length" information to the object.
1368
FCKTools.AppendLengthProperty( attribs, '_length' ) ;
1370
// Return it, saving it to the next request.
1371
return ( this._GetAttribsForComparison_$ = attribs ) ;
1375
* Get the the collection used to compare the elements and attributes,
1376
* defined in this style overrides, with other element. All information in
1379
_GetOverridesForComparison : function()
1381
// If we have already computed it, just return it.
1382
var overrides = this._GetOverridesForComparison_$ ;
1386
overrides = new Object() ;
1388
var overridesDesc = this._StyleDesc.Overrides ;
1390
if ( overridesDesc )
1392
// The override description can be a string, object or array.
1393
// Internally, well handle arrays only, so transform it if needed.
1394
if ( !FCKTools.IsArray( overridesDesc ) )
1395
overridesDesc = [ overridesDesc ] ;
1397
// Loop through all override definitions.
1398
for ( var i = 0 ; i < overridesDesc.length ; i++ )
1400
var override = overridesDesc[i] ;
1405
// If can be a string with the element name.
1406
if ( typeof override == 'string' )
1407
elementName = override.toLowerCase() ;
1411
elementName = override.Element ? override.Element.toLowerCase() : this.Element ;
1412
attrs = override.Attributes ;
1415
// We can have more than one override definition for the same
1416
// element name, so we attempt to simply append information to
1417
// it if it already exists.
1418
overrideEl = overrides[ elementName ] || ( overrides[ elementName ] = {} ) ;
1422
// The returning attributes list is an array, because we
1423
// could have different override definitions for the same
1425
var overrideAttrs = ( overrideEl.Attributes = overrideEl.Attributes || new Array() ) ;
1426
for ( var attName in attrs )
1428
// Each item in the attributes array is also an array,
1429
// where [0] is the attribute name and [1] is the
1431
overrideAttrs.push( [ attName.toLowerCase(), attrs[ attName ] ] ) ;
1437
return ( this._GetOverridesForComparison_$ = overrides ) ;
1441
* Create and object containing all attributes specified in an element,
1442
* added by a "_length" property. All values are lowercased.
1444
_CreateElementAttribsForComparison : function( element )
1446
var attribs = new Object() ;
1447
var attribsCount = 0 ;
1449
for ( var i = 0 ; i < element.attributes.length ; i++ )
1451
var att = element.attributes[i] ;
1453
if ( att.specified )
1455
attribs[ att.nodeName.toLowerCase() ] = FCKDomTools.GetAttributeValue( element, att ).toLowerCase() ;
1460
attribs._length = attribsCount ;
1466
* Checks is the element attributes have a perfect match with the style
1469
_CheckAttributesMatch : function( element, styleAttribs )
1471
// Loop through all specified attributes. The same number of
1472
// attributes must be found and their values must match to
1473
// declare them as equal.
1475
var elementAttrbs = element.attributes ;
1476
var matchCount = 0 ;
1478
for ( var i = 0 ; i < elementAttrbs.length ; i++ )
1480
var att = elementAttrbs[i] ;
1481
if ( att.specified )
1483
var attName = att.nodeName.toLowerCase() ;
1484
var styleAtt = styleAttribs[ attName ] ;
1486
// The attribute is not defined in the style.
1490
// The values are different.
1491
if ( styleAtt != FCKDomTools.GetAttributeValue( element, att ).toLowerCase() )
1498
return ( matchCount == styleAttribs._length ) ;