mediawiki-extensions-Visual.../modules/ve/dm/ve.dm.Transaction.js

155 lines
3.6 KiB
JavaScript
Raw Normal View History

/**
* Creates an ve.dm.Transaction object.
*
* @class
* @constructor
* @param {Object[]} operations List of operations
*/
ve.dm.Transaction = function( operations ) {
this.operations = ve.isArray( operations ) ? operations : [];
this.lengthDifference = 0;
};
/* Methods */
2011-11-04 21:06:06 +00:00
/**
* Gets a list of all operations.
*
* @method
* @returns {Object[]} List of operations
*/
ve.dm.Transaction.prototype.getOperations = function() {
2011-11-17 14:43:11 +00:00
return this.operations;
};
/**
* Gets the difference in content length this transaction will cause if applied.
*
* @method
* @returns {Integer} Difference in content length
*/
ve.dm.Transaction.prototype.getLengthDifference = function() {
return this.lengthDifference;
};
2011-11-04 21:06:06 +00:00
/**
* Adds a retain operation.
*
* @method
* @param {Integer} length Length of content data to retain
*/
ve.dm.Transaction.prototype.pushRetain = function( length ) {
var end = this.operations.length - 1;
if ( this.operations.length && this.operations[end].type === 'retain' ) {
this.operations[end].length += length;
} else {
this.operations.push( {
'type': 'retain',
'length': length
} );
}
};
2011-11-04 21:06:06 +00:00
/**
* Adds an insertion operation.
*
* @method
* @param {Array} data Data to retain
*/
ve.dm.Transaction.prototype.pushInsert = function( data ) {
var end = this.operations.length - 1;
if ( this.operations.length && this.operations[end].type === 'insert' ) {
this.operations[end].data = this.operations[end].data.concat( data );
} else {
this.operations.push( {
'type': 'insert',
'data': data
} );
}
this.lengthDifference += data.length;
};
2011-11-04 21:06:06 +00:00
/**
* Adds a removal operation.
*
* @method
* @param {Array} data Data to remove
*/
ve.dm.Transaction.prototype.pushRemove = function( data ) {
var end = this.operations.length - 1;
if ( this.operations.length && this.operations[end].type === 'remove' ) {
this.operations[end].data = this.operations[end].data.concat( data );
} else {
this.operations.push( {
'type': 'remove',
'data': data
} );
}
this.lengthDifference -= data.length;
};
2012-03-08 23:21:17 +00:00
/**
* Adds a replace operation
*
* @method
* @param {Array} remove Data to remove
* @param {Array] replacement Data to replace 'remove' with
*/
ve.dm.Transaction.prototype.pushReplace = function( remove, replacement ) {
this.operations.push( {
'type': 'replace',
'remove': remove,
'replacement': replacement
} );
};
2011-11-04 21:06:06 +00:00
/**
* Adds an element attribute change operation.
*
* @method
* @param {String} method Method to use, either "set" or "clear"
* @param {String} key Name of attribute to change
* @param {Mixed} from Value change attribute from
* @param {Mixed} to Value to change attribute to
2011-11-04 21:06:06 +00:00
*/
ve.dm.Transaction.prototype.pushReplaceElementAttribute = function( key, from, to ) {
this.operations.push( {
'type': 'attribute',
'key': key,
'from': from,
'to': to
} );
};
2011-11-04 21:06:06 +00:00
/**
* Adds a start annotating operation.
*
* @method
* @param {String} method Method to use, either "set" or "clear"
* @param {Object} annotation Annotation object to start setting or clearing from content data
*/
ve.dm.Transaction.prototype.pushStartAnnotating = function( method, annotation ) {
this.operations.push( {
'type': 'annotate',
'method': method,
'bias': 'start',
'annotation': annotation
} );
};
2011-11-04 21:06:06 +00:00
/**
* Adds a stop annotating operation.
*
* @method
* @param {String} method Method to use, either "set" or "clear"
* @param {Object} annotation Annotation object to stop setting or clearing from content data
*/
ve.dm.Transaction.prototype.pushStopAnnotating = function( method, annotation ) {
this.operations.push( {
'type': 'annotate',
'method': method,
'bias': 'stop',
'annotation': annotation
} );
};