2 * FCKeditor - The text editor for Internet - http://www.fckeditor.net
\r
3 * Copyright (C) 2003-2009 Frederico Caldeira Knabben
\r
5 * == BEGIN LICENSE ==
\r
7 * Licensed under the terms of any of the following licenses at your
\r
10 * - GNU General Public License Version 2 or later (the "GPL")
\r
11 * http://www.gnu.org/licenses/gpl.html
\r
13 * - GNU Lesser General Public License Version 2.1 or later (the "LGPL")
\r
14 * http://www.gnu.org/licenses/lgpl.html
\r
16 * - Mozilla Public License Version 1.1 or later (the "MPL")
\r
17 * http://www.mozilla.org/MPL/MPL-1.1.html
\r
21 * Handles styles in a give document.
\r
24 var FCKStyles = FCK.Styles =
\r
29 ApplyStyle : function( style )
\r
31 if ( typeof style == 'string' )
\r
32 style = this.GetStyles()[ style ] ;
\r
36 if ( style.GetType() == FCK_STYLE_OBJECT )
\r
37 style.ApplyToObject( FCKSelection.GetSelectedElement() ) ;
\r
39 style.ApplyToSelection( FCK.EditorWindow ) ;
\r
41 FCK.Events.FireEvent( 'OnSelectionChange' ) ;
\r
45 RemoveStyle : function( style )
\r
47 if ( typeof style == 'string' )
\r
48 style = this.GetStyles()[ style ] ;
\r
52 style.RemoveFromSelection( FCK.EditorWindow ) ;
\r
53 FCK.Events.FireEvent( 'OnSelectionChange' ) ;
\r
58 * Defines a callback function to be called when the current state of a
\r
59 * specific style changes.
\r
61 AttachStyleStateChange : function( styleName, callback, callbackOwner )
\r
63 var callbacks = this._Callbacks[ styleName ] ;
\r
66 callbacks = this._Callbacks[ styleName ] = [] ;
\r
68 callbacks.push( [ callback, callbackOwner ] ) ;
\r
71 CheckSelectionChanges : function()
\r
73 var startElement = FCKSelection.GetBoundaryParentElement( true ) ;
\r
75 if ( !startElement )
\r
78 // Walks the start node parents path, checking all styles that are being listened.
\r
79 var path = new FCKElementPath( startElement ) ;
\r
80 var styles = this.GetStyles() ;
\r
82 for ( var styleName in styles )
\r
84 var callbacks = this._Callbacks[ styleName ] ;
\r
88 var style = styles[ styleName ] ;
\r
89 var state = style.CheckActive( path ) ;
\r
91 if ( state != ( style._LastState || null ) )
\r
93 style._LastState = state ;
\r
95 for ( var i = 0 ; i < callbacks.length ; i++ )
\r
97 var callback = callbacks[i][0] ;
\r
98 var callbackOwner = callbacks[i][1] ;
\r
100 callback.call( callbackOwner || window, styleName, state ) ;
\r
107 CheckStyleInSelection : function( styleName )
\r
112 _GetRemoveFormatTagsRegex : function ()
\r
114 var regex = new RegExp( '^(?:' + FCKConfig.RemoveFormatTags.replace( /,/g,'|' ) + ')$', 'i' ) ;
\r
116 return (this._GetRemoveFormatTagsRegex = function()
\r
124 * Remove all styles from the current selection.
\r
126 * - This is almost a duplication of FCKStyle.RemoveFromRange. We should
\r
127 * try to merge things.
\r
129 RemoveAll : function()
\r
131 var range = new FCKDomRange( FCK.EditorWindow ) ;
\r
132 range.MoveToSelection() ;
\r
134 if ( range.CheckIsCollapsed() )
\r
137 // Expand the range, if inside inline element boundaries.
\r
138 range.Expand( 'inline_elements' ) ;
\r
140 // Get the bookmark nodes.
\r
141 // Bookmark the range so we can re-select it after processing.
\r
142 var bookmark = range.CreateBookmark( true ) ;
\r
144 // The style will be applied within the bookmark boundaries.
\r
145 var startNode = range.GetBookmarkNode( bookmark, true ) ;
\r
146 var endNode = range.GetBookmarkNode( bookmark, false ) ;
\r
148 range.Release( true ) ;
\r
150 var tagsRegex = this._GetRemoveFormatTagsRegex() ;
\r
152 // We need to check the selection boundaries (bookmark spans) to break
\r
153 // the code in a way that we can properly remove partially selected nodes.
\r
154 // For example, removing a <b> style from
\r
155 // <b>This is [some text</b> to show <b>the] problem</b>
\r
156 // ... where [ and ] represent the selection, must result:
\r
157 // <b>This is </b>[some text to show the]<b> problem</b>
\r
158 // The strategy is simple, we just break the partial nodes before the
\r
159 // removal logic, having something that could be represented this way:
\r
160 // <b>This is </b>[<b>some text</b> to show <b>the</b>]<b> problem</b>
\r
162 // Let's start checking the start boundary.
\r
163 var path = new FCKElementPath( startNode ) ;
\r
164 var pathElements = path.Elements ;
\r
167 for ( var i = 1 ; i < pathElements.length ; i++ )
\r
169 pathElement = pathElements[i] ;
\r
171 if ( pathElement == path.Block || pathElement == path.BlockLimit )
\r
174 // If this element can be removed (even partially).
\r
175 if ( tagsRegex.test( pathElement.nodeName ) )
\r
176 FCKDomTools.BreakParent( startNode, pathElement, range ) ;
\r
179 // Now the end boundary.
\r
180 path = new FCKElementPath( endNode ) ;
\r
181 pathElements = path.Elements ;
\r
183 for ( var i = 1 ; i < pathElements.length ; i++ )
\r
185 pathElement = pathElements[i] ;
\r
187 if ( pathElement == path.Block || pathElement == path.BlockLimit )
\r
190 elementName = pathElement.nodeName.toLowerCase() ;
\r
192 // If this element can be removed (even partially).
\r
193 if ( tagsRegex.test( pathElement.nodeName ) )
\r
194 FCKDomTools.BreakParent( endNode, pathElement, range ) ;
\r
197 // Navigate through all nodes between the bookmarks.
\r
198 var currentNode = FCKDomTools.GetNextSourceNode( startNode, true, 1 ) ;
\r
200 while ( currentNode )
\r
202 // If we have reached the end of the selection, stop looping.
\r
203 if ( currentNode == endNode )
\r
206 // Cache the next node to be processed. Do it now, because
\r
207 // currentNode may be removed.
\r
208 var nextNode = FCKDomTools.GetNextSourceNode( currentNode, false, 1 ) ;
\r
210 // Remove elements nodes that match with this style rules.
\r
211 if ( tagsRegex.test( currentNode.nodeName ) )
\r
212 FCKDomTools.RemoveNode( currentNode, true ) ;
\r
214 FCKDomTools.RemoveAttributes( currentNode, FCKConfig.RemoveAttributesArray );
\r
216 currentNode = nextNode ;
\r
219 range.SelectBookmark( bookmark ) ;
\r
221 FCK.Events.FireEvent( 'OnSelectionChange' ) ;
\r
224 GetStyle : function( styleName )
\r
226 return this.GetStyles()[ styleName ] ;
\r
229 GetStyles : function()
\r
231 var styles = this._GetStyles ;
\r
234 styles = this._GetStyles = FCKTools.Merge(
\r
235 this._LoadStylesCore(),
\r
236 this._LoadStylesCustom(),
\r
237 this._LoadStylesXml() ) ;
\r
242 CheckHasObjectStyle : function( elementName )
\r
244 return !!this._ObjectStyles[ elementName ] ;
\r
247 _LoadStylesCore : function()
\r
250 var styleDefs = FCKConfig.CoreStyles ;
\r
252 for ( var styleName in styleDefs )
\r
254 // Core styles are prefixed with _FCK_.
\r
255 var style = styles[ '_FCK_' + styleName ] = new FCKStyle( styleDefs[ styleName ] ) ;
\r
256 style.IsCore = true ;
\r
261 _LoadStylesCustom : function()
\r
264 var styleDefs = FCKConfig.CustomStyles ;
\r
268 for ( var styleName in styleDefs )
\r
270 var style = styles[ styleName ] = new FCKStyle( styleDefs[ styleName ] ) ;
\r
271 style.Name = styleName ;
\r
278 _LoadStylesXml : function()
\r
282 var stylesXmlPath = FCKConfig.StylesXmlPath ;
\r
284 if ( !stylesXmlPath || stylesXmlPath.length == 0 )
\r
287 // Load the XML file into a FCKXml object.
\r
288 var xml = new FCKXml() ;
\r
289 xml.LoadUrl( stylesXmlPath ) ;
\r
291 var stylesXmlObj = FCKXml.TransformToObject( xml.SelectSingleNode( 'Styles' ) ) ;
\r
293 // Get the "Style" nodes defined in the XML file.
\r
294 var styleNodes = stylesXmlObj.$Style ;
\r
296 // Check that it did contain some valid nodes
\r
300 // Add each style to our "Styles" collection.
\r
301 for ( var i = 0 ; i < styleNodes.length ; i++ )
\r
303 var styleNode = styleNodes[i] ;
\r
305 var element = ( styleNode.element || '' ).toLowerCase() ;
\r
307 if ( element.length == 0 )
\r
308 throw( 'The element name is required. Error loading "' + stylesXmlPath + '"' ) ;
\r
317 // Get the attributes defined for the style (if any).
\r
318 var attNodes = styleNode.$Attribute || [] ;
\r
320 // Add the attributes to the style definition object.
\r
321 for ( var j = 0 ; j < attNodes.length ; j++ )
\r
323 styleDef.Attributes[ attNodes[j].name ] = attNodes[j].value ;
\r
326 // Get the styles defined for the style (if any).
\r
327 var cssStyleNodes = styleNode.$Style || [] ;
\r
329 // Add the attributes to the style definition object.
\r
330 for ( j = 0 ; j < cssStyleNodes.length ; j++ )
\r
332 styleDef.Styles[ cssStyleNodes[j].name ] = cssStyleNodes[j].value ;
\r
335 // Load override definitions.
\r
336 var cssStyleOverrideNodes = styleNode.$Override ;
\r
337 if ( cssStyleOverrideNodes )
\r
339 for ( j = 0 ; j < cssStyleOverrideNodes.length ; j++ )
\r
341 var overrideNode = cssStyleOverrideNodes[j] ;
\r
344 Element : overrideNode.element
\r
347 var overrideAttNode = overrideNode.$Attribute ;
\r
348 if ( overrideAttNode )
\r
350 overrideDef.Attributes = {} ;
\r
351 for ( var k = 0 ; k < overrideAttNode.length ; k++ )
\r
353 var overrideAttValue = overrideAttNode[k].value || null ;
\r
354 if ( overrideAttValue )
\r
356 // Check if the override attribute value is a regular expression.
\r
357 var regexMatch = overrideAttValue && FCKRegexLib.RegExp.exec( overrideAttValue ) ;
\r
359 overrideAttValue = new RegExp( regexMatch[1], regexMatch[2] || '' ) ;
\r
361 overrideDef.Attributes[ overrideAttNode[k].name ] = overrideAttValue ;
\r
365 styleDef.Overrides.push( overrideDef ) ;
\r
369 var style = new FCKStyle( styleDef ) ;
\r
370 style.Name = styleNode.name || element ;
\r
372 if ( style.GetType() == FCK_STYLE_OBJECT )
\r
373 this._ObjectStyles[ element ] = true ;
\r
375 // Add the style to the "Styles" collection using it's name as the key.
\r
376 styles[ style.Name ] = style ;
\r