2 Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.
\r
3 For licensing, see LICENSE.html or http://ckeditor.com/license
\r
7 * @file Increse and decrease indent commands.
\r
12 var listNodeNames = { ol : 1, ul : 1 },
\r
13 isNotWhitespaces = CKEDITOR.dom.walker.whitespaces( true ),
\r
14 isNotBookmark = CKEDITOR.dom.walker.bookmark( false, true );
\r
16 function onSelectionChange( evt )
\r
18 var editor = evt.editor;
\r
20 var elementPath = evt.data.path,
\r
21 list = elementPath && elementPath.contains( listNodeNames );
\r
24 return this.setState( CKEDITOR.TRISTATE_OFF );
\r
26 if ( !this.useIndentClasses && this.name == 'indent' )
\r
27 return this.setState( CKEDITOR.TRISTATE_OFF );
\r
29 var path = evt.data.path,
\r
30 firstBlock = path.block || path.blockLimit;
\r
32 return this.setState( CKEDITOR.TRISTATE_DISABLED );
\r
34 if ( this.useIndentClasses )
\r
36 var indentClass = firstBlock.$.className.match( this.classNameRegex ),
\r
40 indentClass = indentClass[1];
\r
41 indentStep = this.indentClassMap[ indentClass ];
\r
43 if ( ( this.name == 'outdent' && !indentStep ) ||
\r
44 ( this.name == 'indent' && indentStep == editor.config.indentClasses.length ) )
\r
45 return this.setState( CKEDITOR.TRISTATE_DISABLED );
\r
46 return this.setState( CKEDITOR.TRISTATE_OFF );
\r
50 var indent = parseInt( firstBlock.getStyle( getIndentCssProperty( firstBlock ) ), 10 );
\r
51 if ( isNaN( indent ) )
\r
54 return this.setState( CKEDITOR.TRISTATE_DISABLED );
\r
55 return this.setState( CKEDITOR.TRISTATE_OFF );
\r
59 function indentCommand( editor, name )
\r
62 this.useIndentClasses = editor.config.indentClasses && editor.config.indentClasses.length > 0;
\r
63 if ( this.useIndentClasses )
\r
65 this.classNameRegex = new RegExp( '(?:^|\\s+)(' + editor.config.indentClasses.join( '|' ) + ')(?=$|\\s)' );
\r
66 this.indentClassMap = {};
\r
67 for ( var i = 0 ; i < editor.config.indentClasses.length ; i++ )
\r
68 this.indentClassMap[ editor.config.indentClasses[i] ] = i + 1;
\r
71 this.startDisabled = name == 'outdent';
\r
74 // Returns the CSS property to be used for identing a given element.
\r
75 function getIndentCssProperty( element, dir )
\r
77 return ( dir || element.getComputedStyle( 'direction' ) ) == 'ltr' ? 'margin-left' : 'margin-right';
\r
80 function isListItem( node )
\r
82 return node.type = CKEDITOR.NODE_ELEMENT && node.is( 'li' );
\r
85 indentCommand.prototype = {
\r
86 exec : function( editor )
\r
88 var self = this, database = {};
\r
90 function indentList( listNode )
\r
92 // Our starting and ending points of the range might be inside some blocks under a list item...
\r
93 // So before playing with the iterator, we need to expand the block to include the list items.
\r
94 var startContainer = range.startContainer,
\r
95 endContainer = range.endContainer;
\r
96 while ( startContainer && !startContainer.getParent().equals( listNode ) )
\r
97 startContainer = startContainer.getParent();
\r
98 while ( endContainer && !endContainer.getParent().equals( listNode ) )
\r
99 endContainer = endContainer.getParent();
\r
101 if ( !startContainer || !endContainer )
\r
104 // Now we can iterate over the individual items on the same tree depth.
\r
105 var block = startContainer,
\r
108 while ( !stopFlag )
\r
110 if ( block.equals( endContainer ) )
\r
112 itemsToMove.push( block );
\r
113 block = block.getNext();
\r
115 if ( itemsToMove.length < 1 )
\r
118 // Do indent or outdent operations on the array model of the list, not the
\r
119 // list's DOM tree itself. The array model demands that it knows as much as
\r
120 // possible about the surrounding lists, we need to feed it the further
\r
121 // ancestor node that is still a list.
\r
122 var listParents = listNode.getParents( true );
\r
123 for ( var i = 0 ; i < listParents.length ; i++ )
\r
125 if ( listParents[i].getName && listNodeNames[ listParents[i].getName() ] )
\r
127 listNode = listParents[i];
\r
131 var indentOffset = self.name == 'indent' ? 1 : -1,
\r
132 startItem = itemsToMove[0],
\r
133 lastItem = itemsToMove[ itemsToMove.length - 1 ];
\r
135 // Convert the list DOM tree into a one dimensional array.
\r
136 var listArray = CKEDITOR.plugins.list.listToArray( listNode, database );
\r
138 // Apply indenting or outdenting on the array.
\r
139 var baseIndent = listArray[ lastItem.getCustomData( 'listarray_index' ) ].indent;
\r
140 for ( i = startItem.getCustomData( 'listarray_index' ); i <= lastItem.getCustomData( 'listarray_index' ); i++ )
\r
142 listArray[ i ].indent += indentOffset;
\r
143 // Make sure the newly created sublist get a brand-new element of the same type. (#5372)
\r
144 var listRoot = listArray[ i ].parent;
\r
145 listArray[ i ].parent = new CKEDITOR.dom.element( listRoot.getName(), listRoot.getDocument() );
\r
148 for ( i = lastItem.getCustomData( 'listarray_index' ) + 1 ;
\r
149 i < listArray.length && listArray[i].indent > baseIndent ; i++ )
\r
150 listArray[i].indent += indentOffset;
\r
152 // Convert the array back to a DOM forest (yes we might have a few subtrees now).
\r
153 // And replace the old list with the new forest.
\r
154 var newList = CKEDITOR.plugins.list.arrayToList( listArray, database, null, editor.config.enterMode, listNode.getDirection() );
\r
156 // Avoid nested <li> after outdent even they're visually same,
\r
157 // recording them for later refactoring.(#3982)
\r
158 if ( self.name == 'outdent' )
\r
160 var parentLiElement;
\r
161 if ( ( parentLiElement = listNode.getParent() ) && parentLiElement.is( 'li' ) )
\r
163 var children = newList.listNode.getChildren(),
\r
165 count = children.count(),
\r
168 for ( i = count - 1 ; i >= 0 ; i-- )
\r
170 if ( ( child = children.getItem( i ) ) && child.is && child.is( 'li' ) )
\r
171 pendingLis.push( child );
\r
177 newList.listNode.replace( listNode );
\r
179 // Move the nested <li> to be appeared after the parent.
\r
180 if ( pendingLis && pendingLis.length )
\r
182 for ( i = 0; i < pendingLis.length ; i++ )
\r
184 var li = pendingLis[ i ],
\r
185 followingList = li;
\r
187 // Nest preceding <ul>/<ol> inside current <li> if any.
\r
188 while ( ( followingList = followingList.getNext() ) &&
\r
189 followingList.is &&
\r
190 followingList.getName() in listNodeNames )
\r
192 // IE requires a filler NBSP for nested list inside empty list item,
\r
193 // otherwise the list item will be inaccessiable. (#4476)
\r
194 if ( CKEDITOR.env.ie && !li.getFirst( function( node ){ return isNotWhitespaces( node ) && isNotBookmark( node ); } ) )
\r
195 li.append( range.document.createText( '\u00a0' ) );
\r
197 li.append( followingList );
\r
200 li.insertAfter( parentLiElement );
\r
205 function indentBlock()
\r
207 var iterator = range.createIterator(),
\r
208 enterMode = editor.config.enterMode;
\r
209 iterator.enforceRealBlocks = true;
\r
210 iterator.enlargeBr = enterMode != CKEDITOR.ENTER_BR;
\r
212 while ( ( block = iterator.getNextParagraph( enterMode == CKEDITOR.ENTER_P ? 'p' : 'div' ) ) )
\r
213 indentElement( block );
\r
216 function indentElement( element, dir )
\r
218 if ( element.getCustomData( 'indent_processed' ) )
\r
221 if ( self.useIndentClasses )
\r
223 // Transform current class name to indent step index.
\r
224 var indentClass = element.$.className.match( self.classNameRegex ),
\r
228 indentClass = indentClass[1];
\r
229 indentStep = self.indentClassMap[ indentClass ];
\r
232 // Operate on indent step index, transform indent step index back to class
\r
234 if ( self.name == 'outdent' )
\r
239 if ( indentStep < 0 )
\r
242 indentStep = Math.min( indentStep, editor.config.indentClasses.length );
\r
243 indentStep = Math.max( indentStep, 0 );
\r
244 element.$.className = CKEDITOR.tools.ltrim( element.$.className.replace( self.classNameRegex, '' ) );
\r
245 if ( indentStep > 0 )
\r
246 element.addClass( editor.config.indentClasses[ indentStep - 1 ] );
\r
250 var indentCssProperty = getIndentCssProperty( element, dir ),
\r
251 currentOffset = parseInt( element.getStyle( indentCssProperty ), 10 );
\r
252 if ( isNaN( currentOffset ) )
\r
254 var indentOffset = editor.config.indentOffset || 40;
\r
255 currentOffset += ( self.name == 'indent' ? 1 : -1 ) * indentOffset;
\r
257 if ( currentOffset < 0 )
\r
260 currentOffset = Math.max( currentOffset, 0 );
\r
261 currentOffset = Math.ceil( currentOffset / indentOffset ) * indentOffset;
\r
262 element.setStyle( indentCssProperty, currentOffset ? currentOffset + ( editor.config.indentUnit || 'px' ) : '' );
\r
263 if ( element.getAttribute( 'style' ) === '' )
\r
264 element.removeAttribute( 'style' );
\r
267 CKEDITOR.dom.element.setMarker( database, element, 'indent_processed', 1 );
\r
271 var selection = editor.getSelection(),
\r
272 bookmarks = selection.createBookmarks( 1 ),
\r
273 ranges = selection && selection.getRanges( 1 ),
\r
277 var iterator = ranges.createIterator();
\r
278 while ( ( range = iterator.getNextRange() ) )
\r
280 var rangeRoot = range.getCommonAncestor(),
\r
281 nearestListBlock = rangeRoot;
\r
283 while ( nearestListBlock && !( nearestListBlock.type == CKEDITOR.NODE_ELEMENT &&
\r
284 listNodeNames[ nearestListBlock.getName() ] ) )
\r
285 nearestListBlock = nearestListBlock.getParent();
\r
287 // Avoid having selection enclose the entire list. (#6138)
\r
288 // [<ul><li>...</li></ul>] =><ul><li>[...]</li></ul>
\r
289 if ( !nearestListBlock )
\r
291 var selectedNode = range.getEnclosedNode();
\r
293 && selectedNode.type == CKEDITOR.NODE_ELEMENT
\r
294 && selectedNode.getName() in listNodeNames)
\r
296 range.setStartAt( selectedNode, CKEDITOR.POSITION_AFTER_START );
\r
297 range.setEndAt( selectedNode, CKEDITOR.POSITION_BEFORE_END );
\r
298 nearestListBlock = selectedNode;
\r
302 // Avoid selection anchors under list root.
\r
303 // <ul>[<li>...</li>]</ul> => <ul><li>[...]</li></ul>
\r
304 if ( nearestListBlock && range.startContainer.type == CKEDITOR.NODE_ELEMENT
\r
305 && range.startContainer.getName() in listNodeNames )
\r
307 var walker = new CKEDITOR.dom.walker( range );
\r
308 walker.evaluator = isListItem;
\r
309 range.startContainer = walker.next();
\r
312 if ( nearestListBlock && range.endContainer.type == CKEDITOR.NODE_ELEMENT
\r
313 && range.endContainer.getName() in listNodeNames )
\r
315 walker = new CKEDITOR.dom.walker( range );
\r
316 walker.evaluator = isListItem;
\r
317 range.endContainer = walker.previous();
\r
320 if ( nearestListBlock )
\r
322 var firstListItem = nearestListBlock.getFirst( isListItem ),
\r
323 hasMultipleItems = !!firstListItem.getNext( isListItem ),
\r
324 rangeStart = range.startContainer,
\r
325 indentWholeList = firstListItem.equals( rangeStart ) || firstListItem.contains( rangeStart );
\r
327 // Indent the entire list if cursor is inside the first list item. (#3893)
\r
328 // Only do that for indenting or when using indent classes or when there is something to outdent. (#6141)
\r
329 if ( !( indentWholeList &&
\r
330 ( self.name == 'indent' || self.useIndentClasses || parseInt( nearestListBlock.getStyle( getIndentCssProperty( nearestListBlock ) ), 10 ) ) &&
\r
331 indentElement( nearestListBlock, !hasMultipleItems && firstListItem.getDirection() ) ) )
\r
332 indentList( nearestListBlock );
\r
338 // Clean up the markers.
\r
339 CKEDITOR.dom.element.clearAllMarkers( database );
\r
341 editor.forceNextSelectionCheck();
\r
342 selection.selectBookmarks( bookmarks );
\r
346 CKEDITOR.plugins.add( 'indent',
\r
348 init : function( editor )
\r
350 // Register commands.
\r
351 var indent = editor.addCommand( 'indent', new indentCommand( editor, 'indent' ) ),
\r
352 outdent = editor.addCommand( 'outdent', new indentCommand( editor, 'outdent' ) );
\r
354 // Register the toolbar buttons.
\r
355 editor.ui.addButton( 'Indent',
\r
357 label : editor.lang.indent,
\r
360 editor.ui.addButton( 'Outdent',
\r
362 label : editor.lang.outdent,
\r
363 command : 'outdent'
\r
366 // Register the state changing handlers.
\r
367 editor.on( 'selectionChange', CKEDITOR.tools.bind( onSelectionChange, indent ) );
\r
368 editor.on( 'selectionChange', CKEDITOR.tools.bind( onSelectionChange, outdent ) );
\r
370 // [IE6/7] Raw lists are using margin instead of padding for visual indentation in wysiwyg mode. (#3893)
\r
371 if ( CKEDITOR.env.ie6Compat || CKEDITOR.env.ie7Compat )
\r
376 " margin-left: 0px;" +
\r
377 " padding-left: 40px;" +
\r
381 // Register dirChanged listener.
\r
382 editor.on( 'dirChanged', function( e )
\r
384 var range = new CKEDITOR.dom.range( editor.document );
\r
385 range.setStartBefore( e.data.node );
\r
386 range.setEndAfter( e.data.node );
\r
388 var walker = new CKEDITOR.dom.walker( range ),
\r
391 while ( ( node = walker.next() ) )
\r
393 if ( node.type == CKEDITOR.NODE_ELEMENT )
\r
395 // A child with the defined dir is to be ignored.
\r
396 if ( !node.equals( e.data.node ) && node.getDirection() )
\r
398 range.setStartAfter( node );
\r
399 walker = new CKEDITOR.dom.walker( range );
\r
403 // Switch alignment classes.
\r
404 var classes = editor.config.indentClasses;
\r
407 var suffix = ( e.data.dir == 'ltr' ) ? [ '_rtl', '' ] : [ '', '_rtl' ];
\r
408 for ( var i = 0; i < classes.length; i++ )
\r
410 if ( node.hasClass( classes[ i ] + suffix[ 0 ] ) )
\r
412 node.removeClass( classes[ i ] + suffix[ 0 ] );
\r
413 node.addClass( classes[ i ] + suffix[ 1 ] );
\r
418 // Switch the margins.
\r
419 var marginLeft = node.getStyle( 'margin-right' ),
\r
420 marginRight = node.getStyle( 'margin-left' );
\r
422 marginLeft ? node.setStyle( 'margin-left', marginLeft ) : node.removeStyle( 'margin-left' );
\r
423 marginRight ? node.setStyle( 'margin-right', marginRight ) : node.removeStyle( 'margin-right' );
\r
429 requires : [ 'domiterator', 'list' ]
\r
434 * Size of each indentation step
\r
435 * @name CKEDITOR.config.indentOffset
\r
439 * config.indentOffset = 4;
\r
443 * Unit for the indentation style
\r
444 * @name CKEDITOR.config.indentUnit
\r
448 * config.indentUnit = 'em';
\r
452 * List of classes to use for indenting the contents. If it's null, no classes will be used
\r
453 * and instead the {@link #indentUnit} and {@link #indentOffset} properties will be used.
\r
454 * @name CKEDITOR.config.indentClasses
\r
458 * // Use the classes 'Indent1', 'Indent2', 'Indent3'
\r
459 * config.indentClasses = ['Indent1', 'Indent2', 'Indent3'];
\r