mediawiki-extensions-Visual.../modules/ve/ce/ve.ce.SurfaceObserver.js
David Chan 24dae99065 Don't emit Surface changes back to the Surface
modules/ve/ce/ve.ce.SurfaceObserver.js
* add emitContentChanges argument to poll (and start and stop)

modules/ve/ce/ve.ce.Surface.js
* Pass emitContentChanges=false to calls to start/stop in certain places
* Explicitly pass emitContentChanges=true elsewhere, to preserve prior
  behaviour

modules/ve/ui/ve.ui.Surface.js
* Explicitly pass emitContentChanges=true to poll

modules/ve/test/ve.test.js
* Escape non-BMP unicode text literals (to prevent potential editor
  problems)

Bug: 50105
Bug: 50346
Bug: 50631
Bug: 51477
Bug: 52716
Change-Id: I19ec7eaa0e3224cbfc7e7188e964183d7393c9a7
2013-08-21 17:26:32 +00:00

216 lines
5.4 KiB
JavaScript

/*global rangy */
/*!
* VisualEditor ContentEditable Surface class.
*
* @copyright 2011-2013 VisualEditor Team and others; see AUTHORS.txt
* @license The MIT License (MIT); see LICENSE.txt
*/
/**
* ContentEditable surface observer.
*
* @class
* @mixins ve.EventEmitter
*
* @constructor
* @param {ve.ce.Document} documentView Document to observe
*/
ve.ce.SurfaceObserver = function VeCeSurfaceObserver( documentView ) {
// Mixin constructors
ve.EventEmitter.call( this );
// Properties
this.documentView = documentView;
this.domDocument = null;
this.polling = false;
this.timeoutId = null;
this.frequency = 250; //ms
// Initialization
this.clear();
};
/* Inheritance */
ve.mixinClass( ve.ce.SurfaceObserver, ve.EventEmitter );
/* Events */
/**
* When #poll sees a change this event is emitted (before the
* properties are updated).
*
* @event contentChange
* @param {HTMLElement} node DOM node the change occured in
* @param {Object} previous Old data
* @param {Object} previous.text Old plain text content
* @param {Object} previous.hash Old DOM hash
* @param {ve.Range} previous.range Old selection
* @param {Object} next New data
* @param {Object} next.text New plain text content
* @param {Object} next.hash New DOM hash
* @param {ve.Range} next.range New selection
*/
/**
* When #poll observes a change in the document and the new
* selection does not equal as the last known selection, this event
* is emitted (before the properties are updated).
*
* @event selectionChange
* @param {ve.Range} oldRange
* @param {ve.Range} newRange
*/
/* Methods */
/**
* Clear polling data.
*
* @method
* @param {ve.Range} range Initial range to use
*/
ve.ce.SurfaceObserver.prototype.clear = function ( range ) {
this.rangyRange = null;
this.range = range || null;
this.node = null;
this.text = null;
this.hash = null;
};
/**
* Start polling.
*
* If {postpone} is false or undefined the first poll cycle will occur immediately and synchronously.
*
* @method
* @param {boolean} postpone Add the first poll to the end of the event queue
* @param {boolean} emitContentChanges Allow contentChange to be emitted
*/
ve.ce.SurfaceObserver.prototype.start = function ( postpone, emitContentChanges ) {
this.domDocument = this.documentView.getDocumentNode().getElementDocument();
this.polling = true;
this.poll( postpone, emitContentChanges );
};
/**
* Stop polling.
*
* If {poll} is false or undefined than no final poll cycle will occur and changes can be lost. If
* it's true then a final poll cycle will occur immediately and synchronously.
*
* @method
* @param {boolean} poll Poll one last time before stopping future polling
* @param {boolean} emitContentChanges Allow contentChange to be emitted
*/
ve.ce.SurfaceObserver.prototype.stop = function ( poll, emitContentChanges ) {
if ( this.polling === true ) {
if ( poll === true ) {
this.poll( false, emitContentChanges );
}
this.polling = false;
clearTimeout( this.timeoutId );
this.timeoutId = null;
}
};
/**
* Poll for changes.
*
* If `postpone` is false or undefined then polling will occcur immediately.
*
* TODO: fixing selection in certain cases, handling selection across multiple nodes in Firefox
*
* FIXME: Does not work well (selectionChange is not emited) when cursor is placed inside a slug
* with a mouse.
*
* @method
* @param {boolean} postpone Append the poll action to the end of the event queue
* @param {boolean} emitContentChanges Allow contentChange to be emitted
* @emits contentChange
* @emits selectionChange
*/
ve.ce.SurfaceObserver.prototype.poll = function ( postpone, emitContentChanges ) {
var $nodeOrSlug, node, text, hash, range, rangyRange;
if ( this.polling === false ) {
return;
}
if ( this.timeoutId !== null ) {
clearTimeout( this.timeoutId );
this.timeoutId = null;
}
if ( postpone === true ) {
this.timeoutId = setTimeout(
ve.bind( this.poll, this ),
0,
false,
emitContentChanges
);
return;
}
range = this.range;
node = this.node;
rangyRange = ve.ce.DomRange.newFromDomSelection( rangy.getSelection( this.domDocument ) );
if ( !rangyRange.equals( this.rangyRange ) ) {
this.rangyRange = rangyRange;
node = null;
$nodeOrSlug = $( rangyRange.anchorNode ).closest( '.ve-ce-branchNode, .ve-ce-branchNode-slug' );
if ( $nodeOrSlug.length ) {
range = rangyRange.getRange();
if ( !$nodeOrSlug.hasClass( 've-ce-branchNode-slug' ) ) {
node = $nodeOrSlug.data( 'view' );
}
}
}
if ( this.node !== node ) {
if ( node === null ) {
this.text = null;
this.hash = null;
this.node = null;
} else {
this.text = ve.ce.getDomText( node.$[0] );
this.hash = ve.ce.getDomHash( node.$[0] );
this.node = node;
}
} else if ( node !== null ) {
text = ve.ce.getDomText( node.$[0] );
hash = ve.ce.getDomHash( node.$[0] );
if ( this.text !== text || this.hash !== hash ) {
if ( emitContentChanges ) {
this.emit(
'contentChange',
node,
{ 'text': this.text, 'hash': this.hash, 'range': this.range },
{ 'text': text, 'hash': hash, 'range': range }
);
}
this.text = text;
this.hash = hash;
}
}
// Only emit selectionChange event if there's a meaningful range difference
if ( ( this.range && range ) ? !this.range.equals( range ) : ( this.range !== range ) ) {
this.emit(
'selectionChange',
this.range,
range
);
this.range = range;
}
this.timeoutId = setTimeout(
ve.bind( this.poll, this ),
this.frequency,
false,
emitContentChanges
);
};