X-Git-Url: https://jasonwoof.com/gitweb/?a=blobdiff_plain;f=_source%2Fplugins%2Fenterkey%2Fplugin.js;h=cce120845273ce847a3ef1547c12e26a60e745e6;hb=e7789c1ad838194d45eeee6ac2eb6e55f5cf35a1;hp=d171ae25df78b28ed09d2c13fc7e7e4ba3e18254;hpb=ea7e3453c7b0f023b050aca6d9f83ab372860d91;p=ckeditor.git diff --git a/_source/plugins/enterkey/plugin.js b/_source/plugins/enterkey/plugin.js index d171ae2..cce1208 100644 --- a/_source/plugins/enterkey/plugin.js +++ b/_source/plugins/enterkey/plugin.js @@ -1,5 +1,5 @@ /* -Copyright (c) 2003-2009, CKSource - Frederico Knabben. All rights reserved. +Copyright (c) 2003-2010, CKSource - Frederico Knabben. All rights reserved. For licensing, see LICENSE.html or http://ckeditor.com/license */ @@ -17,296 +17,311 @@ For licensing, see LICENSE.html or http://ckeditor.com/license } }); - var forceMode, - 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) - forceMode = 1; - - return enter( editor, editor.config.shiftEnterMode ); - } - - function enter( editor, mode ) + CKEDITOR.plugins.enterkey = { - // Only effective within document. - if ( editor.mode != 'wysiwyg' ) - return false; + enterBlock : function( editor, mode, range, forceMode ) + { + // Get the range for the current selection. + range = range || getRange( editor ); - if ( !mode ) - mode = editor.config.enterMode; + var doc = range.document; - // Use setTimout so the keys get cancelled immediatelly. - setTimeout( function() + // Exit the list when we're inside an empty list item block. (#5376) + if ( range.checkStartOfBlock() && range.checkEndOfBlock() ) { - editor.fire( 'saveSnapshot' ); // Save undo step. - if ( mode == CKEDITOR.ENTER_BR || editor.getSelection().getStartElement().hasAscendant( 'pre', true ) ) - enterBr( editor, mode ); - else - enterBlock( editor, mode ); - - forceMode = 0; - }, 0 ); + var path = new CKEDITOR.dom.elementPath( range.startContainer ), + block = path.block; - return true; - } - - function enterBlock( editor, mode, range ) - { - // Get the range for the current selection. - range = range || getRange( editor ); - - var doc = range.document; + 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' ); + // Determine the block element to be used. + var blockTag = ( mode == CKEDITOR.ENTER_DIV ? 'div' : 'p' ); - // Split the range. - var splitInfo = range.splitBlock( blockTag ); + // Split the range. + var splitInfo = range.splitBlock( blockTag ); - if ( !splitInfo ) - return; + if ( !splitInfo ) + return; - // Get the current blocks. - var previousBlock = splitInfo.previousBlock, - nextBlock = splitInfo.nextBlock; + // Get the current blocks. + var previousBlock = splitInfo.previousBlock, + nextBlock = splitInfo.nextBlock; - var isStartOfBlock = splitInfo.wasStartOfBlock, - isEndOfBlock = splitInfo.wasEndOfBlock; + var isStartOfBlock = splitInfo.wasStartOfBlock, + isEndOfBlock = splitInfo.wasEndOfBlock; - var node; + 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' ) ) + // 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' ) ) { - nextBlock.breakParent( node ); - nextBlock.move( nextBlock.getNext(), true ); + previousBlock.breakParent( node ); + range.moveToElementEditStart( previousBlock.getNext() ); + previousBlock.move( previousBlock.getPrevious() ); } - } - 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
  • with another list tree as the first - // child, we'll need to append a placeholder or the list item - // wouldn't be editable. (#1420) - if ( nextBlock.is( 'li' ) && ( node = nextBlock.getFirst() ) - && node.is && node.is( 'ul', 'ol') ) - nextBlock.insertBefore( doc.createText( '\xa0' ), node ); - - // Move the selection to the end block. - if ( nextBlock ) - range.moveToElementEditStart( nextBlock ); - } - else - { - - if ( isStartOfBlock && isEndOfBlock && previousBlock.is( 'li' ) ) + // 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 ) { - editor.execCommand( 'outdent' ); - return; + // If the next block is an
  • with another list tree as the first + // child, we'll need to append a filler (
    /NBSP) or the list item + // wouldn't be editable. (#1420) + if ( nextBlock.is( 'li' ) + && ( node = nextBlock.getFirst( CKEDITOR.dom.walker.invisible( true ) ) ) + && node.is && node.is( 'ul', 'ol' ) ) + ( CKEDITOR.env.ie ? doc.createText( '\xa0' ) : doc.createElement( 'br' ) ).insertBefore( node ); + + // Move the selection to the end block. + if ( nextBlock ) + range.moveToElementEditStart( nextBlock ); } - - var newBlock; - - if ( previousBlock ) + else { - // Do not enter this block if it's a header tag, or we are in - // a Shift+Enter (#77). Create a new block element instead - // (later in the code). - if ( !forceMode && !headerTagRegex.test( previousBlock.getName() ) ) + var newBlock; + + if ( previousBlock ) { - // Otherwise, duplicate the previous block. - newBlock = previousBlock.clone(); + // Do not enter this block if it's a header tag, or we are in + // a Shift+Enter (#77). Create a new block element instead + // (later in the code). + if ( previousBlock.is( 'li' ) || + !( forceMode || headerTagRegex.test( previousBlock.getName() ) ) ) + { + // Otherwise, duplicate the previous block. + newBlock = previousBlock.clone(); + } } - } - else if ( nextBlock ) - newBlock = nextBlock.clone(); + else if ( nextBlock ) + newBlock = nextBlock.clone(); - if ( !newBlock ) - newBlock = doc.createElement( blockTag ); + if ( !newBlock ) + newBlock = doc.createElement( blockTag ); - // Recreate the inline elements tree, which was available - // before hitting enter, so the same styles will be available in - // the new block. - var elementPath = splitInfo.elementPath; - if ( elementPath ) - { - for ( var i = 0, len = elementPath.elements.length ; i < len ; i++ ) + // Recreate the inline elements tree, which was available + // before hitting enter, so the same styles will be available in + // the new block. + var elementPath = splitInfo.elementPath; + if ( elementPath ) { - var element = elementPath.elements[ i ]; + for ( var i = 0, len = elementPath.elements.length ; i < len ; i++ ) + { + var element = elementPath.elements[ i ]; - if ( element.equals( elementPath.block ) || element.equals( elementPath.blockLimit ) ) - break; + if ( element.equals( elementPath.block ) || element.equals( elementPath.blockLimit ) ) + break; - if ( CKEDITOR.dtd.$removeEmpty[ element.getName() ] ) - { - element = element.clone(); - newBlock.moveChildren( element ); - newBlock.append( element ); + if ( CKEDITOR.dtd.$removeEmpty[ element.getName() ] ) + { + element = element.clone(); + newBlock.moveChildren( element ); + newBlock.append( element ); + } } } - } - if ( !CKEDITOR.env.ie ) - newBlock.appendBogus(); + if ( !CKEDITOR.env.ie ) + newBlock.appendBogus(); - range.insertNode( newBlock ); + range.insertNode( newBlock ); - // This is tricky, but to make the new block visible correctly - // we must select it. - // The previousBlock check has been included because it may be - // empty if we have fixed a block-less space (like ENTER into an - // empty table cell). - if ( CKEDITOR.env.ie && isStartOfBlock && ( !isEndOfBlock || !previousBlock.getChildCount() ) ) - { - // Move the selection to the new block. - range.moveToElementEditStart( isEndOfBlock ? previousBlock : newBlock ); - range.select(); - } + // This is tricky, but to make the new block visible correctly + // we must select it. + // The previousBlock check has been included because it may be + // empty if we have fixed a block-less space (like ENTER into an + // empty table cell). + if ( CKEDITOR.env.ie && isStartOfBlock && ( !isEndOfBlock || !previousBlock.getChildCount() ) ) + { + // Move the selection to the new block. + range.moveToElementEditStart( isEndOfBlock ? previousBlock : newBlock ); + range.select(); + } - // Move the selection to the new block. - range.moveToElementEditStart( isStartOfBlock && !isEndOfBlock ? nextBlock : newBlock ); + // Move the selection to the new block. + range.moveToElementEditStart( isStartOfBlock && !isEndOfBlock ? nextBlock : newBlock ); } - if ( !CKEDITOR.env.ie ) - { - if ( nextBlock ) + if ( !CKEDITOR.env.ie ) { - // If we have split the block, adds a temporary span at the - // range position and scroll relatively to it. - var tmpNode = doc.createElement( 'span' ); + if ( nextBlock ) + { + // If we have split the block, adds a temporary span at the + // range position and scroll relatively to it. + var tmpNode = doc.createElement( 'span' ); - // We need some content for Safari. - tmpNode.setHtml( ' ' ); + // We need some content for Safari. + tmpNode.setHtml( ' ' ); - range.insertNode( tmpNode ); - tmpNode.scrollIntoView(); - range.deleteContents(); - } - else - { - // We may use the above scroll logic for the new block case - // too, but it gives some weird result with Opera. - newBlock.scrollIntoView(); + range.insertNode( tmpNode ); + tmpNode.scrollIntoView(); + range.deleteContents(); + } + else + { + // We may use the above scroll logic for the new block case + // too, but it gives some weird result with Opera. + newBlock.scrollIntoView(); + } } - } - range.select(); - } - - function enterBr( editor, mode ) - { - // Get the range for the current selection. - var range = getRange( editor ), - doc = range.document; + range.select(); + }, - // Determine the block element to be used. - var blockTag = ( mode == CKEDITOR.ENTER_DIV ? 'div' : 'p' ); + enterBr : function( editor, mode, range, forceMode ) + { + // Get the range for the current selection. + range = range || getRange( editor ); - var isEndOfBlock = range.checkEndOfBlock(); + var doc = range.document; - var elementPath = new CKEDITOR.dom.elementPath( editor.getSelection().getStartElement() ); + // Determine the block element to be used. + var blockTag = ( mode == CKEDITOR.ENTER_DIV ? 'div' : 'p' ); - var startBlock = elementPath.block, - startBlockTag = startBlock && elementPath.block.getName(); + var isEndOfBlock = range.checkEndOfBlock(); - var isPre = false; + var elementPath = new CKEDITOR.dom.elementPath( editor.getSelection().getStartElement() ); - if ( !forceMode && startBlockTag == 'li' ) - { - enterBlock( editor, mode, range ); - return; - } + var startBlock = elementPath.block, + startBlockTag = startBlock && elementPath.block.getName(); - // If we are at the end of a header block. - if ( !forceMode && isEndOfBlock && headerTagRegex.test( startBlockTag ) ) - { - // Insert a
    after the current paragraph. - doc.createElement( 'br' ).insertAfter( startBlock ); + var isPre = false; - // A text node is required by Gecko only to make the cursor blink. - if ( CKEDITOR.env.gecko ) - doc.createText( '' ).insertAfter( startBlock ); + if ( !forceMode && startBlockTag == 'li' ) + { + enterBlock( editor, mode, range, forceMode ); + return; + } - // IE has different behaviors regarding position. - range.setStartAt( startBlock.getNext(), CKEDITOR.env.ie ? CKEDITOR.POSITION_BEFORE_START : CKEDITOR.POSITION_AFTER_START ); - } - else - { - var lineBreak; + // If we are at the end of a header block. + if ( !forceMode && isEndOfBlock && headerTagRegex.test( startBlockTag ) ) + { + // Insert a
    after the current paragraph. + doc.createElement( 'br' ).insertAfter( startBlock ); - isPre = ( startBlockTag == 'pre' ); + // A text node is required by Gecko only to make the cursor blink. + if ( CKEDITOR.env.gecko ) + doc.createText( '' ).insertAfter( startBlock ); - if ( isPre ) - lineBreak = doc.createText( CKEDITOR.env.ie ? '\r' : '\n' ); + // IE has different behaviors regarding position. + range.setStartAt( startBlock.getNext(), CKEDITOR.env.ie ? CKEDITOR.POSITION_BEFORE_START : CKEDITOR.POSITION_AFTER_START ); + } else - lineBreak = doc.createElement( 'br' ); + { + var lineBreak; - range.deleteContents(); - range.insertNode( lineBreak ); + isPre = ( startBlockTag == 'pre' ); - // 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 ); + // Gecko prefers
    as line-break inside
     (#4711).
    +				if ( isPre && !CKEDITOR.env.gecko )
    +					lineBreak = doc.createText( CKEDITOR.env.ie ? '\r' : '\n' );
    +				else
    +					lineBreak = doc.createElement( 'br' );
     
    -			// 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();
    +				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 ); - // 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; - // 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' ); - // 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(' '); + dummy.insertBefore( lineBreak.getNext() ); + dummy.scrollIntoView(); + dummy.remove(); } - 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 ); } + }; - // This collapse guarantees the cursor will be blinking. - range.collapse( true ); + var plugin = CKEDITOR.plugins.enterkey, + enterBr = plugin.enterBr, + enterBlock = plugin.enterBlock, + headerTagRegex = /^h[1-6]$/; - range.select( isPre ); + 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.