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