_source/plugins/indent/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 /**\r
   7  * @file Increse and decrease indent commands.\r
   8  */\r
   9 \r
  10 (function()\r
  11 {\r
  12         var listNodeNames = { ol : 1, ul : 1 };\r
  13 \r
  14         var isNotWhitespaces = CKEDITOR.dom.walker.whitespaces( true ),\r
  15                 isNotBookmark = CKEDITOR.dom.walker.bookmark( false, true );\r
  16 \r
  17         function setState( editor, state )\r
  18         {\r
  19                 editor.getCommand( this.name ).setState( state );\r
  20         }\r
  21 \r
  22         function onSelectionChange( evt )\r
  23         {\r
  24                 var editor = evt.editor;\r
  25 \r
  26                 var elementPath = evt.data.path,\r
  27                                 list = elementPath && elementPath.contains( listNodeNames );\r
  28 \r
  29                 if ( list )\r
  30                                 return setState.call( this, editor, CKEDITOR.TRISTATE_OFF );\r
  31 \r
  32                 if ( !this.useIndentClasses && this.name == 'indent' )\r
  33                         return setState.call( this, editor, CKEDITOR.TRISTATE_OFF );\r
  34 \r
  35                 var path = evt.data.path,\r
  36                         firstBlock = path.block || path.blockLimit;\r
  37                 if ( !firstBlock )\r
  38                         return setState.call( this, editor, CKEDITOR.TRISTATE_DISABLED );\r
  39 \r
  40                 if ( this.useIndentClasses )\r
  41                 {\r
  42                         var indentClass = firstBlock.$.className.match( this.classNameRegex ),\r
  43                                 indentStep = 0;\r
  44                         if ( indentClass )\r
  45                         {\r
  46                                 indentClass = indentClass[1];\r
  47                                 indentStep = this.indentClassMap[ indentClass ];\r
  48                         }\r
  49                         if ( ( this.name == 'outdent' && !indentStep ) ||\r
  50                                         ( this.name == 'indent' && indentStep == editor.config.indentClasses.length ) )\r
  51                                 return setState.call( this, editor, CKEDITOR.TRISTATE_DISABLED );\r
  52                         return setState.call( this, editor, CKEDITOR.TRISTATE_OFF );\r
  53                 }\r
  54                 else\r
  55                 {\r
  56                         var indent = parseInt( firstBlock.getStyle( getIndentCssProperty( firstBlock ) ), 10 );\r
  57                         if ( isNaN( indent ) )\r
  58                                 indent = 0;\r
  59                         if ( indent <= 0 )\r
  60                                 return setState.call( this, editor, CKEDITOR.TRISTATE_DISABLED );\r
  61                         return setState.call( this, editor, CKEDITOR.TRISTATE_OFF );\r
  62                 }\r
  63         }\r
  64 \r
  65         function indentCommand( editor, name )\r
  66         {\r
  67                 this.name = name;\r
  68                 this.useIndentClasses = editor.config.indentClasses && editor.config.indentClasses.length > 0;\r
  69                 if ( this.useIndentClasses )\r
  70                 {\r
  71                         this.classNameRegex = new RegExp( '(?:^|\\s+)(' + editor.config.indentClasses.join( '|' ) + ')(?=$|\\s)' );\r
  72                         this.indentClassMap = {};\r
  73                         for ( var i = 0 ; i < editor.config.indentClasses.length ; i++ )\r
  74                                 this.indentClassMap[ editor.config.indentClasses[i] ] = i + 1;\r
  75                 }\r
  76 \r
  77                 this.startDisabled = name == 'outdent';\r
  78         }\r
  79 \r
  80         // Returns the CSS property to be used for identing a given element.\r
  81         function getIndentCssProperty( element, dir )\r
  82         {\r
  83                 return ( dir || element.getComputedStyle( 'direction' ) ) == 'ltr' ? 'margin-left' : 'margin-right';\r
  84         }\r
  85 \r
  86         function isListItem( node )\r
  87         {\r
  88                 return node.type = CKEDITOR.NODE_ELEMENT && node.is( 'li' );\r
  89         }\r
  90 \r
  91         indentCommand.prototype = {\r
  92                 exec : function( editor )\r
  93                 {\r
  94                         var self = this, database = {};\r
  95 \r
  96                         function indentList( listNode )\r
  97                         {\r
  98                                 // Our starting and ending points of the range might be inside some blocks under a list item...\r
  99                                 // So before playing with the iterator, we need to expand the block to include the list items.\r
 100                                 var startContainer = range.startContainer,\r
 101                                         endContainer = range.endContainer;\r
 102                                 while ( startContainer && !startContainer.getParent().equals( listNode ) )\r
 103                                         startContainer = startContainer.getParent();\r
 104                                 while ( endContainer && !endContainer.getParent().equals( listNode ) )\r
 105                                         endContainer = endContainer.getParent();\r
 106 \r
 107                                 if ( !startContainer || !endContainer )\r
 108                                         return;\r
 109 \r
 110                                 // Now we can iterate over the individual items on the same tree depth.\r
 111                                 var block = startContainer,\r
 112                                         itemsToMove = [],\r
 113                                         stopFlag = false;\r
 114                                 while ( !stopFlag )\r
 115                                 {\r
 116                                         if ( block.equals( endContainer ) )\r
 117                                                 stopFlag = true;\r
 118                                         itemsToMove.push( block );\r
 119                                         block = block.getNext();\r
 120                                 }\r
 121                                 if ( itemsToMove.length < 1 )\r
 122                                         return;\r
 123 \r
 124                                 // Do indent or outdent operations on the array model of the list, not the\r
 125                                 // list's DOM tree itself. The array model demands that it knows as much as\r
 126                                 // possible about the surrounding lists, we need to feed it the further\r
 127                                 // ancestor node that is still a list.\r
 128                                 var listParents = listNode.getParents( true );\r
 129                                 for ( var i = 0 ; i < listParents.length ; i++ )\r
 130                                 {\r
 131                                         if ( listParents[i].getName && listNodeNames[ listParents[i].getName() ] )\r
 132                                         {\r
 133                                                 listNode = listParents[i];\r
 134                                                 break;\r
 135                                         }\r
 136                                 }\r
 137                                 var indentOffset = self.name == 'indent' ? 1 : -1,\r
 138                                         startItem = itemsToMove[0],\r
 139                                         lastItem = itemsToMove[ itemsToMove.length - 1 ];\r
 140 \r
 141                                 // Convert the list DOM tree into a one dimensional array.\r
 142                                 var listArray = CKEDITOR.plugins.list.listToArray( listNode, database );\r
 143 \r
 144                                 // Apply indenting or outdenting on the array.\r
 145                                 var baseIndent = listArray[ lastItem.getCustomData( 'listarray_index' ) ].indent;\r
 146                                 for ( i = startItem.getCustomData( 'listarray_index' ); i <= lastItem.getCustomData( 'listarray_index' ); i++ )\r
 147                                 {\r
 148                                         listArray[ i ].indent += indentOffset;\r
 149                                         // Make sure the newly created sublist get a brand-new element of the same type. (#5372)\r
 150                                         var listRoot = listArray[ i ].parent;\r
 151                                         listArray[ i ].parent = new CKEDITOR.dom.element( listRoot.getName(), listRoot.getDocument() );\r
 152                                 }\r
 153 \r
 154                                 for ( i = lastItem.getCustomData( 'listarray_index' ) + 1 ;\r
 155                                                 i < listArray.length && listArray[i].indent > baseIndent ; i++ )\r
 156                                         listArray[i].indent += indentOffset;\r
 157 \r
 158                                 // Convert the array back to a DOM forest (yes we might have a few subtrees now).\r
 159                                 // And replace the old list with the new forest.\r
 160                                 var newList = CKEDITOR.plugins.list.arrayToList( listArray, database, null, editor.config.enterMode, listNode.getDirection() );\r
 161 \r
 162                                 // Avoid nested <li> after outdent even they're visually same,\r
 163                                 // recording them for later refactoring.(#3982)\r
 164                                 if ( self.name == 'outdent' )\r
 165                                 {\r
 166                                         var parentLiElement;\r
 167                                         if ( ( parentLiElement = listNode.getParent() ) && parentLiElement.is( 'li' ) )\r
 168                                         {\r
 169                                                 var children = newList.listNode.getChildren(),\r
 170                                                         pendingLis = [],\r
 171                                                         count = children.count(),\r
 172                                                         child;\r
 173 \r
 174                                                 for ( i = count - 1 ; i >= 0 ; i-- )\r
 175                                                 {\r
 176                                                         if ( ( child = children.getItem( i ) ) && child.is && child.is( 'li' )  )\r
 177                                                                 pendingLis.push( child );\r
 178                                                 }\r
 179                                         }\r
 180                                 }\r
 181 \r
 182                                 if ( newList )\r
 183                                         newList.listNode.replace( listNode );\r
 184 \r
 185                                 // Move the nested <li> to be appeared after the parent.\r
 186                                 if ( pendingLis && pendingLis.length )\r
 187                                 {\r
 188                                         for (  i = 0; i < pendingLis.length ; i++ )\r
 189                                         {\r
 190                                                 var li = pendingLis[ i ],\r
 191                                                         followingList = li;\r
 192 \r
 193                                                 // Nest preceding <ul>/<ol> inside current <li> if any.\r
 194                                                 while ( ( followingList = followingList.getNext() ) &&\r
 195                                                            followingList.is &&\r
 196                                                            followingList.getName() in listNodeNames )\r
 197                                                 {\r
 198                                                         // IE requires a filler NBSP for nested list inside empty list item,\r
 199                                                         // otherwise the list item will be inaccessiable. (#4476)\r
 200                                                         if ( CKEDITOR.env.ie && !li.getFirst( function( node ){ return isNotWhitespaces( node ) && isNotBookmark( node ); } ) )\r
 201                                                                 li.append( range.document.createText( '\u00a0' ) );\r
 202 \r
 203                                                         li.append( followingList );\r
 204                                                 }\r
 205 \r
 206                                                 li.insertAfter( parentLiElement );\r
 207                                         }\r
 208                                 }\r
 209                         }\r
 210 \r
 211                         function indentBlock()\r
 212                         {\r
 213                                 var iterator = range.createIterator(),\r
 214                                         enterMode = editor.config.enterMode;\r
 215                                 iterator.enforceRealBlocks = true;\r
 216                                 iterator.enlargeBr = enterMode != CKEDITOR.ENTER_BR;\r
 217                                 var block;\r
 218                                 while ( ( block = iterator.getNextParagraph() ) )\r
 219                                         indentElement( block );\r
 220                         }\r
 221 \r
 222                         function indentElement( element, dir )\r
 223                         {\r
 224                                 if ( element.getCustomData( 'indent_processed' ) )\r
 225                                         return false;\r
 226 \r
 227                                 if ( self.useIndentClasses )\r
 228                                 {\r
 229                                         // Transform current class name to indent step index.\r
 230                                         var indentClass = element.$.className.match( self.classNameRegex ),\r
 231                                                         indentStep = 0;\r
 232                                         if ( indentClass )\r
 233                                         {\r
 234                                                 indentClass = indentClass[1];\r
 235                                                 indentStep = self.indentClassMap[ indentClass ];\r
 236                                         }\r
 237 \r
 238                                         // Operate on indent step index, transform indent step index back to class\r
 239                                         // name.\r
 240                                         if ( self.name == 'outdent' )\r
 241                                                 indentStep--;\r
 242                                         else\r
 243                                                 indentStep++;\r
 244 \r
 245                                         if ( indentStep < 0 )\r
 246                                                 return false;\r
 247 \r
 248                                         indentStep = Math.min( indentStep, editor.config.indentClasses.length );\r
 249                                         indentStep = Math.max( indentStep, 0 );\r
 250                                         element.$.className = CKEDITOR.tools.ltrim( element.$.className.replace( self.classNameRegex, '' ) );\r
 251                                         if ( indentStep > 0 )\r
 252                                                 element.addClass( editor.config.indentClasses[ indentStep - 1 ] );\r
 253                                 }\r
 254                                 else\r
 255                                 {\r
 256                                         var indentCssProperty = getIndentCssProperty( element, dir ),\r
 257                                                 currentOffset = parseInt( element.getStyle( indentCssProperty ), 10 );\r
 258                                         if ( isNaN( currentOffset ) )\r
 259                                                 currentOffset = 0;\r
 260                                         var indentOffset = editor.config.indentOffset || 40;\r
 261                                         currentOffset += ( self.name == 'indent' ? 1 : -1 ) * indentOffset;\r
 262 \r
 263                                         if ( currentOffset < 0 )\r
 264                                                 return false;\r
 265 \r
 266                                         currentOffset = Math.max( currentOffset, 0 );\r
 267                                         currentOffset = Math.ceil( currentOffset / indentOffset ) * indentOffset;\r
 268                                         element.setStyle( indentCssProperty, currentOffset ? currentOffset + ( editor.config.indentUnit || 'px' ) : '' );\r
 269                                         if ( element.getAttribute( 'style' ) === '' )\r
 270                                                 element.removeAttribute( 'style' );\r
 271                                 }\r
 272 \r
 273                                 CKEDITOR.dom.element.setMarker( database, element, 'indent_processed', 1 );\r
 274                                 return true;\r
 275                         }\r
 276 \r
 277                         var selection = editor.getSelection(),\r
 278                                 bookmarks = selection.createBookmarks( 1 ),\r
 279                                 ranges = selection && selection.getRanges( 1 ),\r
 280                                 range;\r
 281 \r
 282 \r
 283                         var iterator = ranges.createIterator();\r
 284                         while ( ( range = iterator.getNextRange() ) )\r
 285                         {\r
 286                                 var rangeRoot = range.getCommonAncestor(),\r
 287                                         nearestListBlock = rangeRoot;\r
 288 \r
 289                                 while ( nearestListBlock && !( nearestListBlock.type == CKEDITOR.NODE_ELEMENT &&\r
 290                                         listNodeNames[ nearestListBlock.getName() ] ) )\r
 291                                         nearestListBlock = nearestListBlock.getParent();\r
 292 \r
 293                                 // Avoid having selection enclose the entire list. (#6138)\r
 294                                 // [<ul><li>...</li></ul>] =><ul><li>[...]</li></ul>\r
 295                                 if ( !nearestListBlock )\r
 296                                 {\r
 297                                         var selectedNode = range.getEnclosedNode();\r
 298                                         if ( selectedNode\r
 299                                                 && selectedNode.type == CKEDITOR.NODE_ELEMENT\r
 300                                                 && selectedNode.getName() in listNodeNames)\r
 301                                         {\r
 302                                                 range.setStartAt( selectedNode, CKEDITOR.POSITION_AFTER_START );\r
 303                                                 range.setEndAt( selectedNode, CKEDITOR.POSITION_BEFORE_END );\r
 304                                                 nearestListBlock = selectedNode;\r
 305                                         }\r
 306                                 }\r
 307 \r
 308                                 // Avoid selection anchors under list root.\r
 309                                 // <ul>[<li>...</li>]</ul> =>   <ul><li>[...]</li></ul>\r
 310                                 if ( nearestListBlock && range.startContainer.type == CKEDITOR.NODE_ELEMENT\r
 311                                         && range.startContainer.getName() in listNodeNames )\r
 312                                 {\r
 313                                         var walker = new CKEDITOR.dom.walker( range );\r
 314                                         walker.evaluator = isListItem;\r
 315                                         range.startContainer = walker.next();\r
 316                                 }\r
 317 \r
 318                                 if ( nearestListBlock && range.endContainer.type == CKEDITOR.NODE_ELEMENT\r
 319                                         && range.endContainer.getName() in listNodeNames )\r
 320                                 {\r
 321                                         walker = new CKEDITOR.dom.walker( range );\r
 322                                         walker.evaluator = isListItem;\r
 323                                         range.endContainer = walker.previous();\r
 324                                 }\r
 325 \r
 326                                 if ( nearestListBlock )\r
 327                                 {\r
 328                                         var firstListItem = nearestListBlock.getFirst( isListItem ),\r
 329                                                 hasMultipleItems = !!firstListItem.getNext( isListItem ),\r
 330                                                 rangeStart = range.startContainer,\r
 331                                                 indentWholeList = firstListItem.equals( rangeStart ) || firstListItem.contains( rangeStart );\r
 332 \r
 333                                         // Indent the entire list if cursor is inside the first list item. (#3893)\r
 334                                         // Only do that for indenting or when using indent classes or when there is something to outdent. (#6141)\r
 335                                         if ( !( indentWholeList &&\r
 336                                                 ( self.name == 'indent' || self.useIndentClasses || parseInt( nearestListBlock.getStyle( getIndentCssProperty( nearestListBlock ) ), 10 ) ) &&\r
 337                                                         indentElement( nearestListBlock, !hasMultipleItems && firstListItem.getDirection() ) ) )\r
 338                                                                 indentList( nearestListBlock );\r
 339                                 }\r
 340                                 else\r
 341                                         indentBlock();\r
 342                         }\r
 343 \r
 344                         // Clean up the markers.\r
 345                         CKEDITOR.dom.element.clearAllMarkers( database );\r
 346 \r
 347                         editor.forceNextSelectionCheck();\r
 348                         selection.selectBookmarks( bookmarks );\r
 349                 }\r
 350         };\r
 351 \r
 352         CKEDITOR.plugins.add( 'indent',\r
 353         {\r
 354                 init : function( editor )\r
 355                 {\r
 356                         // Register commands.\r
 357                         var indent = new indentCommand( editor, 'indent' ),\r
 358                                 outdent = new indentCommand( editor, 'outdent' );\r
 359                         editor.addCommand( 'indent', indent );\r
 360                         editor.addCommand( 'outdent', outdent );\r
 361 \r
 362                         // Register the toolbar buttons.\r
 363                         editor.ui.addButton( 'Indent',\r
 364                                 {\r
 365                                         label : editor.lang.indent,\r
 366                                         command : 'indent'\r
 367                                 });\r
 368                         editor.ui.addButton( 'Outdent',\r
 369                                 {\r
 370                                         label : editor.lang.outdent,\r
 371                                         command : 'outdent'\r
 372                                 });\r
 373 \r
 374                         // Register the state changing handlers.\r
 375                         editor.on( 'selectionChange', CKEDITOR.tools.bind( onSelectionChange, indent ) );\r
 376                         editor.on( 'selectionChange', CKEDITOR.tools.bind( onSelectionChange, outdent ) );\r
 377 \r
 378                         // [IE6/7] Raw lists are using margin instead of padding for visual indentation in wysiwyg mode. (#3893)\r
 379                         if ( CKEDITOR.env.ie6Compat || CKEDITOR.env.ie7Compat )\r
 380                         {\r
 381                                 editor.addCss(\r
 382                                         "ul,ol" +\r
 383                                         "{" +\r
 384                                         "       margin-left: 0px;" +\r
 385                                         "       padding-left: 40px;" +\r
 386                                         "}" );\r
 387                         }\r
 388 \r
 389                         // Register dirChanged listener.\r
 390                         editor.on( 'dirChanged', function( e )\r
 391                         {\r
 392                                 var range = new CKEDITOR.dom.range( editor.document );\r
 393                                 range.setStartBefore( e.data.node );\r
 394                                 range.setEndAfter( e.data.node );\r
 395 \r
 396                                 var walker = new CKEDITOR.dom.walker( range ),\r
 397                                         node;\r
 398 \r
 399                                 while ( ( node = walker.next() ) )\r
 400                                 {\r
 401                                         if ( node.type == CKEDITOR.NODE_ELEMENT )\r
 402                                         {\r
 403                                                 // A child with the defined dir is to be ignored.\r
 404                                                 if ( !node.equals( e.data.node ) && node.getDirection() )\r
 405                                                 {\r
 406                                                         range.setStartAfter( node );\r
 407                                                         walker = new CKEDITOR.dom.walker( range );\r
 408                                                         continue;\r
 409                                                 }\r
 410 \r
 411                                                 // Switch alignment classes.\r
 412                                                 var classes = editor.config.indentClasses;\r
 413                                                 if ( classes )\r
 414                                                 {\r
 415                                                         var suffix = ( e.data.dir == 'ltr' ) ? [ '_rtl', '' ] : [ '', '_rtl' ];\r
 416                                                         for ( var i = 0; i < classes.length; i++ )\r
 417                                                         {\r
 418                                                                 if ( node.hasClass( classes[ i ] + suffix[ 0 ] ) )\r
 419                                                                 {\r
 420                                                                         node.removeClass( classes[ i ] + suffix[ 0 ] );\r
 421                                                                         node.addClass( classes[ i ] + suffix[ 1 ] );\r
 422                                                                 }\r
 423                                                         }\r
 424                                                 }\r
 425 \r
 426                                                 // Switch the margins.\r
 427                                                 var marginLeft = node.getStyle( 'margin-right' ),\r
 428                                                         marginRight = node.getStyle( 'margin-left' );\r
 429 \r
 430                                                 marginLeft ? node.setStyle( 'margin-left', marginLeft ) : node.removeStyle( 'margin-left' );\r
 431                                                 marginRight ? node.setStyle( 'margin-right', marginRight ) : node.removeStyle( 'margin-right' );\r
 432                                         }\r
 433                                 }\r
 434                         });\r
 435                 },\r
 436 \r
 437                 requires : [ 'domiterator', 'list' ]\r
 438         } );\r
 439 })();\r
 440 \r
 441 /**\r
 442  * Size of each indentation step\r
 443  * @name CKEDITOR.config.indentOffset\r
 444  * @type Number\r
 445  * @default 40\r
 446  * @example\r
 447  * config.indentOffset = 4;\r
 448  */\r
 449 \r
 450  /**\r
 451  * Unit for the indentation style\r
 452  * @name CKEDITOR.config.indentUnit\r
 453  * @type String\r
 454  * @default 'px'\r
 455  * @example\r
 456  * config.indentUnit = 'em';\r
 457  */\r
 458 \r
 459  /**\r
 460  * List of classes to use for indenting the contents. If it's null, no classes will be used\r
 461  * and instead the {@link #indentUnit} and {@link #indentOffset} properties will be used.\r
 462  * @name CKEDITOR.config.indentClasses\r
 463  * @type Array\r
 464  * default null\r
 465  * @example\r
 466  * // Use the classes 'Indent1', 'Indent2', 'Indent3'\r
 467  * config.indentClasses = ['Indent1', 'Indent2', 'Indent3'];\r
 468  */\r