mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/VisualEditor
synced 2024-12-02 09:57:01 +00:00
102 lines
3.3 KiB
JavaScript
102 lines
3.3 KiB
JavaScript
/**
|
|
* Creates an ve.dm.DocumentSynchronizer object.
|
|
*
|
|
* This object is a one-time use utilitiy for collecting actions to be performed on the model tree
|
|
* in multiple steps and then processing those actions in a single step.
|
|
*
|
|
* @class
|
|
* @constructor
|
|
*/
|
|
ve.dm.DocumentSynchronizer = function( model ) {
|
|
// Properties
|
|
this.model = model;
|
|
this.actions = [];
|
|
};
|
|
|
|
/* Methods */
|
|
|
|
/**
|
|
* Adds an action to the synchronizer.
|
|
*
|
|
* @method
|
|
* @param {String} type Type of action, can be: "insert", "delete", "rebuild", "resize" or "update"
|
|
* @param {ve.dm.Node} node Node this action is related to
|
|
* @param {Integer} offset Offset of node, improves performance if this has already been calculated
|
|
* @param {Integer} adjustment Node length adjustment, if any
|
|
*/
|
|
ve.dm.DocumentSynchronizer.prototype.pushAction = function( type, node, offset, adjustment ) {
|
|
if ( offset === undefined ) {
|
|
offset = this.model.getOffsetFromNode( node );
|
|
}
|
|
this.actions.push( {
|
|
'type': type,
|
|
'node': node,
|
|
'offset': offset,
|
|
'adjustment': adjustment || 0
|
|
} );
|
|
};
|
|
|
|
/**
|
|
* Applies queued actions to the model tree.
|
|
*
|
|
* @method
|
|
*/
|
|
ve.dm.DocumentSynchronizer.prototype.synchronize = function() {
|
|
// TODO: Normalize the actions list to clean up nested actions
|
|
// Perform all actions
|
|
var adjustment = 0,
|
|
action,
|
|
offset,
|
|
parent;
|
|
for ( var i = 0, len = this.actions.length; i < len; i++ ) {
|
|
action = this.actions[i];
|
|
offset = action.offset + adjustment;
|
|
switch ( action.type ) {
|
|
case 'insert':
|
|
// Insert the new node at the given offset
|
|
var target = this.model.getNodeFromOffset( offset + 1 );
|
|
if ( target === this.model ) {
|
|
// Insert at the beginning of the document
|
|
this.model.splice( 0, 0, action.node );
|
|
} else if ( target === null ) {
|
|
// Insert at the end of the document
|
|
this.model.splice( this.model.getElementLength(), 0, action.node );
|
|
} else {
|
|
// Insert before the element currently at the offset
|
|
parent = target.getParent();
|
|
parent.splice( parent.indexOf( target ), 0, action.node );
|
|
}
|
|
// Adjust proceeding offsets positively by the length of the node being inserted
|
|
adjustment += action.node.getElementLength();
|
|
break;
|
|
case 'delete':
|
|
// Replace original node with new node
|
|
parent = action.node.getParent();
|
|
parentNode.splice( parentNode.indexOf( action.node ), 1 );
|
|
// Adjust proceeding offsets negatively by the length of the node being deleted
|
|
adjustment -= action.node.getElementLength();
|
|
break;
|
|
case 'rebuild':
|
|
// Replace original node with new node
|
|
var newNode = ve.dm.DocumentNode.createNodesFromData( this.model.getData(
|
|
new ve.Range( offset, action.node.getElementLength() + action.adjustment )
|
|
) );
|
|
parent = action.node.getParent();
|
|
parentNode.splice( parentNode.indexOf( action.node ), 1, newNode );
|
|
// Adjust proceeding offsets by the difference between the original and new nodes
|
|
adjustment += newNode.getElementLength() - action.node.getElementLength();
|
|
break;
|
|
case 'resize':
|
|
// Adjust node length - causes update events to be emitted
|
|
action.node.adjustContentLength( action.adjustment );
|
|
// Adjust proceeding offsets by the amount the node is being lengthened or shortened
|
|
adjustment += action.adjustment;
|
|
break;
|
|
case 'update':
|
|
// Emit update events
|
|
action.node.emit( 'update' );
|
|
break;
|
|
}
|
|
}
|
|
};
|