/* Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved. For licensing, see LICENSE.html or http://ckeditor.com/license */ (function() { CKEDITOR.plugins.add( 'enterkey', { requires : [ 'keystrokes', 'indent' ], init : function( editor ) { var specialKeys = editor.specialKeys; specialKeys[ 13 ] = enter; specialKeys[ CKEDITOR.SHIFT + 13 ] = shiftEnter; } }); CKEDITOR.plugins.enterkey = { enterBlock : function( editor, mode, range, forceMode ) { // Get the range for the current selection. range = range || getRange( editor ); var doc = range.document; // Exit the list when we're inside an empty list item block. (#5376) if ( range.checkStartOfBlock() && range.checkEndOfBlock() ) { var path = new CKEDITOR.dom.elementPath( range.startContainer ), block = path.block; if ( block.is( 'li' ) || block.getParent().is( 'li' ) ) { editor.execCommand( 'outdent' ); return; } } // Determine the block element to be used. var blockTag = ( mode == CKEDITOR.ENTER_DIV ? 'div' : 'p' ); // Split the range. var splitInfo = range.splitBlock( blockTag ); if ( !splitInfo ) return; // Get the current blocks. var previousBlock = splitInfo.previousBlock, nextBlock = splitInfo.nextBlock; var isStartOfBlock = splitInfo.wasStartOfBlock, isEndOfBlock = splitInfo.wasEndOfBlock; var node; // If this is a block under a list item, split it as well. (#1647) if ( nextBlock ) { node = nextBlock.getParent(); if ( node.is( 'li' ) ) { nextBlock.breakParent( node ); nextBlock.move( nextBlock.getNext(), true ); } } else if ( previousBlock && ( node = previousBlock.getParent() ) && node.is( 'li' ) ) { previousBlock.breakParent( node ); range.moveToElementEditStart( previousBlock.getNext() ); previousBlock.move( previousBlock.getPrevious() ); } // If we have both the previous and next blocks, it means that the // boundaries were on separated blocks, or none of them where on the // block limits (start/end). if ( !isStartOfBlock && !isEndOfBlock ) { // If the next block is an
(#4711). if ( isPre && !CKEDITOR.env.gecko ) lineBreak = doc.createText( CKEDITOR.env.ie ? '\r' : '\n' ); else lineBreak = doc.createElement( 'br' ); range.deleteContents(); range.insertNode( lineBreak ); // A text node is required by Gecko only to make the cursor blink. // We need some text inside of it, so the bogus
is properly // created. if ( !CKEDITOR.env.ie ) doc.createText( '\ufeff' ).insertAfter( lineBreak ); // If we are at the end of a block, we must be sure the bogus node is available in that block. if ( isEndOfBlock && !CKEDITOR.env.ie ) lineBreak.getParent().appendBogus(); // Now we can remove the text node contents, so the caret doesn't // stop on it. if ( !CKEDITOR.env.ie ) lineBreak.getNext().$.nodeValue = ''; // IE has different behavior regarding position. if ( CKEDITOR.env.ie ) range.setStartAt( lineBreak, CKEDITOR.POSITION_AFTER_END ); else range.setStartAt( lineBreak.getNext(), CKEDITOR.POSITION_AFTER_START ); // Scroll into view, for non IE. if ( !CKEDITOR.env.ie ) { var dummy = null; // BR is not positioned in Opera and Webkit. if ( !CKEDITOR.env.gecko ) { dummy = doc.createElement( 'span' ); // We need have some contents for Webkit to position it // under parent node. ( #3681) dummy.setHtml(' '); } else dummy = doc.createElement( 'br' ); dummy.insertBefore( lineBreak.getNext() ); dummy.scrollIntoView(); dummy.remove(); } } // This collapse guarantees the cursor will be blinking. range.collapse( true ); range.select( isPre ); } }; var plugin = CKEDITOR.plugins.enterkey, enterBr = plugin.enterBr, enterBlock = plugin.enterBlock, headerTagRegex = /^h[1-6]$/; function shiftEnter( editor ) { // On SHIFT+ENTER we want to enforce the mode to be respected, instead // of cloning the current block. (#77) return enter( editor, editor.config.shiftEnterMode, true ); } function enter( editor, mode, forceMode ) { forceMode = editor.config.forceEnterMode || forceMode; // Only effective within document. if ( editor.mode != 'wysiwyg' ) return false; if ( !mode ) mode = editor.config.enterMode; // Use setTimout so the keys get cancelled immediatelly. setTimeout( function() { editor.fire( 'saveSnapshot' ); // Save undo step. if ( mode == CKEDITOR.ENTER_BR || editor.getSelection().getStartElement().hasAscendant( 'pre', true ) ) enterBr( editor, mode, null, forceMode ); else enterBlock( editor, mode, null, forceMode ); }, 0 ); return true; } function getRange( editor ) { // Get the selection ranges. var ranges = editor.getSelection().getRanges(); // Delete the contents of all ranges except the first one. for ( var i = ranges.length - 1 ; i > 0 ; i-- ) { ranges[ i ].deleteContents(); } // Return the first range. return ranges[ 0 ]; } })();