/*! * VisualEditor DataModel MWExternalLinkAnnotation class. * * @copyright See AUTHORS.txt * @license The MIT License (MIT); see LICENSE.txt */ /** * DataModel MediaWiki external link annotation. * * Example HTML sources: * * http://example.com * Link content * * en:Foo * * Each example is semantically slightly different, but they don't need special treatment (yet). * * @class * @extends ve.dm.LinkAnnotation * @constructor * @param {Object} element */ ve.dm.MWExternalLinkAnnotation = function VeDmMWExternalLinkAnnotation() { // Parent constructor ve.dm.MWExternalLinkAnnotation.super.apply( this, arguments ); }; /* Inheritance */ OO.inheritClass( ve.dm.MWExternalLinkAnnotation, ve.dm.LinkAnnotation ); /* Static Properties */ ve.dm.MWExternalLinkAnnotation.static.name = 'link/mwExternal'; // Allow additional 'rel' values in Parsoid output (T321437) // Allow all unknown types for external paste (handled in toDataElement) ve.dm.MWExternalLinkAnnotation.static.allowedRdfaTypes = null; ve.dm.MWExternalLinkAnnotation.static.toDataElement = function ( domElements, converter ) { var domElement = domElements[ 0 ], type = domElement.getAttribute( 'rel' ) || domElement.getAttribute( 'typeof' ) || domElement.getAttribute( 'property' ) || '', types = type.trim().split( /\s+/ ); // If the link doesn't have a known RDFa type... if ( types.indexOf( 'mw:ExtLink' ) === -1 && types.indexOf( 'mw:WikiLink/Interwiki' ) === -1 ) { // ...when pasting: auto-convert it to the correct type (internal/external/span) if ( converter.isFromClipboard() ) { if ( domElement.hasAttribute( 'href' ) ) { var annotation = ve.ui.MWLinkAction.static.getLinkAnnotation( domElement.getAttribute( 'href' ), converter.getHtmlDocument() ); return annotation.element; } else { // Convert href-less links to a plain span, which will get stripped by sanitization return ve.dm.SpanAnnotation.static.toDataElement.apply( ve.dm.SpanAnnotation.static, arguments ); } } // ...otherwise (in Parsoid HTML): something is terribly wrong, alienate to avoid making // unnecessary DOM changes in Parsoid output and causing dirty diffs (T267282) return null; } // Parent method var dataElement = ve.dm.MWExternalLinkAnnotation.super.static.toDataElement.apply( this, arguments ); dataElement.attributes.rel = type; return dataElement; }; ve.dm.MWExternalLinkAnnotation.static.toDomElements = function ( dataElement, doc, converter ) { // Parent method var domElements = ve.dm.MWExternalLinkAnnotation.super.static.toDomElements.apply( this, arguments ); if ( converter.isForPreview() ) { // Ensure there is an 'external' class when rendering, as this may have been created locally. domElements[ 0 ].setAttribute( 'class', 'external' ); } // we just created that link so the 'rel' attribute should be safe domElements[ 0 ].setAttribute( 'rel', dataElement.attributes.rel || 'mw:ExtLink' ); return domElements; }; ve.dm.MWExternalLinkAnnotation.static.describeChange = function ( key, change ) { if ( key === 'href' ) { return ve.dm.LinkAnnotation.static.describeChange( key, change ); } return null; }; /* Methods */ /** * @return {Object} */ ve.dm.MWExternalLinkAnnotation.prototype.getComparableObject = function () { return { type: this.getType(), href: this.getAttribute( 'href' ), rel: this.getAttribute( 'rel' ) || 'mw:ExtLink' }; }; /** * @inheritdoc */ ve.dm.MWExternalLinkAnnotation.prototype.getComparableHtmlAttributes = function () { // Assume that wikitext never adds meaningful html attributes for comparison purposes, // although ideally this should be decided by Parsoid (Bug T95028). return {}; }; /* Registration */ ve.dm.modelRegistry.register( ve.dm.MWExternalLinkAnnotation );