X-Git-Url: https://jasonwoof.com/gitweb/?a=blobdiff_plain;f=_source%2Fplugins%2Fwysiwygarea%2Fplugin.js;h=dc8329d9afee1c507bbc829cbac20fca74d90e2e;hb=refs%2Ftags%2Fv3.2.1;hp=ab06245624173000bc0e7a841a39f8c23e74b434;hpb=8761695d9b70afe75905deaac88f78c1f8aeb32d;p=ckeditor.git diff --git a/_source/plugins/wysiwygarea/plugin.js b/_source/plugins/wysiwygarea/plugin.js index ab06245..dc8329d 100644 --- a/_source/plugins/wysiwygarea/plugin.js +++ b/_source/plugins/wysiwygarea/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 */ @@ -10,18 +10,18 @@ For licensing, see LICENSE.html or http://ckeditor.com/license (function() { - /** - * List of elements in which has no way to move editing focus outside. - */ + // List of elements in which has no way to move editing focus outside. var nonExitableElementNames = { table:1,pre:1 }; + // Matching an empty paragraph at the end of document. - var emptyParagraphRegexp = /\s*<(p|div|address|h\d|center)[^>]*>\s*(?:]*>| | )\s*(:?<\/\1>)?\s*$/gi; + var emptyParagraphRegexp = /\s*<(p|div|address|h\d|center)[^>]*>\s*(?:]*>| |\u00A0| )?\s*(:?<\/\1>)?\s*(?=$|<\/body>)/gi; function onInsertHtml( evt ) { if ( this.mode == 'wysiwyg' ) { this.focus(); + this.fire( 'saveSnapshot' ); var selection = this.getSelection(), data = evt.data; @@ -46,6 +46,11 @@ For licensing, see LICENSE.html or http://ckeditor.com/license } else this.document.$.execCommand( 'inserthtml', false, data ); + + CKEDITOR.tools.setTimeout( function() + { + this.fire( 'saveSnapshot' ); + }, 0, this ); } } @@ -84,13 +89,16 @@ For licensing, see LICENSE.html or http://ckeditor.com/license var current, dtd; if ( isBlock ) { - while( ( current = range.getCommonAncestor( false, true ) ) + while ( ( current = range.getCommonAncestor( false, true ) ) && ( dtd = CKEDITOR.dtd[ current.getName() ] ) && !( dtd && dtd [ elementName ] ) ) { + // Split up inline elements. + if ( current.getName() in CKEDITOR.dtd.span ) + range.splitElement( current ); // If we're in an empty block which indicate a new paragraph, // simply replace it with the inserting block.(#3664) - if ( range.checkStartOfBlock() + else if ( range.checkStartOfBlock() && range.checkEndOfBlock() ) { range.setStartBefore( current ); @@ -135,10 +143,33 @@ For licensing, see LICENSE.html or http://ckeditor.com/license // DOM modification here should not bother dirty flag.(#4385) function restoreDirty( editor ) { - if( !editor.checkDirty() ) + if ( !editor.checkDirty() ) setTimeout( function(){ editor.resetDirty(); } ); } + var isNotWhitespace = CKEDITOR.dom.walker.whitespaces( true ), + isNotBookmark = CKEDITOR.dom.walker.bookmark( false, true ); + + function isNotEmpty( node ) + { + return isNotWhitespace( node ) && isNotBookmark( node ); + } + + function isNbsp( node ) + { + return node.type == CKEDITOR.NODE_TEXT + && CKEDITOR.tools.trim( node.getText() ).match( /^(?: |\xa0)$/ ); + } + + function restoreSelection( selection ) + { + if ( selection.isLocked ) + { + selection.unlock(); + setTimeout( function() { selection.lock(); }, 0 ); + } + } + /** * Auto-fixing block-less content by wrapping paragraph (#3190), prevent * non-exitable-block by padding extra br.(#3189) @@ -161,61 +192,70 @@ For licensing, see LICENSE.html or http://ckeditor.com/license && !path.block ) { restoreDirty( editor ); - var bms = selection.createBookmarks(), - fixedBlock = range.fixBlock( true, + CKEDITOR.env.ie && restoreSelection( selection ); + + var fixedBlock = range.fixBlock( true, editor.config.enterMode == CKEDITOR.ENTER_DIV ? 'div' : 'p' ); - // For IE, we'll be removing any bogus br ( introduce by fixing body ) - // right now to prevent it introducing visual line break. + // For IE, we should remove any filler node which was introduced before. if ( CKEDITOR.env.ie ) { - var brNodeList = fixedBlock.getElementsByTag( 'br' ), brNode; - for ( var i = 0 ; i < brNodeList.count() ; i++ ) - { - if( ( brNode = brNodeList.getItem( i ) ) && brNode.hasAttribute( '_cke_bogus' ) ) - brNode.remove(); - } + var first = fixedBlock.getFirst( isNotEmpty ); + first && isNbsp( first ) && first.remove(); } - selection.selectBookmarks( bms ); - - // If the fixed block is blank and is already followed by a exitable - // block, we should drop it and move to the exist block(#3684). - var children = fixedBlock.getChildren(), - count = children.count(), - firstChild, - whitespaceGuard = CKEDITOR.dom.walker.whitespaces( true ), - previousElement = fixedBlock.getPrevious( whitespaceGuard ), - nextElement = fixedBlock.getNext( whitespaceGuard ), - enterBlock; - if ( previousElement && previousElement.getName - && !( previousElement.getName() in nonExitableElementNames ) ) - enterBlock = previousElement; - else if ( nextElement && nextElement.getName - && !( nextElement.getName() in nonExitableElementNames ) ) - enterBlock = nextElement; - - // Not all blocks are editable, e.g.
, further checking it.(#3994) - if( ( !count - || ( firstChild = children.getItem( 0 ) ) && firstChild.is && firstChild.is( 'br' ) ) - && enterBlock - && range.moveToElementEditStart( enterBlock ) ) + // If the fixed block is blank and already followed by a exitable + // block, we should revert the fix. (#3684) + if ( fixedBlock.getOuterHtml().match( emptyParagraphRegexp ) ) { - fixedBlock.remove(); - range.select(); + var previousElement = fixedBlock.getPrevious( isNotWhitespace ), + nextElement = fixedBlock.getNext( isNotWhitespace ); + + if ( previousElement && previousElement.getName + && !( previousElement.getName() in nonExitableElementNames ) + && range.moveToElementEditStart( previousElement ) + || nextElement && nextElement.getName + && !( nextElement.getName() in nonExitableElementNames ) + && range.moveToElementEditStart( nextElement ) ) + { + fixedBlock.remove(); + } } + + range.select(); + // Notify non-IE that selection has changed. + if ( !CKEDITOR.env.ie ) + editor.selectionChange(); } - // Inserting the padding-br before body if it's preceded by an - // unexitable block. - var lastNode = body.getLast( CKEDITOR.dom.walker.whitespaces( true ) ); - if ( lastNode && lastNode.getName && ( lastNode.getName() in nonExitableElementNames ) ) + // All browsers are incapable to moving cursor out of certain non-exitable + // blocks (e.g. table, list, pre) at the end of document, make this happen by + // place a bogus node there, which would be later removed by dataprocessor. + var walkerRange = new CKEDITOR.dom.range( editor.document ), + walker = new CKEDITOR.dom.walker( walkerRange ); + walkerRange.selectNodeContents( body ); + walker.evaluator = function( node ) + { + return node.type == CKEDITOR.NODE_ELEMENT && ( node.getName() in nonExitableElementNames ); + }; + walker.guard = function( node, isMoveout ) + { + return !( ( node.type == CKEDITOR.NODE_TEXT && isNotWhitespace( node ) ) || isMoveout ); + }; + + if ( walker.previous() ) { restoreDirty( editor ); - var paddingBlock = editor.document.createElement( - ( CKEDITOR.env.ie && enterMode != CKEDITOR.ENTER_BR ) ? - '
' : 'br' ); - body.append( paddingBlock ); + CKEDITOR.env.ie && restoreSelection( selection ); + + var paddingBlock; + if ( enterMode != CKEDITOR.ENTER_BR ) + paddingBlock = body.append( new CKEDITOR.dom.element( enterMode == CKEDITOR.ENTER_P ? 'p' : 'div' ) ); + else + paddingBlock = body; + + if ( !CKEDITOR.env.ie ) + paddingBlock.appendBogus(); } } @@ -228,117 +268,78 @@ For licensing, see LICENSE.html or http://ckeditor.com/license var fixForBody = ( editor.config.enterMode != CKEDITOR.ENTER_BR ) ? editor.config.enterMode == CKEDITOR.ENTER_DIV ? 'div' : 'p' : false; + var frameLabel = editor.lang.editorTitle.replace( '%1', editor.name ); + editor.on( 'editingBlockReady', function() { var mainElement, - fieldset, iframe, isLoadingData, isPendingFocus, frameLoaded, fireMode; + // Support for custom document.domain in IE. var isCustomDomain = CKEDITOR.env.isCustomDomain(); // Creates the iframe that holds the editable document. - var createIFrame = function() + var createIFrame = function( data ) { if ( iframe ) iframe.remove(); - if ( fieldset ) - fieldset.remove(); frameLoaded = 0; - // The document domain must be set within the src - // attribute; - // Defer the script execution until iframe - // has been added to main window, this is needed for some - // browsers which will begin to load the frame content - // prior to it's presentation in DOM.(#3894) - var src = 'void( ' - + ( CKEDITOR.env.gecko ? 'setTimeout' : '' ) + '( function(){' + - 'document.open();' + - ( CKEDITOR.env.ie && isCustomDomain ? 'document.domain="' + document.domain + '";' : '' ) + - 'document.write( window.parent[ "_cke_htmlToLoad_' + editor.name + '" ] );' + - 'document.close();' + - 'window.parent[ "_cke_htmlToLoad_' + editor.name + '" ] = null;' + - '}' - + ( CKEDITOR.env.gecko ? ', 0 )' : ')()' ) - + ' )'; - - // Loading via src attribute does not work in Opera. - if ( CKEDITOR.env.opera ) - src = 'void(0);'; - iframe = CKEDITOR.dom.element.createFromHtml( '' ); + var setDataFn = !CKEDITOR.env.gecko && CKEDITOR.tools.addFunction( function( doc ) + { + CKEDITOR.tools.removeFunction( setDataFn ); + doc.write( data ); + }); - var accTitle = editor.lang.editorTitle.replace( '%1', editor.name ); + var srcScript = + 'document.open();' + - if ( CKEDITOR.env.gecko ) - { - // Double checking the iframe will be loaded properly(#4058). - iframe.on( 'load', function( ev ) + // The document domain must be set any time we + // call document.open(). + ( isCustomDomain ? ( 'document.domain="' + document.domain + '";' ) : '' ) + + + ( ( 'parent.CKEDITOR.tools.callFunction(' + setDataFn + ',document);' ) ) + + + 'document.close();'; + + iframe = CKEDITOR.dom.element.createFromHtml( '' ); + + // With FF, it's better to load the data on iframe.load. (#3894,#4058) + CKEDITOR.env.gecko && iframe.on( 'load', function( ev ) { ev.removeListener(); - contentDomReady( iframe.$.contentWindow ); - } ); - // Accessibility attributes for Firefox. - mainElement.setAttributes( - { - role : 'region', - title : accTitle - } ); - iframe.setAttributes( - { - role : 'region', - title : ' ' - } ); - } - else if ( CKEDITOR.env.webkit ) - { - iframe.setAttribute( 'title', accTitle ); // Safari 4 - iframe.setAttribute( 'name', accTitle ); // Safari 3 - } - else if ( CKEDITOR.env.ie ) - { - // Accessibility label for IE. - fieldset = CKEDITOR.dom.element.createFromHtml( - '
' + - '' + - CKEDITOR.tools.htmlEncode( accTitle ) + - '' + - '
' - , CKEDITOR.document ); - iframe.appendTo( fieldset ); - fieldset.appendTo( mainElement ); - } + var doc = iframe.getFrameDocument().$; + + doc.open(); + doc.write( data ); + doc.close(); + }); - if ( !CKEDITOR.env.ie ) - mainElement.append( iframe ); + mainElement.append( iframe ); }; - // The script that is appended to the data being loaded. It - // enables editing, and makes some + // The script that launches the bootstrap logic on 'domReady', so the document + // is fully editable even before the editing iframe is fully loaded (#4455). var activationScript = - ''; // Editing area bootstrap code. @@ -346,9 +347,10 @@ For licensing, see LICENSE.html or http://ckeditor.com/license { if ( frameLoaded ) return; - frameLoaded = 1; + editor.fire( 'ariaWidget', iframe ); + var domDocument = domWindow.document, body = domDocument.body; @@ -411,6 +413,22 @@ For licensing, see LICENSE.html or http://ckeditor.com/license } ); } + // IE standard compliant in editing frame doesn't focus the editor when + // clicking outside actual content, manually apply the focus. (#1659) + if ( CKEDITOR.env.ie + && domDocument.$.compatMode == 'CSS1Compat' ) + { + var htmlElement = domDocument.getDocumentElement(); + htmlElement.on( 'mousedown', function( evt ) + { + // Setting focus directly on editor doesn't work, we + // have to use here a temporary element to 'redirect' + // the focus. + if ( evt.data.getTarget().equals( htmlElement ) ) + ieFocusGrabber.focus(); + } ); + } + var focusTarget = ( CKEDITOR.env.ie || CKEDITOR.env.webkit ) ? domWindow : domDocument; @@ -426,13 +444,14 @@ For licensing, see LICENSE.html or http://ckeditor.com/license if ( CKEDITOR.env.gecko ) { var first = body; - while( first.firstChild ) + while ( first.firstChild ) first = first.firstChild; - if( !first.nextSibling + if ( !first.nextSibling && ( 'BR' == first.tagName ) && first.hasAttribute( '_moz_editor_bogus_node' ) ) { + restoreDirty( editor ); var keyEventSimulate = domDocument.$.createEvent( "KeyEvents" ); keyEventSimulate.initKeyEvent( 'keypress', true, true, domWindow.$, false, false, false, false, 0, 32 ); @@ -454,29 +473,60 @@ For licensing, see LICENSE.html or http://ckeditor.com/license if ( keystrokeHandler ) keystrokeHandler.attach( domDocument ); - // Cancel default action for backspace in IE on control types. (#4047) if ( CKEDITOR.env.ie ) { - editor.on( 'key', function( event ) + // Override keystrokes which should have deletion behavior + // on control types in IE . (#4047) + domDocument.on( 'keydown', function( evt ) { - // Backspace. - var control = event.data.keyCode == 8 - && editor.getSelection().getSelectedElement(); - if ( control ) + var keyCode = evt.data.getKeystroke(); + + // Backspace OR Delete. + if ( keyCode in { 8 : 1, 46 : 1 } ) { - // Make undo snapshot. - editor.fire( 'saveSnapshot' ); - // Remove manually. - control.remove(); - editor.fire( 'saveSnapshot' ); - event.cancel(); + var sel = editor.getSelection(), + control = sel.getSelectedElement(); + + if ( control ) + { + // Make undo snapshot. + editor.fire( 'saveSnapshot' ); + + // Delete any element that 'hasLayout' (e.g. hr,table) in IE8 will + // break up the selection, safely manage it here. (#4795) + var bookmark = sel.getRanges()[ 0 ].createBookmark(); + // Remove the control manually. + control.remove(); + sel.selectBookmarks( [ bookmark ] ); + + editor.fire( 'saveSnapshot' ); + + evt.data.preventDefault(); + } } } ); + + // PageUp/PageDown scrolling is broken in document + // with standard doctype, manually fix it. (#4736) + if ( domDocument.$.compatMode == 'CSS1Compat' ) + { + var pageUpDownKeys = { 33 : 1, 34 : 1 }; + domDocument.on( 'keydown', function( evt ) + { + if ( evt.data.getKeystroke() in pageUpDownKeys ) + { + setTimeout( function () + { + editor.getSelection().scrollIntoView(); + }, 0 ); + } + } ); + } } // Adds the document body as a context menu target. if ( editor.contextMenu ) - editor.contextMenu.addTarget( domDocument ); + editor.contextMenu.addTarget( domDocument, editor.config.browserContextMenuOnCtrl !== false ); setTimeout( function() { @@ -550,54 +600,111 @@ For licensing, see LICENSE.html or http://ckeditor.com/license { isLoadingData = true; + var config = editor.config, + fullPage = config.fullPage, + docType = config.docType; + + // Build the additional stuff to be included into . + var headExtra = + ''; + + !fullPage && ( headExtra = + CKEDITOR.tools.buildStyleHtml( editor.config.contentsCss ) + + headExtra ); + + var baseTag = config.baseHref ? '' : ''; + + if ( fullPage ) + { + // Search and sweep out the doctype declaration. + data = data.replace( /]*>/i, function( match ) + { + editor.docType = docType = match; + return ''; + }); + } + // Get the HTML version of the data. if ( editor.dataProcessor ) - { data = editor.dataProcessor.toHtml( data, fixForBody ); + + if ( fullPage ) + { + // Check if the tag is available. + if ( !(/]/).test( data ) ) + data = '' + data; + + // Check if the tag is available. + if ( !(/]/).test( data ) ) + data = '' + data + ''; + + // Check if the tag is available. + if ( !(/]/).test( data ) ) + data = data.replace( /]*>/, '$&' ) ; + + // The base must be the first tag in the HEAD, e.g. to get relative + // links on styles. + baseTag && ( data = data.replace( //, '$&' + baseTag ) ); + + // Inject the extra stuff into . + // Attention: do not change it before testing it well. (V2) + // This is tricky... if the head ends with , + // Firefox will break. But, it works if we place our extra stuff as + // the last elements in the HEAD. + data = data.replace( /<\/head\s*>/, headExtra + '$&' ); + + // Add the DOCTYPE back to it. + data = docType + data; } + else + { + data = + config.docType + + '' + + '' + frameLabel + '' + + '' + + baseTag + + headExtra + + '' + + '' + + data + + ''; + } + + data += activationScript; - data = - editor.config.docType + - '' + - '' + - '' + - ''+ - '' + - '' + - data + - '' + - '' + - activationScript; - - window[ '_cke_htmlToLoad_' + editor.name ] = data; CKEDITOR._[ 'contentDomReady' + editor.name ] = contentDomReady; - createIFrame(); - // Opera must use the old method for loading contents. - if ( CKEDITOR.env.opera ) - { - var doc = iframe.$.contentWindow.document; - doc.open(); - doc.write( data ); - doc.close(); - } + // The iframe is recreated on each call of setData, so we need to clear DOM objects + this.onDispose(); + createIFrame( data ); }, getData : function() { - var data = iframe.getFrameDocument().getBody().getHtml(); + var config = editor.config, + fullPage = config.fullPage, + docType = fullPage && editor.docType, + doc = iframe.getFrameDocument(); + + var data = fullPage + ? doc.getDocumentElement().getOuterHtml() + : doc.getBody().getHtml(); if ( editor.dataProcessor ) data = editor.dataProcessor.toDataFormat( data, fixForBody ); // Strip the last blank paragraph within document. - if ( editor.config.ignoreEmptyParagraph ) + if ( config.ignoreEmptyParagraph ) data = data.replace( emptyParagraphRegexp, '' ); + if ( docType ) + data = docType + '\n' + data; + return data; }, @@ -611,8 +718,24 @@ For licensing, see LICENSE.html or http://ckeditor.com/license iframe.getFrameDocument().getBody().setHtml( data ); }, + onDispose : function() + { + if ( !editor.document ) + return; + + editor.document.getDocumentElement().clearCustomData(); + editor.document.getBody().clearCustomData(); + + editor.window.clearCustomData(); + editor.document.clearCustomData(); + + iframe.clearCustomData(); + }, + unload : function( holderElement ) { + this.onDispose(); + editor.window = editor.document = iframe = mainElement = isPendingFocus = null; editor.fire( 'contentDomUnload' ); @@ -635,8 +758,74 @@ For licensing, see LICENSE.html or http://ckeditor.com/license // Auto fixing on some document structure weakness to enhance usabilities. (#3190 and #3189) editor.on( 'selectionChange', onSelectionChangeFixBody, null, null, 1 ); }); + + var titleBackup; + // Setting voice label as window title, backup the original one + // and restore it before running into use. + editor.on( 'contentDom', function () + { + var title = editor.document.getElementsByTag( 'title' ).getItem( 0 ); + title.setAttribute( '_cke_title', editor.document.$.title ); + editor.document.$.title = frameLabel; + }); + + + // Create an invisible element to grab focus. + if ( CKEDITOR.env.ie ) + { + var ieFocusGrabber; + editor.on( 'uiReady', function() + { + ieFocusGrabber = editor.container.append( CKEDITOR.dom.element.createFromHtml( + // Use 'span' instead of anything else to fly under the screen-reader radar. (#5049) + '' ) ); + + ieFocusGrabber.on( 'focus', function() + { + editor.focus(); + } ); + } ); + editor.on( 'destroy', function() + { + ieFocusGrabber.clearCustomData(); + } ); + } } }); + + // Fixing Firefox 'Back-Forward Cache' break design mode. (#4514) + if ( CKEDITOR.env.gecko ) + { + ( function () + { + var body = document.body; + + if ( !body ) + window.addEventListener( 'load', arguments.callee, false ); + else + { + body.setAttribute( 'onpageshow', body.getAttribute( 'onpageshow' ) + + ';event.persisted && CKEDITOR.tools.callFunction(' + + CKEDITOR.tools.addFunction( function() + { + var allInstances = CKEDITOR.instances, + editor, + doc; + for ( var i in allInstances ) + { + editor = allInstances[ i ]; + doc = editor.document; + if ( doc ) + { + doc.$.designMode = 'off'; + doc.$.designMode = 'on'; + } + } + } ) + ')' ); + } + } )(); + + } })(); /** @@ -685,3 +874,9 @@ CKEDITOR.config.disableNativeSpellChecker = true; * config.ignoreEmptyParagraph = false; */ CKEDITOR.config.ignoreEmptyParagraph = true; + +/** + * Fired when data is loaded and ready for retrieval in an editor instance. + * @name CKEDITOR.editor#dataReady + * @event + */