2013-04-10 18:15:15 +00:00
|
|
|
/*!
|
2013-06-11 19:16:04 +00:00
|
|
|
* VisualEditor ContentEditable MWTransclusionNode class.
|
2013-04-10 18:15:15 +00:00
|
|
|
*
|
2023-12-01 16:06:11 +00:00
|
|
|
* @copyright See AUTHORS.txt
|
2013-04-10 18:15:15 +00:00
|
|
|
* @license The MIT License (MIT); see LICENSE.txt
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
2013-06-11 19:16:04 +00:00
|
|
|
* ContentEditable MediaWiki transclusion node.
|
2013-04-10 18:15:15 +00:00
|
|
|
*
|
|
|
|
* @class
|
|
|
|
* @abstract
|
2013-05-29 01:35:42 +00:00
|
|
|
* @extends ve.ce.LeafNode
|
2024-04-29 17:51:41 +00:00
|
|
|
* @mixes ve.ce.GeneratedContentNode
|
|
|
|
* @mixes ve.ce.FocusableNode
|
ve.ce.ProtectedNode
Objective:
Generalize the shield and phantom magic, so we can use it for pretty much
any node we like. Usually this will be used with generated content nodes,
but also with aliens (of course) and possible other stuff in the future.
Bonus:
Also fixes a bug in DM that would crash VE when you selected to the end
and hit backspace.
Changes:
*.php
* Added links to files
aliens.html
* Added attributes to aliens to make them aliens again
ve.ce.AlienNode.js
* Moved shield and phantom functionality to ve.ce.ProtectedNode
ve.ce.AlienNode.js, ve.ce.MWReferenceListNode.js,
ve.ce.MWReferenceNode.js, ve.ce.MWTemplateNode.js
* Mixed in ve.ce.ProtectedNode
ve.ce.Node.css
* Reorganized styles and updated class names
* Added simple light blue hover with outline (using inset box shadow) for
protected nodes, same style as before for aliens
ve.ce.Surface.css
* Moved phantom styles to ve.ce.Node.css
ve.ce.BranchNode.js
* Moved call to setLive(false) to happen before detach() so that the
surface object is still available and events can be disconnected
ve.ce.BranchNode.js, ve.ce.Document.js, ve.ce.js, ve.ce.Surface.js, ve.ce.SurfaceObserver.js
* Adjusted CSS class names
ve.ce.Node.js
* Moved shield template to ve.ce.ProtectedNode
ve.ce.ProtectedNode.js
* New class, mix into another class to protect it from editing
ve.ce.RelocatableNode.js
* Renamed temporary surface property to relocatingSurface to avoid
confusion when debugging
ve.ce.Surface.js
* Moved phantom template to ve.ce.ProtectedNode
ve.dm.Transaction.js
* Fixed bug where most of the internal list was being deleted when the
end of the document was selected and the user pressed backspace
Change-Id: I2468b16e1ba6785ad298e38190e33493135719c3
2013-05-07 00:07:01 +00:00
|
|
|
*
|
2013-04-10 18:15:15 +00:00
|
|
|
* @constructor
|
2013-06-11 19:16:04 +00:00
|
|
|
* @param {ve.dm.MWTransclusionNode} model Model to observe
|
2013-09-25 10:21:09 +00:00
|
|
|
* @param {Object} [config] Configuration options
|
2013-04-10 18:15:15 +00:00
|
|
|
*/
|
2013-06-11 19:16:04 +00:00
|
|
|
ve.ce.MWTransclusionNode = function VeCeMWTransclusionNode( model, config ) {
|
2013-04-10 18:15:15 +00:00
|
|
|
// Parent constructor
|
2015-08-03 14:25:03 +00:00
|
|
|
ve.ce.MWTransclusionNode.super.call( this, model, config );
|
2013-04-10 18:15:15 +00:00
|
|
|
|
ve.ce.ProtectedNode
Objective:
Generalize the shield and phantom magic, so we can use it for pretty much
any node we like. Usually this will be used with generated content nodes,
but also with aliens (of course) and possible other stuff in the future.
Bonus:
Also fixes a bug in DM that would crash VE when you selected to the end
and hit backspace.
Changes:
*.php
* Added links to files
aliens.html
* Added attributes to aliens to make them aliens again
ve.ce.AlienNode.js
* Moved shield and phantom functionality to ve.ce.ProtectedNode
ve.ce.AlienNode.js, ve.ce.MWReferenceListNode.js,
ve.ce.MWReferenceNode.js, ve.ce.MWTemplateNode.js
* Mixed in ve.ce.ProtectedNode
ve.ce.Node.css
* Reorganized styles and updated class names
* Added simple light blue hover with outline (using inset box shadow) for
protected nodes, same style as before for aliens
ve.ce.Surface.css
* Moved phantom styles to ve.ce.Node.css
ve.ce.BranchNode.js
* Moved call to setLive(false) to happen before detach() so that the
surface object is still available and events can be disconnected
ve.ce.BranchNode.js, ve.ce.Document.js, ve.ce.js, ve.ce.Surface.js, ve.ce.SurfaceObserver.js
* Adjusted CSS class names
ve.ce.Node.js
* Moved shield template to ve.ce.ProtectedNode
ve.ce.ProtectedNode.js
* New class, mix into another class to protect it from editing
ve.ce.RelocatableNode.js
* Renamed temporary surface property to relocatingSurface to avoid
confusion when debugging
ve.ce.Surface.js
* Moved phantom template to ve.ce.ProtectedNode
ve.dm.Transaction.js
* Fixed bug where most of the internal list was being deleted when the
end of the document was selected and the user pressed backspace
Change-Id: I2468b16e1ba6785ad298e38190e33493135719c3
2013-05-07 00:07:01 +00:00
|
|
|
// Mixin constructors
|
2013-05-29 01:35:42 +00:00
|
|
|
ve.ce.GeneratedContentNode.call( this );
|
2015-08-03 14:25:03 +00:00
|
|
|
ve.ce.FocusableNode.call( this );
|
2013-04-10 18:15:15 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
/* Inheritance */
|
|
|
|
|
2013-10-11 21:44:09 +00:00
|
|
|
OO.inheritClass( ve.ce.MWTransclusionNode, ve.ce.LeafNode );
|
2013-04-10 18:15:15 +00:00
|
|
|
|
2015-08-03 14:25:03 +00:00
|
|
|
OO.mixinClass( ve.ce.MWTransclusionNode, ve.ce.GeneratedContentNode );
|
|
|
|
OO.mixinClass( ve.ce.MWTransclusionNode, ve.ce.FocusableNode );
|
2013-05-29 01:35:42 +00:00
|
|
|
|
2013-04-10 18:15:15 +00:00
|
|
|
/* Static Properties */
|
|
|
|
|
2013-06-11 19:16:04 +00:00
|
|
|
ve.ce.MWTransclusionNode.static.name = 'mwTransclusion';
|
2013-04-10 18:15:15 +00:00
|
|
|
|
2013-12-20 23:25:24 +00:00
|
|
|
ve.ce.MWTransclusionNode.static.primaryCommandName = 'transclusion';
|
|
|
|
|
2017-07-06 16:52:56 +00:00
|
|
|
ve.ce.MWTransclusionNode.static.iconWhenInvisible = 'puzzle';
|
2016-01-27 17:50:13 +00:00
|
|
|
|
2014-06-10 01:18:23 +00:00
|
|
|
/* Static Methods */
|
|
|
|
|
|
|
|
/**
|
2022-03-04 09:14:20 +00:00
|
|
|
* Get a plain text description of the template parts in a transclusion node, excluding raw wikitext
|
2022-01-13 10:55:20 +00:00
|
|
|
* snippets.
|
2015-08-19 16:05:17 +00:00
|
|
|
*
|
|
|
|
* @static
|
2022-03-04 09:14:20 +00:00
|
|
|
* @param {ve.dm.MWTransclusionNode} model
|
|
|
|
* @return {string} Comma-separated list of template names
|
2015-08-19 16:05:17 +00:00
|
|
|
*/
|
|
|
|
ve.ce.MWTransclusionNode.static.getDescription = function ( model ) {
|
2022-03-04 09:14:20 +00:00
|
|
|
return model.getPartsList()
|
|
|
|
.map( function ( part ) {
|
|
|
|
if ( part.templatePage ) {
|
|
|
|
return mw.Title.newFromText( part.templatePage )
|
|
|
|
.getRelativeText( mw.config.get( 'wgNamespaceIds' ).template );
|
|
|
|
}
|
|
|
|
// Not actually a template, but e.g. a parser function
|
|
|
|
return part.template || '';
|
|
|
|
} )
|
2019-02-24 13:24:41 +00:00
|
|
|
.filter( function ( desc ) {
|
|
|
|
return desc;
|
|
|
|
} )
|
2014-11-18 22:23:33 +00:00
|
|
|
.join( ve.msg( 'comma-separator' ) );
|
2014-06-10 01:18:23 +00:00
|
|
|
};
|
|
|
|
|
2023-02-20 15:33:52 +00:00
|
|
|
/**
|
|
|
|
* Get a formatted description of the template parts in a transclusion node, excluding raw wikitext
|
|
|
|
* snippets.
|
|
|
|
*
|
|
|
|
* Like #getDescription, but parts generated from templates are linked to
|
|
|
|
* those templates
|
|
|
|
*
|
|
|
|
* @static
|
|
|
|
* @param {ve.dm.MWTransclusionNode} model
|
|
|
|
* @return {HTMLElement} DOM node with comma-separated list of template names
|
|
|
|
*/
|
|
|
|
ve.ce.MWTransclusionNode.static.getDescriptionDom = function ( model ) {
|
|
|
|
var nodes = model.getPartsList()
|
|
|
|
.map( function ( part ) {
|
|
|
|
if ( part.templatePage ) {
|
|
|
|
var title = mw.Title.newFromText( part.templatePage );
|
|
|
|
var link = document.createElement( 'a' );
|
|
|
|
link.textContent = title.getRelativeText( mw.config.get( 'wgNamespaceIds' ).template );
|
|
|
|
link.setAttribute( 'href', title.getUrl() );
|
|
|
|
return link;
|
|
|
|
}
|
|
|
|
// Not actually a template, but e.g. a parser function
|
|
|
|
return part.template ? document.createTextNode( part.template ) : null;
|
|
|
|
} )
|
|
|
|
.filter( function ( desc ) {
|
|
|
|
return desc;
|
|
|
|
} );
|
|
|
|
var span = document.createElement( 'span' );
|
|
|
|
nodes.forEach( function ( node, i ) {
|
|
|
|
if ( i ) {
|
|
|
|
span.appendChild( document.createTextNode( ve.msg( 'comma-separator' ) ) );
|
|
|
|
}
|
|
|
|
span.appendChild( node );
|
|
|
|
} );
|
|
|
|
ve.targetLinksToNewWindow( span );
|
|
|
|
return span;
|
|
|
|
};
|
|
|
|
|
2016-05-15 11:08:13 +00:00
|
|
|
/**
|
|
|
|
* Filter rendering to remove auto-generated content and wrappers
|
|
|
|
*
|
|
|
|
* @static
|
2018-05-16 17:52:34 +00:00
|
|
|
* @param {Node[]} contentNodes Rendered nodes
|
|
|
|
* @return {Node[]} Filtered rendered nodes
|
2016-05-15 11:08:13 +00:00
|
|
|
*/
|
|
|
|
ve.ce.MWTransclusionNode.static.filterRendering = function ( contentNodes ) {
|
2017-11-23 12:21:16 +00:00
|
|
|
if ( !contentNodes.length ) {
|
2022-01-13 10:55:20 +00:00
|
|
|
return [];
|
2017-11-23 12:21:16 +00:00
|
|
|
}
|
|
|
|
|
2021-06-21 08:10:27 +00:00
|
|
|
var whitespaceRegex = new RegExp( '^[' + ve.dm.Converter.static.whitespaceList + ']+$' );
|
2017-11-23 12:21:16 +00:00
|
|
|
|
2018-01-11 20:42:16 +00:00
|
|
|
// Filter out auto-generated items, e.g. reference lists
|
|
|
|
contentNodes = contentNodes.filter( function ( node ) {
|
2017-11-23 12:21:16 +00:00
|
|
|
var dataMw = node &&
|
|
|
|
node.nodeType === Node.ELEMENT_NODE &&
|
2016-05-15 11:08:13 +00:00
|
|
|
node.hasAttribute( 'data-mw' ) &&
|
|
|
|
JSON.parse( node.getAttribute( 'data-mw' ) );
|
2017-11-23 12:21:16 +00:00
|
|
|
|
2018-01-11 20:42:16 +00:00
|
|
|
return !dataMw || !dataMw.autoGenerated;
|
2016-05-15 11:08:13 +00:00
|
|
|
} );
|
2017-11-23 12:21:16 +00:00
|
|
|
|
2018-05-16 17:52:34 +00:00
|
|
|
contentNodes.forEach( function ( node ) {
|
|
|
|
if ( node.nodeType === Node.ELEMENT_NODE ) {
|
2020-03-20 17:08:24 +00:00
|
|
|
mw.libs.ve.stripParsoidFallbackIds( node );
|
2018-05-16 17:52:34 +00:00
|
|
|
}
|
|
|
|
} );
|
|
|
|
|
2017-11-23 12:21:16 +00:00
|
|
|
function isWhitespaceNode( node ) {
|
2022-01-13 11:10:02 +00:00
|
|
|
return node && node.nodeType === Node.TEXT_NODE && whitespaceRegex.test( node.data );
|
2017-11-23 12:21:16 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
while ( isWhitespaceNode( contentNodes[ 0 ] ) ) {
|
|
|
|
contentNodes.shift();
|
|
|
|
}
|
|
|
|
while ( isWhitespaceNode( contentNodes[ contentNodes.length - 1 ] ) ) {
|
|
|
|
contentNodes.pop();
|
|
|
|
}
|
2016-05-15 11:08:13 +00:00
|
|
|
// HACK: if $content consists of a single paragraph, unwrap it.
|
|
|
|
// We have to do this because the parser wraps everything in <p>s, and inline templates
|
|
|
|
// will render strangely when wrapped in <p>s.
|
|
|
|
if ( contentNodes.length === 1 && contentNodes[ 0 ].nodeName.toLowerCase() === 'p' ) {
|
2017-11-23 12:21:16 +00:00
|
|
|
contentNodes = Array.prototype.slice.call( contentNodes[ 0 ].childNodes );
|
2016-05-15 11:08:13 +00:00
|
|
|
}
|
|
|
|
return contentNodes;
|
|
|
|
};
|
|
|
|
|
2013-04-10 18:15:15 +00:00
|
|
|
/* Methods */
|
|
|
|
|
2022-01-18 16:28:05 +00:00
|
|
|
/** @inheritDoc */
|
|
|
|
ve.ce.MWTransclusionNode.prototype.executeCommand = function () {
|
|
|
|
var contextItems = this.focusableSurface.getSurface().getContext().items;
|
2023-07-11 17:10:33 +00:00
|
|
|
var contextClicked = contextItems.some( function ( contextItem ) {
|
|
|
|
if ( contextItem instanceof ve.ui.MWTransclusionContextItem ) {
|
|
|
|
// Utilize the context item when it's there instead of triggering the command manually.
|
|
|
|
// Required to make the context item show the "Loading…" message (see T297773).
|
|
|
|
contextItem.onEditButtonClick();
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
return false;
|
|
|
|
} );
|
|
|
|
|
|
|
|
if ( contextClicked ) {
|
2022-01-18 16:28:05 +00:00
|
|
|
return;
|
|
|
|
}
|
|
|
|
|
|
|
|
// Parent method
|
|
|
|
ve.ce.FocusableNode.prototype.executeCommand.apply( this, arguments );
|
|
|
|
};
|
|
|
|
|
2015-03-26 18:12:46 +00:00
|
|
|
/**
|
|
|
|
* @inheritdoc
|
|
|
|
*/
|
2013-08-03 23:05:51 +00:00
|
|
|
ve.ce.MWTransclusionNode.prototype.generateContents = function ( config ) {
|
2021-10-13 12:57:45 +00:00
|
|
|
var deferred = ve.createDeferred();
|
|
|
|
var xhr = ve.init.target.parseWikitextFragment(
|
2018-04-06 11:30:57 +00:00
|
|
|
( config && config.wikitext ) || this.model.getWikitext(),
|
|
|
|
true,
|
|
|
|
this.getModel().getDocument()
|
|
|
|
)
|
2014-07-08 22:33:32 +00:00
|
|
|
.done( this.onParseSuccess.bind( this, deferred ) )
|
|
|
|
.fail( this.onParseError.bind( this, deferred ) );
|
2013-10-17 11:39:27 +00:00
|
|
|
|
2013-12-06 02:34:44 +00:00
|
|
|
return deferred.promise( { abort: xhr.abort } );
|
2013-05-15 23:51:11 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Handle a successful response from the parser for the wikitext fragment.
|
|
|
|
*
|
2013-08-02 22:35:42 +00:00
|
|
|
* @param {jQuery.Deferred} deferred The Deferred object created by #generateContents
|
2013-05-15 23:51:11 +00:00
|
|
|
* @param {Object} response Response data
|
|
|
|
*/
|
2013-06-18 17:56:56 +00:00
|
|
|
ve.ce.MWTransclusionNode.prototype.onParseSuccess = function ( deferred, response ) {
|
2015-08-07 18:16:09 +00:00
|
|
|
if ( ve.getProp( response, 'visualeditor', 'result' ) !== 'success' ) {
|
2019-04-16 15:17:29 +00:00
|
|
|
this.onParseError( deferred );
|
|
|
|
return;
|
2013-08-02 22:35:42 +00:00
|
|
|
}
|
|
|
|
|
2015-01-07 20:00:53 +00:00
|
|
|
// Work around https://github.com/jquery/jquery/issues/1997
|
2021-06-21 08:10:27 +00:00
|
|
|
var contentNodes = $.parseHTML( response.visualeditor.content, this.model && this.getModelHtmlDocument() ) || [];
|
2016-05-15 11:08:13 +00:00
|
|
|
deferred.resolve( this.constructor.static.filterRendering( contentNodes ) );
|
2013-05-15 23:51:11 +00:00
|
|
|
};
|
|
|
|
|
2015-03-02 22:34:02 +00:00
|
|
|
/**
|
|
|
|
* Extend the ve.ce.GeneratedContentNode render method to check for hidden templates.
|
|
|
|
*
|
|
|
|
* Check if the final result of the imported template is empty.
|
|
|
|
*
|
2016-10-28 19:02:36 +00:00
|
|
|
* @inheritdoc ve.ce.GeneratedContentNode
|
2015-03-02 22:34:02 +00:00
|
|
|
*/
|
|
|
|
ve.ce.MWTransclusionNode.prototype.render = function ( generatedContents ) {
|
|
|
|
// Call parent mixin
|
|
|
|
ve.ce.GeneratedContentNode.prototype.render.call( this, generatedContents );
|
2016-08-02 10:43:17 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @inheritdoc
|
|
|
|
*/
|
|
|
|
ve.ce.MWTransclusionNode.prototype.onSetup = function () {
|
|
|
|
// Parent method
|
|
|
|
ve.ce.MWTransclusionNode.super.prototype.onSetup.apply( this, arguments );
|
2015-03-02 22:34:02 +00:00
|
|
|
|
2016-01-27 17:50:13 +00:00
|
|
|
// Render replaces this.$element with a new node so re-add classes
|
2015-03-02 22:34:02 +00:00
|
|
|
this.$element.addClass( 've-ce-mwTransclusionNode' );
|
|
|
|
};
|
|
|
|
|
2014-10-03 01:27:55 +00:00
|
|
|
/**
|
|
|
|
* @inheritdoc
|
|
|
|
*/
|
2017-03-30 16:37:54 +00:00
|
|
|
ve.ce.MWTransclusionNode.prototype.getRenderedDomElements = function () {
|
|
|
|
// Parent method
|
|
|
|
var elements = ve.ce.GeneratedContentNode.prototype.getRenderedDomElements.apply( this, arguments );
|
|
|
|
|
2017-07-24 16:31:19 +00:00
|
|
|
if ( this.model && this.getModelHtmlDocument() ) {
|
2017-03-30 16:37:54 +00:00
|
|
|
ve.init.platform.linkCache.styleParsoidElements(
|
|
|
|
$( elements ),
|
|
|
|
this.getModelHtmlDocument()
|
|
|
|
);
|
2015-02-17 03:18:44 +00:00
|
|
|
}
|
2017-03-30 16:37:54 +00:00
|
|
|
return elements;
|
2014-10-03 01:27:55 +00:00
|
|
|
};
|
|
|
|
|
2018-08-20 17:32:43 +00:00
|
|
|
/**
|
|
|
|
* @inheritdoc
|
|
|
|
*/
|
|
|
|
ve.ce.MWTransclusionNode.prototype.filterRenderedDomElements = function ( domElements ) {
|
|
|
|
// We want to remove all styles and links which aren't from TemplateStyles.
|
2022-08-23 13:21:41 +00:00
|
|
|
var selector = 'style:not([data-mw-deduplicate^="TemplateStyles:"]), link:not([rel~="mw-deduplicated-inline-style"][href^="mw-data:TemplateStyles:"])';
|
2018-08-20 17:32:43 +00:00
|
|
|
return $( domElements ).find( selector ).addBack( selector ).remove().end().end().toArray();
|
|
|
|
};
|
|
|
|
|
2013-05-15 23:51:11 +00:00
|
|
|
/**
|
|
|
|
* Handle an unsuccessful response from the parser for the wikitext fragment.
|
|
|
|
*
|
2013-08-02 22:35:42 +00:00
|
|
|
* @param {jQuery.Deferred} deferred The promise object created by #generateContents
|
2013-05-15 23:51:11 +00:00
|
|
|
* @param {Object} response Response data
|
|
|
|
*/
|
2013-06-18 17:56:56 +00:00
|
|
|
ve.ce.MWTransclusionNode.prototype.onParseError = function ( deferred ) {
|
|
|
|
deferred.reject();
|
2013-04-10 18:15:15 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
/* Registration */
|
|
|
|
|
2013-06-11 19:16:04 +00:00
|
|
|
ve.ce.nodeFactory.register( ve.ce.MWTransclusionNode );
|