/*! * VisualEditor DataModel MWTransclusionNode class. * * @copyright 2011-2018 VisualEditor Team and others; see AUTHORS.txt * @license The MIT License (MIT); see LICENSE.txt */ /** * DataModel MediaWiki transclusion node. * * @class * @abstract * @extends ve.dm.LeafNode * @mixins ve.dm.GeneratedContentNode * @mixins ve.dm.FocusableNode * * @constructor * @param {Object} [element] Reference to element in linear model */ ve.dm.MWTransclusionNode = function VeDmMWTransclusionNode() { // Parent constructor ve.dm.MWTransclusionNode.super.apply( this, arguments ); // Mixin constructors ve.dm.GeneratedContentNode.call( this ); ve.dm.FocusableNode.call( this ); // Properties this.partsList = null; // Events this.connect( this, { attributeChange: 'onAttributeChange' } ); }; /* Inheritance */ OO.inheritClass( ve.dm.MWTransclusionNode, ve.dm.LeafNode ); OO.mixinClass( ve.dm.MWTransclusionNode, ve.dm.GeneratedContentNode ); OO.mixinClass( ve.dm.MWTransclusionNode, ve.dm.FocusableNode ); /* Static members */ ve.dm.MWTransclusionNode.static.name = 'mwTransclusion'; ve.dm.MWTransclusionNode.static.matchTagNames = null; ve.dm.MWTransclusionNode.static.matchRdfaTypes = [ 'mw:Transclusion' ]; // Transclusion nodes can contain other types, e.g. mw:PageProp/Category. // Allow all other types (null) so they match to this node. ve.dm.MWTransclusionNode.static.allowedRdfaTypes = null; // HACK: This prevents any rules with higher specificity from matching, // e.g. LanguageAnnotation which uses a match function ve.dm.MWTransclusionNode.static.matchFunction = function () { return true; }; ve.dm.MWTransclusionNode.static.enableAboutGrouping = true; ve.dm.MWTransclusionNode.static.getHashObject = function ( dataElement ) { return { type: dataElement.type, mw: dataElement.attributes.mw }; }; ve.dm.MWTransclusionNode.static.isDiffComparable = function ( element, other ) { function getTemplateNames( parts ) { return parts.map( function ( part ) { return part.template ? part.template.target.wt : ''; } ).join( '|' ); } return ve.dm.MWTransclusionNode.super.static.isDiffComparable.call( this, element, other ) && getTemplateNames( element.attributes.mw.parts ) === getTemplateNames( other.attributes.mw.parts ); }; /** * Node type to use when the transclusion is inline * * @static * @property {string} * @inheritable */ ve.dm.MWTransclusionNode.static.inlineType = 'mwTransclusionInline'; /** * Node type to use when the transclusion is a block * * @static * @property {string} * @inheritable */ ve.dm.MWTransclusionNode.static.blockType = 'mwTransclusionBlock'; /** * Node type to use when the transclusion is cellable * * @static * @property {string} * @inheritable */ ve.dm.MWTransclusionNode.static.cellType = 'mwTransclusionTableCell'; ve.dm.MWTransclusionNode.static.toDataElement = function ( domElements, converter ) { var dataElement, mwDataJSON = domElements[ 0 ].getAttribute( 'data-mw' ), mwData = mwDataJSON ? JSON.parse( mwDataJSON ) : {}, isInline = this.isHybridInline( domElements, converter ), type = isInline ? this.inlineType : this.blockType; dataElement = { type: type, attributes: { mw: mwData, originalMw: mwDataJSON } }; if ( domElements.length === 1 && [ 'td', 'th' ].indexOf( domElements[ 0 ].nodeName.toLowerCase() ) !== -1 ) { dataElement.type = this.cellType; ve.dm.TableCellableNode.static.setAttributes( dataElement.attributes, domElements ); } if ( !domElements[ 0 ].getAttribute( 'data-ve-no-generated-contents' ) ) { this.storeGeneratedContents( dataElement, domElements, converter.getStore() ); } return dataElement; }; ve.dm.MWTransclusionNode.static.toDomElements = function ( dataElement, doc, converter ) { var els, i, len, span, value, modelNode, viewNode, store = converter.getStore(), originalMw = dataElement.attributes.originalMw, originalDomElements = store.value( dataElement.originalDomElementsHash ); function wrapTextNode( node ) { var wrapper; if ( node.nodeType === Node.TEXT_NODE ) { wrapper = doc.createElement( 'span' ); wrapper.appendChild( node ); return wrapper; } return node; } // If the transclusion is unchanged just send back the // original DOM elements so selser can skip over it if ( originalDomElements && originalMw && ve.compare( dataElement.attributes.mw, JSON.parse( originalMw ) ) ) { // originalDomElements is also used for CE rendering so return a copy els = ve.copyDomElements( originalDomElements, doc ); } else { if ( converter.doesModeNeedRendering() && // Use getHashObjectForRendering to get the rendering from the store ( value = store.value( store.hashOfValue( null, OO.getHash( [ this.getHashObjectForRendering( dataElement ), undefined ] ) ) ) ) ) { // For the clipboard use the current DOM contents so the user has something // meaningful to paste into external applications els = ve.copyDomElements( value, doc ); els[ 0 ] = wrapTextNode( els[ 0 ] ); } else if ( originalDomElements ) { els = [ doc.createElement( originalDomElements[ 0 ].nodeName ) ]; } else if ( dataElement.type === this.cellType ) { els = [ doc.createElement( dataElement.attributes.style === 'header' ? 'th' : 'td' ) ]; } else { els = [ doc.createElement( 'span' ) ]; } // All we need to send back to Parsoid is the original transclusion marker, with a // reconstructed data-mw property. els[ 0 ].setAttribute( 'typeof', 'mw:Transclusion' ); els[ 0 ].setAttribute( 'data-mw', JSON.stringify( dataElement.attributes.mw ) ); } if ( converter.isForClipboard() ) { // If the first element is a or tag, e.g. a category, ensure it // is not destroyed by copy-paste by replacing it with a span if ( els[ 0 ].tagName === 'LINK' || els[ 0 ].tagName === 'META' ) { span = doc.createElement( 'span' ); span.setAttribute( 'typeof', 'mw:Transclusion' ); span.setAttribute( 'data-mw', els[ 0 ].getAttribute( 'data-mw' ) ); els[ 0 ] = span; } // Empty spans can get thrown around by Chrome when pasting, so give them a space if ( els[ 0 ].innerHTML === '' ) { els[ 0 ].appendChild( doc.createTextNode( '\u00a0' ) ); } // Mark the data-mw element as not having valid generated contents with it in case it is // inserted into another editor (e.g. via paste). els[ 0 ].setAttribute( 'data-ve-no-generated-contents', true ); // ... and mark all but the first child as ignorable for ( i = 1, len = els.length; i < len; i++ ) { // Wrap plain text nodes so we can give them an attribute els[ i ] = wrapTextNode( els[ i ] ); els[ i ].setAttribute( 'data-ve-ignore', 'true' ); } } else if ( converter.isForPreview() ) { modelNode = ve.dm.nodeFactory.createFromElement( dataElement ); modelNode.setDocument( converter.internalList.getDocument() ); viewNode = ve.ce.nodeFactory.createFromModel( modelNode ); if ( !viewNode.hasRendering() ) { viewNode.onSetup(); viewNode.$element .append( viewNode.createInvisibleIcon() ) .attr( 'title', dataElement.attributes.text ); els = viewNode.$element.toArray(); viewNode.destroy(); return els; } } return els; }; ve.dm.MWTransclusionNode.static.describeChanges = function ( attributeChanges ) { var change, params, param, $paramChanges, from, to, descriptions = [ ve.msg( 'visualeditor-changedesc-mwtransclusion' ) ]; // This method assumes that the behavior of isDiffComparable above remains // the same, so it doesn't have to consider whether the actual template // involved has changed. function getLabel( param ) { // If a parameter is an object with a wt key, we just want the value of that. if ( param && param.wt !== undefined ) { // Can be `''`, and we're okay with that return param.wt; } return param; } if ( attributeChanges.mw.from.parts.length === 1 && attributeChanges.mw.to.parts.length === 1 ) { // Single-template transclusion, before and after. Relatively easy to summarize. // TODO: expand this to well-represent transclusions that contain multiple templates. // The bits of a template we care about are deeply-nested inside an // attribute. We'll restructure this so that we can pretend template // params are the direct attributes of the template. params = {}; for ( param in attributeChanges.mw.from.parts[ 0 ].template.params ) { params[ param ] = { from: getLabel( attributeChanges.mw.from.parts[ 0 ].template.params[ param ] ) }; } for ( param in attributeChanges.mw.to.parts[ 0 ].template.params ) { params[ param ] = ve.extendObject( { to: getLabel( attributeChanges.mw.to.parts[ 0 ].template.params[ param ] ) }, params[ param ] ); } for ( param in params ) { // All we know is that *something* changed, without the normal // helpful just-being-given-the-changed-bits, so we have to filter // this ourselves. // Trim string values, and convert empty strings to undefined from = ( params[ param ].from || '' ).trim() || undefined; to = ( params[ param ].to || '' ).trim() || undefined; if ( from !== to ) { change = this.describeChange( param, { from: from, to: to } ); if ( change ) { if ( !$paramChanges ) { $paramChanges = $( '