mediawiki-extensions-Visual.../modules/es/serializers/es.AnnotationSerializer.js

78 lines
2.1 KiB
JavaScript
Raw Normal View History

/**
* Creates an annotation renderer object.
*
* @class
* @constructor
* @property annotations {Object} List of annotations to be applied
*/
es.AnnotationSerializer = function() {
this.annotations = {};
};
/* Static Methods */
/**
* Adds a set of annotations to be inserted around a range of text.
*
* Insertions for the same range will be nested in order of declaration.
* @example
* stack = new es.AnnotationSerializer();
* stack.add( new es.Range( 1, 2 ), '[', ']' );
* stack.add( new es.Range( 1, 2 ), '{', '}' );
* // Outputs: "a[{b}]c"
* console.log( stack.render( 'abc' ) );
*
* @method
* @param {es.Range} range Range to insert text around
* @param {String} pre Text to insert before range
* @param {String} post Text to insert after range
*/
es.AnnotationSerializer.prototype.add = function( range, pre, post ) {
// Normalize the range if it can be normalized
if ( typeof range.normalize === 'function' ) {
range.normalize();
}
if ( !( range.start in this.annotations ) ) {
this.annotations[range.start] = [pre];
} else {
this.annotations[range.start].push( pre );
}
if ( !( range.end in this.annotations ) ) {
this.annotations[range.end] = [post];
} else {
this.annotations[range.end].unshift( post );
}
};
/**
* Adds a set of HTML tags to be inserted around a range of text.
*
* @method
* @param {es.Range} range Range to insert text around
* @param {String} type Tag name
* @param {Object} [attributes] List of HTML attributes
*/
es.AnnotationSerializer.prototype.addTags = function( range, type, attributes ) {
this.add( range, es.Html.makeOpeningTag( type, attributes ), es.Html.makeClosingTag( type ) );
};
/**
* Renders annotations into text.
*
* @method
* @param {String} text Text to apply annotations to
* @returns {String} Wrapped text
*/
es.AnnotationSerializer.prototype.render = function( text ) {
var out = '';
for ( var i = 0, length = text.length; i <= length; i++ ) {
if ( i in this.annotations ) {
out += this.annotations[i].join( '' );
}
if ( i < length ) {
out += text[i];
}
}
return out;
};