JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
65a36c21fa386c333a14bbc6cf91d4a0ae9a017a
[ckeditor.git] / _source / plugins / styles / plugin.js
1 /*\r
2 Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved.\r
3 For licensing, see LICENSE.html or http://ckeditor.com/license\r
4 */\r
5 \r
6 CKEDITOR.plugins.add( 'styles',\r
7 {\r
8         requires : [ 'selection' ]\r
9 });\r
10 \r
11 /**\r
12  * Registers a function to be called whenever a style changes its state in the\r
13  * editing area. The current state is passed to the function. The possible\r
14  * states are {@link CKEDITOR.TRISTATE_ON} and {@link CKEDITOR.TRISTATE_OFF}.\r
15  * @param {CKEDITOR.style} The style to be watched.\r
16  * @param {Function} The function to be called when the style state changes.\r
17  * @example\r
18  * // Create a style object for the <b> element.\r
19  * var style = new CKEDITOR.style( { element : 'b' } );\r
20  * var editor = CKEDITOR.instances.editor1;\r
21  * editor.attachStyleStateChange( style, function( state )\r
22  *     {\r
23  *         if ( state == CKEDITOR.TRISTATE_ON )\r
24  *             alert( 'The current state for the B element is ON' );\r
25  *         else\r
26  *             alert( 'The current state for the B element is OFF' );\r
27  *     });\r
28  */\r
29 CKEDITOR.editor.prototype.attachStyleStateChange = function( style, callback )\r
30 {\r
31         // Try to get the list of attached callbacks.\r
32         var styleStateChangeCallbacks = this._.styleStateChangeCallbacks;\r
33 \r
34         // If it doesn't exist, it means this is the first call. So, let's create\r
35         // all the structure to manage the style checks and the callback calls.\r
36         if ( !styleStateChangeCallbacks )\r
37         {\r
38                 // Create the callbacks array.\r
39                 styleStateChangeCallbacks = this._.styleStateChangeCallbacks = [];\r
40 \r
41                 // Attach to the selectionChange event, so we can check the styles at\r
42                 // that point.\r
43                 this.on( 'selectionChange', function( ev )\r
44                         {\r
45                                 // Loop throw all registered callbacks.\r
46                                 for ( var i = 0 ; i < styleStateChangeCallbacks.length ; i++ )\r
47                                 {\r
48                                         var callback = styleStateChangeCallbacks[ i ];\r
49 \r
50                                         // Check the current state for the style defined for that\r
51                                         // callback.\r
52                                         var currentState = callback.style.checkActive( ev.data.path ) ? CKEDITOR.TRISTATE_ON : CKEDITOR.TRISTATE_OFF;\r
53 \r
54                                         // If the state changed since the last check.\r
55                                         if ( callback.state !== currentState )\r
56                                         {\r
57                                                 // Call the callback function, passing the current\r
58                                                 // state to it.\r
59                                                 callback.fn.call( this, currentState );\r
60 \r
61                                                 // Save the current state, so it can be compared next\r
62                                                 // time.\r
63                                                 callback.state !== currentState;\r
64                                         }\r
65                                 }\r
66                         });\r
67         }\r
68 \r
69         // Save the callback info, so it can be checked on the next occurence of\r
70         // selectionChange.\r
71         styleStateChangeCallbacks.push( { style : style, fn : callback } );\r
72 };\r
73 \r
74 CKEDITOR.STYLE_BLOCK = 1;\r
75 CKEDITOR.STYLE_INLINE = 2;\r
76 CKEDITOR.STYLE_OBJECT = 3;\r
77 \r
78 (function()\r
79 {\r
80         var blockElements       = { address:1,div:1,h1:1,h2:1,h3:1,h4:1,h5:1,h6:1,p:1,pre:1 };\r
81         var objectElements      = { a:1,embed:1,hr:1,img:1,li:1,object:1,ol:1,table:1,td:1,tr:1,th:1,ul:1,dl:1,dt:1,dd:1,form:1};\r
82 \r
83         var semicolonFixRegex = /\s*(?:;\s*|$)/;\r
84 \r
85         CKEDITOR.style = function( styleDefinition, variablesValues )\r
86         {\r
87                 if ( variablesValues )\r
88                 {\r
89                         styleDefinition = CKEDITOR.tools.clone( styleDefinition );\r
90 \r
91                         replaceVariables( styleDefinition.attributes, variablesValues );\r
92                         replaceVariables( styleDefinition.styles, variablesValues );\r
93                 }\r
94 \r
95                 var element = this.element = ( styleDefinition.element || '*' ).toLowerCase();\r
96 \r
97                 this.type =\r
98                         ( element == '#' || blockElements[ element ] ) ?\r
99                                 CKEDITOR.STYLE_BLOCK\r
100                         : objectElements[ element ] ?\r
101                                 CKEDITOR.STYLE_OBJECT\r
102                         :\r
103                                 CKEDITOR.STYLE_INLINE;\r
104 \r
105                 this._ =\r
106                 {\r
107                         definition : styleDefinition\r
108                 };\r
109         };\r
110 \r
111         CKEDITOR.style.prototype =\r
112         {\r
113                 apply : function( document )\r
114                 {\r
115                         applyStyle.call( this, document, false );\r
116                 },\r
117 \r
118                 remove : function( document )\r
119                 {\r
120                         applyStyle.call( this, document, true );\r
121                 },\r
122 \r
123                 applyToRange : function( range )\r
124                 {\r
125                         return ( this.applyToRange =\r
126                                                 this.type == CKEDITOR.STYLE_INLINE ?\r
127                                                         applyInlineStyle\r
128                                                 : this.type == CKEDITOR.STYLE_BLOCK ?\r
129                                                         applyBlockStyle\r
130                                                 : this.type == CKEDITOR.STYLE_OBJECT ?\r
131                                                         applyObjectStyle\r
132                                                 : null ).call( this, range );\r
133                 },\r
134 \r
135                 removeFromRange : function( range )\r
136                 {\r
137                         return ( this.removeFromRange =\r
138                                                 this.type == CKEDITOR.STYLE_INLINE ?\r
139                                                         removeInlineStyle\r
140                                                 : null ).call( this, range );\r
141                 },\r
142 \r
143                 applyToObject : function( element )\r
144                 {\r
145                         setupElement( element, this );\r
146                 },\r
147 \r
148                 /**\r
149                  * Get the style state inside an element path. Returns "true" if the\r
150                  * element is active in the path.\r
151                  */\r
152                 checkActive : function( elementPath )\r
153                 {\r
154                         switch ( this.type )\r
155                         {\r
156                                 case CKEDITOR.STYLE_BLOCK :\r
157                                         return this.checkElementRemovable( elementPath.block || elementPath.blockLimit, true );\r
158 \r
159                                 case CKEDITOR.STYLE_OBJECT :\r
160                                 case CKEDITOR.STYLE_INLINE :\r
161 \r
162                                         var elements = elementPath.elements;\r
163 \r
164                                         for ( var i = 0, element ; i < elements.length ; i++ )\r
165                                         {\r
166                                                 element = elements[ i ];\r
167 \r
168                                                 if ( this.type == CKEDITOR.STYLE_INLINE\r
169                                                           && ( element == elementPath.block || element == elementPath.blockLimit ) )\r
170                                                         continue;\r
171 \r
172                                                 if( this.type == CKEDITOR.STYLE_OBJECT\r
173                                                          && !( element.getName() in objectElements ) )\r
174                                                                 continue;\r
175 \r
176                                                 if ( this.checkElementRemovable( element, true ) )\r
177                                                         return true;\r
178                                         }\r
179                         }\r
180                         return false;\r
181                 },\r
182 \r
183                 checkApplicable : function( elementPath )\r
184                 {\r
185                         switch ( this.type )\r
186                         {\r
187                                 case CKEDITOR.STYLE_INLINE :\r
188                                 case CKEDITOR.STYLE_BLOCK :\r
189                                         break;\r
190 \r
191                                 case CKEDITOR.STYLE_OBJECT :\r
192                                         return elementPath.lastElement.getAscendant( this.element, true );\r
193                         }\r
194 \r
195                         return true;\r
196                 },\r
197 \r
198                 // Checks if an element, or any of its attributes, is removable by the\r
199                 // current style definition.\r
200                 checkElementRemovable : function( element, fullMatch )\r
201                 {\r
202                         if ( !element )\r
203                                 return false;\r
204 \r
205                         var def = this._.definition,\r
206                                 attribs;\r
207 \r
208                         // If the element name is the same as the style name.\r
209                         if ( element.getName() == this.element )\r
210                         {\r
211                                 // If no attributes are defined in the element.\r
212                                 if ( !fullMatch && !element.hasAttributes() )\r
213                                         return true;\r
214 \r
215                                 attribs = getAttributesForComparison( def );\r
216 \r
217                                 if ( attribs._length )\r
218                                 {\r
219                                         for ( var attName in attribs )\r
220                                         {\r
221                                                 if ( attName == '_length' )\r
222                                                         continue;\r
223 \r
224                                                 var elementAttr = element.getAttribute( attName ) || '';\r
225                                                 if ( attName == 'style' ?\r
226                                                         compareCssText( attribs[ attName ], normalizeCssText( elementAttr, false ) )\r
227                                                         : attribs[ attName ] == elementAttr  )\r
228                                                 {\r
229                                                         if ( !fullMatch )\r
230                                                                 return true;\r
231                                                 }\r
232                                                 else if ( fullMatch )\r
233                                                                 return false;\r
234                                         }\r
235                                         if ( fullMatch )\r
236                                                 return true;\r
237                                 }\r
238                                 else\r
239                                         return true;\r
240                         }\r
241 \r
242                         // Check if the element can be somehow overriden.\r
243                         var override = getOverrides( this )[ element.getName() ] ;\r
244                         if ( override )\r
245                         {\r
246                                 // If no attributes have been defined, remove the element.\r
247                                 if ( !( attribs = override.attributes ) )\r
248                                         return true;\r
249 \r
250                                 for ( var i = 0 ; i < attribs.length ; i++ )\r
251                                 {\r
252                                         attName = attribs[i][0];\r
253                                         var actualAttrValue = element.getAttribute( attName );\r
254                                         if ( actualAttrValue )\r
255                                         {\r
256                                                 var attValue = attribs[i][1];\r
257 \r
258                                                 // Remove the attribute if:\r
259                                                 //    - The override definition value is null;\r
260                                                 //    - The override definition value is a string that\r
261                                                 //      matches the attribute value exactly.\r
262                                                 //    - The override definition value is a regex that\r
263                                                 //      has matches in the attribute value.\r
264                                                 if ( attValue === null ||\r
265                                                                 ( typeof attValue == 'string' && actualAttrValue == attValue ) ||\r
266                                                                 attValue.test( actualAttrValue ) )\r
267                                                         return true;\r
268                                         }\r
269                                 }\r
270                         }\r
271                         return false;\r
272                 },\r
273 \r
274                 // Builds the preview HTML based on the styles definition.\r
275                 buildPreview : function()\r
276                 {\r
277                         var styleDefinition = this._.definition,\r
278                                 html = [],\r
279                                 elementName = styleDefinition.element;\r
280 \r
281                         // Avoid <bdo> in the preview.\r
282                         if ( elementName == 'bdo' )\r
283                                 elementName = 'span';\r
284 \r
285                         html = [ '<', elementName ];\r
286 \r
287                         // Assign all defined attributes.\r
288                         var attribs     = styleDefinition.attributes;\r
289                         if ( attribs )\r
290                         {\r
291                                 for ( var att in attribs )\r
292                                 {\r
293                                         html.push( ' ', att, '="', attribs[ att ], '"' );\r
294                                 }\r
295                         }\r
296 \r
297                         // Assign the style attribute.\r
298                         var cssStyle = CKEDITOR.style.getStyleText( styleDefinition );\r
299                         if ( cssStyle )\r
300                                 html.push( ' style="', cssStyle, '"' );\r
301 \r
302                         html.push( '>', styleDefinition.name, '</', elementName, '>' );\r
303 \r
304                         return html.join( '' );\r
305                 }\r
306         };\r
307 \r
308         // Build the cssText based on the styles definition.\r
309         CKEDITOR.style.getStyleText = function( styleDefinition )\r
310         {\r
311                 // If we have already computed it, just return it.\r
312                 var stylesDef = styleDefinition._ST;\r
313                 if ( stylesDef )\r
314                         return stylesDef;\r
315 \r
316                 stylesDef = styleDefinition.styles;\r
317 \r
318                 // Builds the StyleText.\r
319                 var stylesText = ( styleDefinition.attributes && styleDefinition.attributes[ 'style' ] ) || '',\r
320                                 specialStylesText = '';\r
321 \r
322                 if ( stylesText.length )\r
323                         stylesText = stylesText.replace( semicolonFixRegex, ';' );\r
324 \r
325                 for ( var style in stylesDef )\r
326                 {\r
327                         var styleVal = stylesDef[ style ],\r
328                                         text = ( style + ':' + styleVal ).replace( semicolonFixRegex, ';' );\r
329 \r
330                         // Some browsers don't support 'inherit' property value, leave them intact. (#5242)\r
331                         if ( styleVal == 'inherit' )\r
332                                 specialStylesText += text;\r
333                         else\r
334                                 stylesText += text;\r
335                 }\r
336 \r
337                 // Browsers make some changes to the style when applying them. So, here\r
338                 // we normalize it to the browser format.\r
339                 if ( stylesText.length )\r
340                         stylesText = normalizeCssText( stylesText );\r
341 \r
342                 stylesText += specialStylesText;\r
343 \r
344                 // Return it, saving it to the next request.\r
345                 return ( styleDefinition._ST = stylesText );\r
346         };\r
347 \r
348         function applyInlineStyle( range )\r
349         {\r
350                 var document = range.document;\r
351 \r
352                 if ( range.collapsed )\r
353                 {\r
354                         // Create the element to be inserted in the DOM.\r
355                         var collapsedElement = getElement( this, document );\r
356 \r
357                         // Insert the empty element into the DOM at the range position.\r
358                         range.insertNode( collapsedElement );\r
359 \r
360                         // Place the selection right inside the empty element.\r
361                         range.moveToPosition( collapsedElement, CKEDITOR.POSITION_BEFORE_END );\r
362 \r
363                         return;\r
364                 }\r
365 \r
366                 var elementName = this.element;\r
367                 var def = this._.definition;\r
368                 var isUnknownElement;\r
369 \r
370                 // Get the DTD definition for the element. Defaults to "span".\r
371                 var dtd = CKEDITOR.dtd[ elementName ] || ( isUnknownElement = true, CKEDITOR.dtd.span );\r
372 \r
373                 // Bookmark the range so we can re-select it after processing.\r
374                 var bookmark = range.createBookmark();\r
375 \r
376                 // Expand the range.\r
377                 range.enlarge( CKEDITOR.ENLARGE_ELEMENT );\r
378                 range.trim();\r
379 \r
380                 // Get the first node to be processed and the last, which concludes the\r
381                 // processing.\r
382                 var boundaryNodes = range.getBoundaryNodes();\r
383                 var firstNode = boundaryNodes.startNode;\r
384                 var lastNode = boundaryNodes.endNode.getNextSourceNode( true );\r
385 \r
386                 // Probably the document end is reached, we need a marker node.\r
387                 if ( !lastNode )\r
388                 {\r
389                                 var marker;\r
390                                 lastNode = marker = document.createText( '' );\r
391                                 lastNode.insertAfter( range.endContainer );\r
392                 }\r
393                 // The detection algorithm below skips the contents inside bookmark nodes, so\r
394                 // we'll need to make sure lastNode isn't the &nbsp; inside a bookmark node.\r
395                 var lastParent = lastNode.getParent();\r
396                 if ( lastParent && lastParent.getAttribute( '_fck_bookmark' ) )\r
397                         lastNode = lastParent;\r
398 \r
399                 if ( lastNode.equals( firstNode ) )\r
400                 {\r
401                         // If the last node is the same as the the first one, we must move\r
402                         // it to the next one, otherwise the first one will not be\r
403                         // processed.\r
404                         lastNode = lastNode.getNextSourceNode( true );\r
405 \r
406                         // It may happen that there are no more nodes after it (the end of\r
407                         // the document), so we must add something there to make our code\r
408                         // simpler.\r
409                         if ( !lastNode )\r
410                         {\r
411                                 lastNode = marker = document.createText( '' );\r
412                                 lastNode.insertAfter( firstNode );\r
413                         }\r
414                 }\r
415 \r
416                 var currentNode = firstNode;\r
417 \r
418                 var styleRange;\r
419 \r
420                 while ( currentNode )\r
421                 {\r
422                         var applyStyle = false;\r
423 \r
424                         if ( currentNode.equals( lastNode ) )\r
425                         {\r
426                                 currentNode = null;\r
427                                 applyStyle = true;\r
428                         }\r
429                         else\r
430                         {\r
431                                 var nodeType = currentNode.type;\r
432                                 var nodeName = nodeType == CKEDITOR.NODE_ELEMENT ? currentNode.getName() : null;\r
433 \r
434                                 if ( nodeName && currentNode.getAttribute( '_fck_bookmark' ) )\r
435                                 {\r
436                                         currentNode = currentNode.getNextSourceNode( true );\r
437                                         continue;\r
438                                 }\r
439 \r
440                                 // Check if the current node can be a child of the style element.\r
441                                 if ( !nodeName || ( dtd[ nodeName ]\r
442                                         && ( currentNode.getPosition( lastNode ) | CKEDITOR.POSITION_PRECEDING | CKEDITOR.POSITION_IDENTICAL | CKEDITOR.POSITION_IS_CONTAINED ) == ( CKEDITOR.POSITION_PRECEDING + CKEDITOR.POSITION_IDENTICAL + CKEDITOR.POSITION_IS_CONTAINED )\r
443                                         && ( !def.childRule || def.childRule( currentNode ) ) ) )\r
444                                 {\r
445                                         var currentParent = currentNode.getParent();\r
446 \r
447                                         // Check if the style element can be a child of the current\r
448                                         // node parent or if the element is not defined in the DTD.\r
449                                         if ( currentParent\r
450                                                 && ( ( currentParent.getDtd() || CKEDITOR.dtd.span )[ elementName ] || isUnknownElement )\r
451                                                 && ( !def.parentRule || def.parentRule( currentParent ) ) )\r
452                                         {\r
453                                                 // This node will be part of our range, so if it has not\r
454                                                 // been started, place its start right before the node.\r
455                                                 // In the case of an element node, it will be included\r
456                                                 // only if it is entirely inside the range.\r
457                                                 if ( !styleRange && ( !nodeName || !CKEDITOR.dtd.$removeEmpty[ nodeName ] || ( currentNode.getPosition( lastNode ) | CKEDITOR.POSITION_PRECEDING | CKEDITOR.POSITION_IDENTICAL | CKEDITOR.POSITION_IS_CONTAINED ) == ( CKEDITOR.POSITION_PRECEDING + CKEDITOR.POSITION_IDENTICAL + CKEDITOR.POSITION_IS_CONTAINED ) ) )\r
458                                                 {\r
459                                                         styleRange = new CKEDITOR.dom.range( document );\r
460                                                         styleRange.setStartBefore( currentNode );\r
461                                                 }\r
462 \r
463                                                 // Non element nodes, or empty elements can be added\r
464                                                 // completely to the range.\r
465                                                 if ( nodeType == CKEDITOR.NODE_TEXT || ( nodeType == CKEDITOR.NODE_ELEMENT && !currentNode.getChildCount() ) )\r
466                                                 {\r
467                                                         var includedNode = currentNode;\r
468                                                         var parentNode;\r
469 \r
470                                                         // This node is about to be included completelly, but,\r
471                                                         // if this is the last node in its parent, we must also\r
472                                                         // check if the parent itself can be added completelly\r
473                                                         // to the range.\r
474                                                         while ( !includedNode.$.nextSibling\r
475                                                                 && ( parentNode = includedNode.getParent(), dtd[ parentNode.getName() ] )\r
476                                                                 && ( parentNode.getPosition( firstNode ) | CKEDITOR.POSITION_FOLLOWING | CKEDITOR.POSITION_IDENTICAL | CKEDITOR.POSITION_IS_CONTAINED ) == ( CKEDITOR.POSITION_FOLLOWING + CKEDITOR.POSITION_IDENTICAL + CKEDITOR.POSITION_IS_CONTAINED )\r
477                                                                 && ( !def.childRule || def.childRule( parentNode ) ) )\r
478                                                         {\r
479                                                                 includedNode = parentNode;\r
480                                                         }\r
481 \r
482                                                         styleRange.setEndAfter( includedNode );\r
483 \r
484                                                         // If the included node still is the last node in its\r
485                                                         // parent, it means that the parent can't be included\r
486                                                         // in this style DTD, so apply the style immediately.\r
487                                                         if ( !includedNode.$.nextSibling )\r
488                                                                 applyStyle = true;\r
489 \r
490                                                 }\r
491                                         }\r
492                                         else\r
493                                                 applyStyle = true;\r
494                                 }\r
495                                 else\r
496                                         applyStyle = true;\r
497 \r
498                                 // Get the next node to be processed.\r
499                                 currentNode = currentNode.getNextSourceNode();\r
500                         }\r
501 \r
502                         // Apply the style if we have something to which apply it.\r
503                         if ( applyStyle && styleRange && !styleRange.collapsed )\r
504                         {\r
505                                 // Build the style element, based on the style object definition.\r
506                                 var styleNode = getElement( this, document );\r
507 \r
508                                 // Get the element that holds the entire range.\r
509                                 var parent = styleRange.getCommonAncestor();\r
510 \r
511                                 // Loop through the parents, removing the redundant attributes\r
512                                 // from the element to be applied.\r
513                                 while ( styleNode && parent )\r
514                                 {\r
515                                         if ( parent.getName() == elementName )\r
516                                         {\r
517                                                 for ( var attName in def.attributes )\r
518                                                 {\r
519                                                         if ( styleNode.getAttribute( attName ) == parent.getAttribute( attName ) )\r
520                                                                 styleNode.removeAttribute( attName );\r
521                                                 }\r
522 \r
523                                                 for ( var styleName in def.styles )\r
524                                                 {\r
525                                                         if ( styleNode.getStyle( styleName ) == parent.getStyle( styleName ) )\r
526                                                                 styleNode.removeStyle( styleName );\r
527                                                 }\r
528 \r
529                                                 if ( !styleNode.hasAttributes() )\r
530                                                 {\r
531                                                         styleNode = null;\r
532                                                         break;\r
533                                                 }\r
534                                         }\r
535 \r
536                                         parent = parent.getParent();\r
537                                 }\r
538 \r
539                                 if ( styleNode )\r
540                                 {\r
541                                         // Move the contents of the range to the style element.\r
542                                         styleRange.extractContents().appendTo( styleNode );\r
543 \r
544                                         // Here we do some cleanup, removing all duplicated\r
545                                         // elements from the style element.\r
546                                         removeFromInsideElement( this, styleNode );\r
547 \r
548                                         // Insert it into the range position (it is collapsed after\r
549                                         // extractContents.\r
550                                         styleRange.insertNode( styleNode );\r
551 \r
552                                         // Let's merge our new style with its neighbors, if possible.\r
553                                         mergeSiblings( styleNode );\r
554 \r
555                                         // As the style system breaks text nodes constantly, let's normalize\r
556                                         // things for performance.\r
557                                         // With IE, some paragraphs get broken when calling normalize()\r
558                                         // repeatedly. Also, for IE, we must normalize body, not documentElement.\r
559                                         // IE is also known for having a "crash effect" with normalize().\r
560                                         // We should try to normalize with IE too in some way, somewhere.\r
561                                         if ( !CKEDITOR.env.ie )\r
562                                                 styleNode.$.normalize();\r
563                                 }\r
564 \r
565                                 // Style applied, let's release the range, so it gets\r
566                                 // re-initialization in the next loop.\r
567                                 styleRange = null;\r
568                         }\r
569                 }\r
570 \r
571                 // Remove the temporary marking node.(#4111)\r
572                 marker && marker.remove();\r
573                 range.moveToBookmark( bookmark );\r
574                 // Minimize the result range to exclude empty text nodes. (#5374)\r
575                 range.shrink( CKEDITOR.SHRINK_TEXT );\r
576         }\r
577 \r
578         function removeInlineStyle( range )\r
579         {\r
580                 /*\r
581                  * Make sure our range has included all "collpased" parent inline nodes so\r
582                  * that our operation logic can be simpler.\r
583                  */\r
584                 range.enlarge( CKEDITOR.ENLARGE_ELEMENT );\r
585 \r
586                 var bookmark = range.createBookmark(),\r
587                         startNode = bookmark.startNode;\r
588 \r
589                 if ( range.collapsed )\r
590                 {\r
591 \r
592                         var startPath = new CKEDITOR.dom.elementPath( startNode.getParent() ),\r
593                                 // The topmost element in elementspatch which we should jump out of.\r
594                                 boundaryElement;\r
595 \r
596 \r
597                         for ( var i = 0, element ; i < startPath.elements.length\r
598                                         && ( element = startPath.elements[i] ) ; i++ )\r
599                         {\r
600                                 /*\r
601                                  * 1. If it's collaped inside text nodes, try to remove the style from the whole element.\r
602                                  *\r
603                                  * 2. Otherwise if it's collapsed on element boundaries, moving the selection\r
604                                  *  outside the styles instead of removing the whole tag,\r
605                                  *  also make sure other inner styles were well preserverd.(#3309)\r
606                                  */\r
607                                 if ( element == startPath.block || element == startPath.blockLimit )\r
608                                         break;\r
609 \r
610                                 if ( this.checkElementRemovable( element ) )\r
611                                 {\r
612                                         var endOfElement = range.checkBoundaryOfElement( element, CKEDITOR.END ),\r
613                                                         startOfElement = !endOfElement && range.checkBoundaryOfElement( element, CKEDITOR.START );\r
614                                         if ( startOfElement || endOfElement )\r
615                                         {\r
616                                                 boundaryElement = element;\r
617                                                 boundaryElement.match = startOfElement ? 'start' : 'end';\r
618                                         }\r
619                                         else\r
620                                         {\r
621                                                 /*\r
622                                                  * Before removing the style node, there may be a sibling to the style node\r
623                                                  * that's exactly the same to the one to be removed. To the user, it makes\r
624                                                  * no difference that they're separate entities in the DOM tree. So, merge\r
625                                                  * them before removal.\r
626                                                  */\r
627                                                 mergeSiblings( element );\r
628                                                 removeFromElement( this, element );\r
629 \r
630                                         }\r
631                                 }\r
632                         }\r
633 \r
634                         // Re-create the style tree after/before the boundary element,\r
635                         // the replication start from bookmark start node to define the\r
636                         // new range.\r
637                         if ( boundaryElement )\r
638                         {\r
639                                 var clonedElement = startNode;\r
640                                 for ( i = 0 ;; i++ )\r
641                                 {\r
642                                         var newElement = startPath.elements[ i ];\r
643                                         if ( newElement.equals( boundaryElement ) )\r
644                                                 break;\r
645                                         // Avoid copying any matched element.\r
646                                         else if ( newElement.match )\r
647                                                 continue;\r
648                                         else\r
649                                                 newElement = newElement.clone();\r
650                                         newElement.append( clonedElement );\r
651                                         clonedElement = newElement;\r
652                                 }\r
653                                 clonedElement[ boundaryElement.match == 'start' ?\r
654                                                         'insertBefore' : 'insertAfter' ]( boundaryElement );\r
655                         }\r
656                 }\r
657                 else\r
658                 {\r
659                         /*\r
660                          * Now our range isn't collapsed. Lets walk from the start node to the end\r
661                          * node via DFS and remove the styles one-by-one.\r
662                          */\r
663                         var endNode = bookmark.endNode,\r
664                                 me = this;\r
665 \r
666                         /*\r
667                          * Find out the style ancestor that needs to be broken down at startNode\r
668                          * and endNode.\r
669                          */\r
670                         function breakNodes()\r
671                         {\r
672                                 var startPath = new CKEDITOR.dom.elementPath( startNode.getParent() ),\r
673                                         endPath = new CKEDITOR.dom.elementPath( endNode.getParent() ),\r
674                                         breakStart = null,\r
675                                         breakEnd = null;\r
676                                 for ( var i = 0 ; i < startPath.elements.length ; i++ )\r
677                                 {\r
678                                         var element = startPath.elements[ i ];\r
679 \r
680                                         if ( element == startPath.block || element == startPath.blockLimit )\r
681                                                 break;\r
682 \r
683                                         if ( me.checkElementRemovable( element ) )\r
684                                                 breakStart = element;\r
685                                 }\r
686                                 for ( i = 0 ; i < endPath.elements.length ; i++ )\r
687                                 {\r
688                                         element = endPath.elements[ i ];\r
689 \r
690                                         if ( element == endPath.block || element == endPath.blockLimit )\r
691                                                 break;\r
692 \r
693                                         if ( me.checkElementRemovable( element ) )\r
694                                                 breakEnd = element;\r
695                                 }\r
696 \r
697                                 if ( breakEnd )\r
698                                         endNode.breakParent( breakEnd );\r
699                                 if ( breakStart )\r
700                                         startNode.breakParent( breakStart );\r
701                         }\r
702                         breakNodes();\r
703 \r
704                         // Now, do the DFS walk.\r
705                         var currentNode = startNode.getNext();\r
706                         while ( !currentNode.equals( endNode ) )\r
707                         {\r
708                                 /*\r
709                                  * Need to get the next node first because removeFromElement() can remove\r
710                                  * the current node from DOM tree.\r
711                                  */\r
712                                 var nextNode = currentNode.getNextSourceNode();\r
713                                 if ( currentNode.type == CKEDITOR.NODE_ELEMENT && this.checkElementRemovable( currentNode ) )\r
714                                 {\r
715                                         // Remove style from element or overriding element.\r
716                                         if ( currentNode.getName() == this.element )\r
717                                                 removeFromElement( this, currentNode );\r
718                                         else\r
719                                                 removeOverrides( currentNode, getOverrides( this )[ currentNode.getName() ] );\r
720 \r
721                                         /*\r
722                                          * removeFromElement() may have merged the next node with something before\r
723                                          * the startNode via mergeSiblings(). In that case, the nextNode would\r
724                                          * contain startNode and we'll have to call breakNodes() again and also\r
725                                          * reassign the nextNode to something after startNode.\r
726                                          */\r
727                                         if ( nextNode.type == CKEDITOR.NODE_ELEMENT && nextNode.contains( startNode ) )\r
728                                         {\r
729                                                 breakNodes();\r
730                                                 nextNode = startNode.getNext();\r
731                                         }\r
732                                 }\r
733                                 currentNode = nextNode;\r
734                         }\r
735                 }\r
736 \r
737                 range.moveToBookmark( bookmark );\r
738 }\r
739 \r
740         function applyObjectStyle( range )\r
741         {\r
742                 var root = range.getCommonAncestor( true, true ),\r
743                                 element = root.getAscendant( this.element, true );\r
744                 element && setupElement( element, this );\r
745         }\r
746 \r
747         function applyBlockStyle( range )\r
748         {\r
749                 // Serializible bookmarks is needed here since\r
750                 // elements may be merged.\r
751                 var bookmark = range.createBookmark( true );\r
752 \r
753                 var iterator = range.createIterator();\r
754                 iterator.enforceRealBlocks = true;\r
755 \r
756                 var block;\r
757                 var doc = range.document;\r
758                 var previousPreBlock;\r
759 \r
760                 while ( ( block = iterator.getNextParagraph() ) )               // Only one =\r
761                 {\r
762                         var newBlock = getElement( this, doc );\r
763                         replaceBlock( block, newBlock );\r
764                 }\r
765 \r
766                 range.moveToBookmark( bookmark );\r
767         }\r
768 \r
769         // Replace the original block with new one, with special treatment\r
770         // for <pre> blocks to make sure content format is well preserved, and merging/splitting adjacent\r
771         // when necessary.(#3188)\r
772         function replaceBlock( block, newBlock )\r
773         {\r
774                 var newBlockIsPre       = newBlock.is( 'pre' );\r
775                 var blockIsPre          = block.is( 'pre' );\r
776 \r
777                 var isToPre     = newBlockIsPre && !blockIsPre;\r
778                 var isFromPre   = !newBlockIsPre && blockIsPre;\r
779 \r
780                 if ( isToPre )\r
781                         newBlock = toPre( block, newBlock );\r
782                 else if ( isFromPre )\r
783                         // Split big <pre> into pieces before start to convert.\r
784                         newBlock = fromPres( splitIntoPres( block ), newBlock );\r
785                 else\r
786                         block.moveChildren( newBlock );\r
787 \r
788                 newBlock.replace( block );\r
789 \r
790                 if ( newBlockIsPre )\r
791                 {\r
792                         // Merge previous <pre> blocks.\r
793                         mergePre( newBlock );\r
794                 }\r
795         }\r
796 \r
797         /**\r
798          * Merge a <pre> block with a previous sibling if available.\r
799          */\r
800         function mergePre( preBlock )\r
801         {\r
802                 var previousBlock;\r
803                 if ( !( ( previousBlock = preBlock.getPreviousSourceNode( true, CKEDITOR.NODE_ELEMENT ) )\r
804                                  && previousBlock.is\r
805                                  && previousBlock.is( 'pre') ) )\r
806                         return;\r
807 \r
808                 // Merge the previous <pre> block contents into the current <pre>\r
809                 // block.\r
810                 //\r
811                 // Another thing to be careful here is that currentBlock might contain\r
812                 // a '\n' at the beginning, and previousBlock might contain a '\n'\r
813                 // towards the end. These new lines are not normally displayed but they\r
814                 // become visible after merging.\r
815                 var mergedHtml = replace( previousBlock.getHtml(), /\n$/, '' ) + '\n\n' +\r
816                                 replace( preBlock.getHtml(), /^\n/, '' ) ;\r
817 \r
818                 // Krugle: IE normalizes innerHTML from <pre>, breaking whitespaces.\r
819                 if ( CKEDITOR.env.ie )\r
820                         preBlock.$.outerHTML = '<pre>' + mergedHtml + '</pre>';\r
821                 else\r
822                         preBlock.setHtml( mergedHtml );\r
823 \r
824                 previousBlock.remove();\r
825         }\r
826 \r
827         /**\r
828          * Split into multiple <pre> blocks separated by double line-break.\r
829          * @param preBlock\r
830          */\r
831         function splitIntoPres( preBlock )\r
832         {\r
833                 // Exclude the ones at header OR at tail,\r
834                 // and ignore bookmark content between them.\r
835                 var duoBrRegex = /(\S\s*)\n(?:\s|(<span[^>]+_fck_bookmark.*?\/span>))*\n(?!$)/gi,\r
836                         blockName = preBlock.getName(),\r
837                         splitedHtml = replace( preBlock.getOuterHtml(),\r
838                                 duoBrRegex,\r
839                                 function( match, charBefore, bookmark )\r
840                                 {\r
841                                   return charBefore + '</pre>' + bookmark + '<pre>';\r
842                                 } );\r
843 \r
844                 var pres = [];\r
845                 splitedHtml.replace( /<pre\b.*?>([\s\S]*?)<\/pre>/gi, function( match, preContent ){\r
846                         pres.push( preContent );\r
847                 } );\r
848                 return pres;\r
849         }\r
850 \r
851         // Wrapper function of String::replace without considering of head/tail bookmarks nodes.\r
852         function replace( str, regexp, replacement )\r
853         {\r
854                 var headBookmark = '',\r
855                         tailBookmark = '';\r
856 \r
857                 str = str.replace( /(^<span[^>]+_fck_bookmark.*?\/span>)|(<span[^>]+_fck_bookmark.*?\/span>$)/gi,\r
858                         function( str, m1, m2 ){\r
859                                         m1 && ( headBookmark = m1 );\r
860                                         m2 && ( tailBookmark = m2 );\r
861                                 return '';\r
862                         } );\r
863                 return headBookmark + str.replace( regexp, replacement ) + tailBookmark;\r
864         }\r
865         /**\r
866          * Converting a list of <pre> into blocks with format well preserved.\r
867          */\r
868         function fromPres( preHtmls, newBlock )\r
869         {\r
870                 var docFrag = new CKEDITOR.dom.documentFragment( newBlock.getDocument() );\r
871                 for ( var i = 0 ; i < preHtmls.length ; i++ )\r
872                 {\r
873                         var blockHtml = preHtmls[ i ];\r
874 \r
875                         // 1. Trim the first and last line-breaks immediately after and before <pre>,\r
876                         // they're not visible.\r
877                          blockHtml =  blockHtml.replace( /(\r\n|\r)/g, '\n' ) ;\r
878                          blockHtml = replace(  blockHtml, /^[ \t]*\n/, '' ) ;\r
879                          blockHtml = replace(  blockHtml, /\n$/, '' ) ;\r
880                         // 2. Convert spaces or tabs at the beginning or at the end to &nbsp;\r
881                          blockHtml = replace(  blockHtml, /^[ \t]+|[ \t]+$/g, function( match, offset, s )\r
882                                         {\r
883                                                 if ( match.length == 1 )        // one space, preserve it\r
884                                                         return '&nbsp;' ;\r
885                                                 else if ( !offset )             // beginning of block\r
886                                                         return CKEDITOR.tools.repeat( '&nbsp;', match.length - 1 ) + ' ';\r
887                                                 else                            // end of block\r
888                                                         return ' ' + CKEDITOR.tools.repeat( '&nbsp;', match.length - 1 );\r
889                                         } ) ;\r
890 \r
891                         // 3. Convert \n to <BR>.\r
892                         // 4. Convert contiguous (i.e. non-singular) spaces or tabs to &nbsp;\r
893                          blockHtml =  blockHtml.replace( /\n/g, '<br>' ) ;\r
894                          blockHtml =  blockHtml.replace( /[ \t]{2,}/g,\r
895                                         function ( match )\r
896                                         {\r
897                                                 return CKEDITOR.tools.repeat( '&nbsp;', match.length - 1 ) + ' ' ;\r
898                                         } ) ;\r
899 \r
900                         var newBlockClone = newBlock.clone();\r
901                         newBlockClone.setHtml(  blockHtml );\r
902                         docFrag.append( newBlockClone );\r
903                 }\r
904                 return docFrag;\r
905         }\r
906 \r
907         /**\r
908          * Converting from a non-PRE block to a PRE block in formatting operations.\r
909          */\r
910         function toPre( block, newBlock )\r
911         {\r
912                 // First trim the block content.\r
913                 var preHtml = block.getHtml();\r
914 \r
915                 // 1. Trim head/tail spaces, they're not visible.\r
916                 preHtml = replace( preHtml, /(?:^[ \t\n\r]+)|(?:[ \t\n\r]+$)/g, '' );\r
917                 // 2. Delete ANSI whitespaces immediately before and after <BR> because\r
918                 //    they are not visible.\r
919                 preHtml = preHtml.replace( /[ \t\r\n]*(<br[^>]*>)[ \t\r\n]*/gi, '$1' );\r
920                 // 3. Compress other ANSI whitespaces since they're only visible as one\r
921                 //    single space previously.\r
922                 // 4. Convert &nbsp; to spaces since &nbsp; is no longer needed in <PRE>.\r
923                 preHtml = preHtml.replace( /([ \t\n\r]+|&nbsp;)/g, ' ' );\r
924                 // 5. Convert any <BR /> to \n. This must not be done earlier because\r
925                 //    the \n would then get compressed.\r
926                 preHtml = preHtml.replace( /<br\b[^>]*>/gi, '\n' );\r
927 \r
928                 // Krugle: IE normalizes innerHTML to <pre>, breaking whitespaces.\r
929                 if ( CKEDITOR.env.ie )\r
930                 {\r
931                         var temp = block.getDocument().createElement( 'div' );\r
932                         temp.append( newBlock );\r
933                         newBlock.$.outerHTML =  '<pre>' + preHtml + '</pre>';\r
934                         newBlock = temp.getFirst().remove();\r
935                 }\r
936                 else\r
937                         newBlock.setHtml( preHtml );\r
938 \r
939                 return newBlock;\r
940         }\r
941 \r
942         // Removes a style from an element itself, don't care about its subtree.\r
943         function removeFromElement( style, element )\r
944         {\r
945                 var def = style._.definition,\r
946                         attributes = CKEDITOR.tools.extend( {}, def.attributes, getOverrides( style )[ element.getName() ] ),\r
947                         styles = def.styles,\r
948                         // If the style is only about the element itself, we have to remove the element.\r
949                         removeEmpty = CKEDITOR.tools.isEmpty( attributes ) && CKEDITOR.tools.isEmpty( styles );\r
950 \r
951                 // Remove definition attributes/style from the elemnt.\r
952                 for ( var attName in attributes )\r
953                 {\r
954                         // The 'class' element value must match (#1318).\r
955                         if ( ( attName == 'class' || style._.definition.fullMatch )\r
956                                 && element.getAttribute( attName ) != normalizeProperty( attName, attributes[ attName ] ) )\r
957                                 continue;\r
958                         removeEmpty = element.hasAttribute( attName );\r
959                         element.removeAttribute( attName );\r
960                 }\r
961 \r
962                 for ( var styleName in styles )\r
963                 {\r
964                         // Full match style insist on having fully equivalence. (#5018)\r
965                         if ( style._.definition.fullMatch\r
966                                 && element.getStyle( styleName ) != normalizeProperty( styleName, styles[ styleName ], true ) )\r
967                                 continue;\r
968 \r
969                         removeEmpty = removeEmpty || !!element.getStyle( styleName );\r
970                         element.removeStyle( styleName );\r
971                 }\r
972 \r
973                 removeEmpty && removeNoAttribsElement( element );\r
974         }\r
975 \r
976         // Removes a style from inside an element.\r
977         function removeFromInsideElement( style, element )\r
978         {\r
979                 var def = style._.definition,\r
980                         attribs = def.attributes,\r
981                         styles = def.styles,\r
982                         overrides = getOverrides( style );\r
983 \r
984                 var innerElements = element.getElementsByTag( style.element );\r
985 \r
986                 for ( var i = innerElements.count(); --i >= 0 ; )\r
987                         removeFromElement( style,  innerElements.getItem( i ) );\r
988 \r
989                 // Now remove any other element with different name that is\r
990                 // defined to be overriden.\r
991                 for ( var overrideElement in overrides )\r
992                 {\r
993                         if ( overrideElement != style.element )\r
994                         {\r
995                                 innerElements = element.getElementsByTag( overrideElement ) ;\r
996                                 for ( i = innerElements.count() - 1 ; i >= 0 ; i-- )\r
997                                 {\r
998                                         var innerElement = innerElements.getItem( i );\r
999                                         removeOverrides( innerElement, overrides[ overrideElement ] ) ;\r
1000                                 }\r
1001                         }\r
1002                 }\r
1003 \r
1004         }\r
1005 \r
1006         /**\r
1007          *  Remove overriding styles/attributes from the specific element.\r
1008          *  Note: Remove the element if no attributes remain.\r
1009          * @param {Object} element\r
1010          * @param {Object} overrides\r
1011          */\r
1012         function removeOverrides( element, overrides )\r
1013         {\r
1014                 var attributes = overrides && overrides.attributes ;\r
1015 \r
1016                 if ( attributes )\r
1017                 {\r
1018                         for ( var i = 0 ; i < attributes.length ; i++ )\r
1019                         {\r
1020                                 var attName = attributes[i][0], actualAttrValue ;\r
1021 \r
1022                                 if ( ( actualAttrValue = element.getAttribute( attName ) ) )\r
1023                                 {\r
1024                                         var attValue = attributes[i][1] ;\r
1025 \r
1026                                         // Remove the attribute if:\r
1027                                         //    - The override definition value is null ;\r
1028                                         //    - The override definition valie is a string that\r
1029                                         //      matches the attribute value exactly.\r
1030                                         //    - The override definition value is a regex that\r
1031                                         //      has matches in the attribute value.\r
1032                                         if ( attValue === null ||\r
1033                                                         ( attValue.test && attValue.test( actualAttrValue ) ) ||\r
1034                                                         ( typeof attValue == 'string' && actualAttrValue == attValue ) )\r
1035                                                 element.removeAttribute( attName ) ;\r
1036                                 }\r
1037                         }\r
1038                 }\r
1039 \r
1040                 removeNoAttribsElement( element );\r
1041         }\r
1042 \r
1043         // If the element has no more attributes, remove it.\r
1044         function removeNoAttribsElement( element )\r
1045         {\r
1046                 // If no more attributes remained in the element, remove it,\r
1047                 // leaving its children.\r
1048                 if ( !element.hasAttributes() )\r
1049                 {\r
1050                         // Removing elements may open points where merging is possible,\r
1051                         // so let's cache the first and last nodes for later checking.\r
1052                         var firstChild  = element.getFirst();\r
1053                         var lastChild   = element.getLast();\r
1054 \r
1055                         element.remove( true );\r
1056 \r
1057                         if ( firstChild )\r
1058                         {\r
1059                                 // Check the cached nodes for merging.\r
1060                                 mergeSiblings( firstChild );\r
1061 \r
1062                                 if ( lastChild && !firstChild.equals( lastChild ) )\r
1063                                         mergeSiblings( lastChild );\r
1064                         }\r
1065                 }\r
1066         }\r
1067 \r
1068         function mergeSiblings( element )\r
1069         {\r
1070                 if ( !element || element.type != CKEDITOR.NODE_ELEMENT || !CKEDITOR.dtd.$removeEmpty[ element.getName() ] )\r
1071                         return;\r
1072 \r
1073                 mergeElements( element, element.getNext(), true );\r
1074                 mergeElements( element, element.getPrevious() );\r
1075         }\r
1076 \r
1077         function mergeElements( element, sibling, isNext )\r
1078         {\r
1079                 if ( sibling && sibling.type == CKEDITOR.NODE_ELEMENT )\r
1080                 {\r
1081                         var hasBookmark = sibling.getAttribute( '_fck_bookmark' );\r
1082 \r
1083                         if ( hasBookmark )\r
1084                                 sibling = isNext ? sibling.getNext() : sibling.getPrevious();\r
1085 \r
1086                         if ( sibling && sibling.type == CKEDITOR.NODE_ELEMENT && element.isIdentical( sibling ) )\r
1087                         {\r
1088                                 // Save the last child to be checked too, to merge things like\r
1089                                 // <b><i></i></b><b><i></i></b> => <b><i></i></b>\r
1090                                 var innerSibling = isNext ? element.getLast() : element.getFirst();\r
1091 \r
1092                                 if ( hasBookmark )\r
1093                                         ( isNext ? sibling.getPrevious() : sibling.getNext() ).move( element, !isNext );\r
1094 \r
1095                                 sibling.moveChildren( element, !isNext );\r
1096                                 sibling.remove();\r
1097 \r
1098                                 // Now check the last inner child (see two comments above).\r
1099                                 if ( innerSibling )\r
1100                                         mergeSiblings( innerSibling );\r
1101                         }\r
1102                 }\r
1103         }\r
1104 \r
1105         function getElement( style, targetDocument )\r
1106         {\r
1107                 var el;\r
1108 \r
1109                 var def = style._.definition;\r
1110 \r
1111                 var elementName = style.element;\r
1112 \r
1113                 // The "*" element name will always be a span for this function.\r
1114                 if ( elementName == '*' )\r
1115                         elementName = 'span';\r
1116 \r
1117                 // Create the element.\r
1118                 el = new CKEDITOR.dom.element( elementName, targetDocument );\r
1119 \r
1120                 return setupElement( el, style );\r
1121         }\r
1122 \r
1123         function setupElement( el, style )\r
1124         {\r
1125                 var def = style._.definition;\r
1126                 var attributes = def.attributes;\r
1127                 var styles = CKEDITOR.style.getStyleText( def );\r
1128 \r
1129                 // Assign all defined attributes.\r
1130                 if ( attributes )\r
1131                 {\r
1132                         for ( var att in attributes )\r
1133                         {\r
1134                                 el.setAttribute( att, attributes[ att ] );\r
1135                         }\r
1136                 }\r
1137 \r
1138                 // Assign all defined styles.\r
1139                 if ( styles )\r
1140                         el.setAttribute( 'style', styles );\r
1141 \r
1142                 return el;\r
1143         }\r
1144 \r
1145         var varRegex = /#\((.+?)\)/g;\r
1146         function replaceVariables( list, variablesValues )\r
1147         {\r
1148                 for ( var item in list )\r
1149                 {\r
1150                         list[ item ] = list[ item ].replace( varRegex, function( match, varName )\r
1151                                 {\r
1152                                         return variablesValues[ varName ];\r
1153                                 });\r
1154                 }\r
1155         }\r
1156 \r
1157 \r
1158         // Returns an object that can be used for style matching comparison.\r
1159         // Attributes names and values are all lowercased, and the styles get\r
1160         // merged with the style attribute.\r
1161         function getAttributesForComparison( styleDefinition )\r
1162         {\r
1163                 // If we have already computed it, just return it.\r
1164                 var attribs = styleDefinition._AC;\r
1165                 if ( attribs )\r
1166                         return attribs;\r
1167 \r
1168                 attribs = {};\r
1169 \r
1170                 var length = 0;\r
1171 \r
1172                 // Loop through all defined attributes.\r
1173                 var styleAttribs = styleDefinition.attributes;\r
1174                 if ( styleAttribs )\r
1175                 {\r
1176                         for ( var styleAtt in styleAttribs )\r
1177                         {\r
1178                                 length++;\r
1179                                 attribs[ styleAtt ] = styleAttribs[ styleAtt ];\r
1180                         }\r
1181                 }\r
1182 \r
1183                 // Includes the style definitions.\r
1184                 var styleText = CKEDITOR.style.getStyleText( styleDefinition );\r
1185                 if ( styleText )\r
1186                 {\r
1187                         if ( !attribs[ 'style' ] )\r
1188                                 length++;\r
1189                         attribs[ 'style' ] = styleText;\r
1190                 }\r
1191 \r
1192                 // Appends the "length" information to the object.\r
1193                 attribs._length = length;\r
1194 \r
1195                 // Return it, saving it to the next request.\r
1196                 return ( styleDefinition._AC = attribs );\r
1197         }\r
1198 \r
1199         /**\r
1200          * Get the the collection used to compare the elements and attributes,\r
1201          * defined in this style overrides, with other element. All information in\r
1202          * it is lowercased.\r
1203          * @param {CKEDITOR.style} style\r
1204          */\r
1205         function getOverrides( style )\r
1206         {\r
1207                 if ( style._.overrides )\r
1208                         return style._.overrides;\r
1209 \r
1210                 var overrides = ( style._.overrides = {} ),\r
1211                         definition = style._.definition.overrides;\r
1212 \r
1213                 if ( definition )\r
1214                 {\r
1215                         // The override description can be a string, object or array.\r
1216                         // Internally, well handle arrays only, so transform it if needed.\r
1217                         if ( !CKEDITOR.tools.isArray( definition ) )\r
1218                                 definition = [ definition ];\r
1219 \r
1220                         // Loop through all override definitions.\r
1221                         for ( var i = 0 ; i < definition.length ; i++ )\r
1222                         {\r
1223                                 var override = definition[i];\r
1224                                 var elementName;\r
1225                                 var overrideEl;\r
1226                                 var attrs;\r
1227 \r
1228                                 // If can be a string with the element name.\r
1229                                 if ( typeof override == 'string' )\r
1230                                         elementName = override.toLowerCase();\r
1231                                 // Or an object.\r
1232                                 else\r
1233                                 {\r
1234                                         elementName = override.element ? override.element.toLowerCase() : style.element;\r
1235                                         attrs = override.attributes;\r
1236                                 }\r
1237 \r
1238                                 // We can have more than one override definition for the same\r
1239                                 // element name, so we attempt to simply append information to\r
1240                                 // it if it already exists.\r
1241                                 overrideEl = overrides[ elementName ] || ( overrides[ elementName ] = {} );\r
1242 \r
1243                                 if ( attrs )\r
1244                                 {\r
1245                                         // The returning attributes list is an array, because we\r
1246                                         // could have different override definitions for the same\r
1247                                         // attribute name.\r
1248                                         var overrideAttrs = ( overrideEl.attributes = overrideEl.attributes || new Array() );\r
1249                                         for ( var attName in attrs )\r
1250                                         {\r
1251                                                 // Each item in the attributes array is also an array,\r
1252                                                 // where [0] is the attribute name and [1] is the\r
1253                                                 // override value.\r
1254                                                 overrideAttrs.push( [ attName.toLowerCase(), attrs[ attName ] ] );\r
1255                                         }\r
1256                                 }\r
1257                         }\r
1258                 }\r
1259 \r
1260                 return overrides;\r
1261         }\r
1262 \r
1263         function normalizeProperty( name, value, isStyle )\r
1264         {\r
1265                 var temp = new CKEDITOR.dom.element( 'span' );\r
1266                 temp [ isStyle ? 'setStyle' : 'setAttribute' ]( name, value );\r
1267                 return temp[ isStyle ? 'getStyle' : 'getAttribute' ]( name );\r
1268         }\r
1269 \r
1270         function normalizeCssText( unparsedCssText, nativeNormalize )\r
1271         {\r
1272                 var styleText;\r
1273                 if ( nativeNormalize !== false )\r
1274                 {\r
1275                         // Injects the style in a temporary span object, so the browser parses it,\r
1276                         // retrieving its final format.\r
1277                         var temp = new CKEDITOR.dom.element( 'span' );\r
1278                         temp.setAttribute( 'style', unparsedCssText );\r
1279                         styleText = temp.getAttribute( 'style' ) || '';\r
1280                 }\r
1281                 else\r
1282                         styleText = unparsedCssText;\r
1283 \r
1284                 // Shrinking white-spaces around colon and semi-colon (#4147).\r
1285                 // Compensate tail semi-colon.\r
1286                 return styleText.replace( /\s*([;:])\s*/, '$1' )\r
1287                                                          .replace( /([^\s;])$/, '$1;')\r
1288                                                          .replace( /,\s+/g, ',' ) // Trimming spaces after comma (e.g. font-family name)(#4107).\r
1289                                                          .toLowerCase();\r
1290         }\r
1291 \r
1292         // Turn inline style text properties into one hash.\r
1293         function parseStyleText( styleText )\r
1294         {\r
1295                 var retval = {};\r
1296                 styleText\r
1297                    .replace( /&quot;/g, '"' )\r
1298                    .replace( /\s*([^ :;]+)\s*:\s*([^;]+)\s*(?=;|$)/g, function( match, name, value )\r
1299                 {\r
1300                         retval[ name ] = value;\r
1301                 } );\r
1302                 return retval;\r
1303         }\r
1304 \r
1305         function compareCssText( source, target )\r
1306         {\r
1307                 typeof source == 'string' && ( source = parseStyleText( source ) );\r
1308                 typeof target == 'string' && ( target = parseStyleText( target ) );\r
1309                 for( var name in source )\r
1310                 {\r
1311                         // Value 'inherit'  is treated as a wildcard,\r
1312                         // which will match any value.\r
1313                         if ( !( name in target &&\r
1314                                         ( target[ name ] == source[ name ]\r
1315                                                 || source[ name ] == 'inherit'\r
1316                                                 || target[ name ] == 'inherit' ) ) )\r
1317                         {\r
1318                                 return false;\r
1319                         }\r
1320                 }\r
1321                 return true;\r
1322         }\r
1323 \r
1324         function applyStyle( document, remove )\r
1325         {\r
1326                 // Get all ranges from the selection.\r
1327                 var selection = document.getSelection();\r
1328                 var ranges = selection.getRanges();\r
1329                 var func = remove ? this.removeFromRange : this.applyToRange;\r
1330 \r
1331                 // Apply the style to the ranges.\r
1332                 for ( var i = 0 ; i < ranges.length ; i++ )\r
1333                         func.call( this, ranges[ i ] );\r
1334 \r
1335                 // Select the ranges again.\r
1336                 selection.selectRanges( ranges );\r
1337         }\r
1338 })();\r
1339 \r
1340 CKEDITOR.styleCommand = function( style )\r
1341 {\r
1342         this.style = style;\r
1343 };\r
1344 \r
1345 CKEDITOR.styleCommand.prototype.exec = function( editor )\r
1346 {\r
1347         editor.focus();\r
1348 \r
1349         var doc = editor.document;\r
1350 \r
1351         if ( doc )\r
1352         {\r
1353                 if ( this.state == CKEDITOR.TRISTATE_OFF )\r
1354                         this.style.apply( doc );\r
1355                 else if ( this.state == CKEDITOR.TRISTATE_ON )\r
1356                         this.style.remove( doc );\r
1357         }\r
1358 \r
1359         return !!doc;\r
1360 };\r
1361 \r
1362 CKEDITOR.stylesSet = new CKEDITOR.resourceManager( '', 'stylesSet' );\r
1363 \r
1364 // Backward compatibility (#5025).\r
1365 CKEDITOR.addStylesSet = CKEDITOR.tools.bind( CKEDITOR.stylesSet.add, CKEDITOR.stylesSet );\r
1366 CKEDITOR.loadStylesSet = function( name, url, callback )\r
1367         {\r
1368                 CKEDITOR.stylesSet.addExternal( name, url, '' );\r
1369                 CKEDITOR.stylesSet.load( name, callback );\r
1370         };\r
1371 \r
1372 \r
1373 /**\r
1374  * Gets the current styleSet for this instance\r
1375  * @param {Function} The function to be called with the styles data.\r
1376  * @example\r
1377  * editor.getStylesSet( function( stylesDefinitions ) {} );\r
1378  */\r
1379 CKEDITOR.editor.prototype.getStylesSet = function( callback )\r
1380 {\r
1381         if ( !this._.stylesDefinitions )\r
1382         {\r
1383                 var editor = this,\r
1384                         // Respect the backwards compatible definition entry\r
1385                         configStyleSet = editor.config.stylesCombo_stylesSet || editor.config.stylesSet || 'default';\r
1386 \r
1387                 // #5352 Allow to define the styles directly in the config object\r
1388                 if ( configStyleSet instanceof Array )\r
1389                 {\r
1390                         editor._.stylesDefinitions = configStyleSet;\r
1391                         callback( configStyleSet );\r
1392                         return;\r
1393                 }\r
1394 \r
1395                 var     partsStylesSet = configStyleSet.split( ':' ),\r
1396                         styleSetName = partsStylesSet[ 0 ],\r
1397                         externalPath = partsStylesSet[ 1 ],\r
1398                         pluginPath = CKEDITOR.plugins.registered.styles.path;\r
1399 \r
1400                 CKEDITOR.stylesSet.addExternal( styleSetName,\r
1401                                 externalPath ?\r
1402                                         partsStylesSet.slice( 1 ).join( ':' ) :\r
1403                                         pluginPath + 'styles/' + styleSetName + '.js', '' );\r
1404 \r
1405                 CKEDITOR.stylesSet.load( styleSetName, function( stylesSet )\r
1406                         {\r
1407                                 editor._.stylesDefinitions = stylesSet[ styleSetName ];\r
1408                                 callback( editor._.stylesDefinitions );\r
1409                         } ) ;\r
1410         }\r
1411         else\r
1412                 callback( this._.stylesDefinitions );\r
1413 };\r
1414 \r
1415 /**\r
1416  * The "styles definition set" to use in the editor. They will be used in the\r
1417  * styles combo and the Style selector of the div container. <br>\r
1418  * The styles may be defined in the page containing the editor, or can be\r
1419  * loaded on demand from an external file. In the second case, if this setting\r
1420  * contains only a name, the styles definition file will be loaded from the\r
1421  * "styles" folder inside the styles plugin folder.\r
1422  * Otherwise, this setting has the "name:url" syntax, making it\r
1423  * possible to set the URL from which loading the styles file.<br>\r
1424  * Previously this setting was available as config.stylesCombo_stylesSet<br>\r
1425  * @type String|Array\r
1426  * @default 'default'\r
1427  * @since 3.3\r
1428  * @example\r
1429  * // Load from the styles' styles folder (mystyles.js file).\r
1430  * config.stylesSet = 'mystyles';\r
1431  * @example\r
1432  * // Load from a relative URL.\r
1433  * config.stylesSet = 'mystyles:/editorstyles/styles.js';\r
1434  * @example\r
1435  * // Load from a full URL.\r
1436  * config.stylesSet = 'mystyles:http://www.example.com/editorstyles/styles.js';\r
1437  * @example\r
1438  * // Load from a list of definitions.\r
1439  * config.stylesSet = [\r
1440  *  { name : 'Strong Emphasis', element : 'strong' },\r
1441  * { name : 'Emphasis', element : 'em' }, ... ];\r
1442  */\r