/** * Converter between HTML DOM and VisualEditor linear data. * * @class * @constructor * @param {Object} options Conversion options */ ve.dm.Converter = function( nodeFactory, annotationFactory ) { // Properties this.nodeFactory = nodeFactory; this.annotationFactory = annotationFactory; this.elements = { 'html': {}, 'data': {}, 'types': {} }; this.annotations = { 'html': {}, 'data': {} }; // Events this.nodeFactory.addListenerMethod( this, 'register', 'onNodeRegister' ); this.annotationFactory.addListenerMethod( this, 'register', 'onAnnotationRegister' ); }; /* Methods */ /** * Responds to register events from the node factory. * * If a node is special; such as document, alienInline, alienBlock and text; it's converters data * should be set to null, as to distinguish it from a new node type that someone has simply * forgotten to implement converters for. * * @method * @param {String} type Node type * @param {Function} constructor Node constructor * @throws 'Missing conversion data in node implementation of {type}' */ ve.dm.Converter.prototype.onNodeRegister = function( type, constructor ) { if ( constructor.converters === undefined ) { throw 'Missing conversion data in node implementation of ' + type; } else if ( constructor.converters !== null ) { var tags = constructor.converters.tags, html = constructor.converters.html, data = constructor.converters.data; // Convert tags to an array if needed if ( !ve.isArray( tags ) ) { tags = [tags]; } // Registration this.elements.html[type] = html.convert; for ( var i = 0; i < tags.length; i++ ) { this.elements.data[tags[i]] = data.convert; this.elements.types[tags[i]] = type; } } }; /** * Responds to register events from the annotation factory. * * @method * @param {String} type Base annotation type * @param {Function} constructor Annotation constructor * @throws 'Missing conversion data in annotation implementation of {type}' */ ve.dm.Converter.prototype.onAnnotationRegister = function( type, constructor ) { if ( constructor.converters === undefined ) { throw 'Missing conversion data in annotation implementation of ' + type; } else if ( constructor.converters !== null ) { var tags = constructor.converters.tags, html = constructor.converters.html, data = constructor.converters.data; // Convert tags to an array if needed if ( !ve.isArray( tags ) ) { tags = [tags]; } // Registration this.annotations.html[type] = html.convert; for ( var i = 0; i < tags.length; i++ ) { this.annotations.data[tags[i]] = data.convert; } } }; /* Initialization */ ve.dm.converter = new ve.dm.Converter( ve.dm.nodeFactory, ve.dm.annotationFactory );