mediawiki-extensions-Visual.../modules/ve-mw/dm/models/ve.dm.MWTemplatePlaceholderModel.js

/*!
 * VisualEditor DataModel MWTemplatePlaceholderModel class.
 *
 * @copyright 2011-2020 VisualEditor Team and others; see AUTHORS.txt
 * @license The MIT License (MIT); see LICENSE.txt
 */

/**
 * Represents a not yet realized template invocation as long as the user is still searching for a
 * template name. Meant to be an item in a {@see ve.dm.MWTransclusionModel}.
 *
 * @class
 * @extends ve.dm.MWTransclusionPartModel
 *
 * @constructor
 * @param {ve.dm.MWTransclusionModel} transclusion
 */
ve.dm.MWTemplatePlaceholderModel = function VeDmMWTemplatePlaceholderModel() {
	// Parent constructor
	ve.dm.MWTemplatePlaceholderModel.super.apply( this, arguments );
};

/* Inheritance */

OO.inheritClass( ve.dm.MWTemplatePlaceholderModel, ve.dm.MWTransclusionPartModel );
Template and content adding Objectives: * Allow adding content or templates within a transclusion * Add template placeholder to model and view which resolves to nothing when saving (thus disappearing if not resolved) Changes: .php Add links to new messages and files ve.ui.OutlineControlsWidget.js * Organize controls into "adders" and "movers" ve.ui.Widget.css * Add styles for adders/movers sections of outline controls * Make adders appear on hover to reduce clutter ve.ui.Icons-.css Add icon for "add item" ve.ui.Dialog.css * Add styles for add template fieldsets * Make placeholder items in the outline italic ve.ui.PagedDialog.js * Pass adders config to outline controls ve.ui.MWTransclusionDialog.js * Add support for adding content and templates ve.dm.MWTransclusionModel.js * Add addPlaceholder method ve.dm.MWTemplatePlaceholderModel.js * New class, pretty much an empty part * Using this makes the UI much easier to work with - no need to special case the outline control for new items * Because it's not supported specifically in ve.dm.MWTransclusionModel.getPlainObject, it produces nothing and goes away naturally on apply Change-Id: I3478560fb53ba2ccd3fb26bafb6a61e6415565eb 2013-06-18 21:24:16 +00:00			`/*!`
			`* VisualEditor DataModel MWTemplatePlaceholderModel class.`
			`*`
doc: Bump copyright year for 2020 Change-Id: I30539877543dc2a57bd1428a00d10ac46d8fc294 2020-01-08 17:13:04 +00:00			`* @copyright 2011-2020 VisualEditor Team and others; see AUTHORS.txt`
Template and content adding Objectives: * Allow adding content or templates within a transclusion * Add template placeholder to model and view which resolves to nothing when saving (thus disappearing if not resolved) Changes: .php Add links to new messages and files ve.ui.OutlineControlsWidget.js * Organize controls into "adders" and "movers" ve.ui.Widget.css * Add styles for adders/movers sections of outline controls * Make adders appear on hover to reduce clutter ve.ui.Icons-.css Add icon for "add item" ve.ui.Dialog.css * Add styles for add template fieldsets * Make placeholder items in the outline italic ve.ui.PagedDialog.js * Pass adders config to outline controls ve.ui.MWTransclusionDialog.js * Add support for adding content and templates ve.dm.MWTransclusionModel.js * Add addPlaceholder method ve.dm.MWTemplatePlaceholderModel.js * New class, pretty much an empty part * Using this makes the UI much easier to work with - no need to special case the outline control for new items * Because it's not supported specifically in ve.dm.MWTransclusionModel.getPlainObject, it produces nothing and goes away naturally on apply Change-Id: I3478560fb53ba2ccd3fb26bafb6a61e6415565eb 2013-06-18 21:24:16 +00:00			`* @license The MIT License (MIT); see LICENSE.txt`
			`*/`

			`/**`
Much longer descriptions of template dialog related classes The idea is to possibly rename some of these classes, based on these descriptions. But this should be done in later, separate patches. Change-Id: I7f9e5b2382711b434d6dd618489fa3ed8b7a46b4 2021-06-03 16:25:15 +00:00			`* Represents a not yet realized template invocation as long as the user is still searching for a`
			`* template name. Meant to be an item in a {@see ve.dm.MWTransclusionModel}.`
Template and content adding Objectives: * Allow adding content or templates within a transclusion * Add template placeholder to model and view which resolves to nothing when saving (thus disappearing if not resolved) Changes: .php Add links to new messages and files ve.ui.OutlineControlsWidget.js * Organize controls into "adders" and "movers" ve.ui.Widget.css * Add styles for adders/movers sections of outline controls * Make adders appear on hover to reduce clutter ve.ui.Icons-.css Add icon for "add item" ve.ui.Dialog.css * Add styles for add template fieldsets * Make placeholder items in the outline italic ve.ui.PagedDialog.js * Pass adders config to outline controls ve.ui.MWTransclusionDialog.js * Add support for adding content and templates ve.dm.MWTransclusionModel.js * Add addPlaceholder method ve.dm.MWTemplatePlaceholderModel.js * New class, pretty much an empty part * Using this makes the UI much easier to work with - no need to special case the outline control for new items * Because it's not supported specifically in ve.dm.MWTransclusionModel.getPlainObject, it produces nothing and goes away naturally on apply Change-Id: I3478560fb53ba2ccd3fb26bafb6a61e6415565eb 2013-06-18 21:24:16 +00:00			`*`
			`* @class`
			`* @extends ve.dm.MWTransclusionPartModel`
			`*`
			`* @constructor`
Remove @param/@return docs that literally repeat the code These don't add any knowledge but make the code harder to read and maintain, and are an additional source of errors. Change-Id: Ied57741a3f985e355adfddb4e75378d5c497faa9 2021-06-04 11:58:18 +00:00			`* @param {ve.dm.MWTransclusionModel} transclusion`
Template and content adding Objectives: * Allow adding content or templates within a transclusion * Add template placeholder to model and view which resolves to nothing when saving (thus disappearing if not resolved) Changes: .php Add links to new messages and files ve.ui.OutlineControlsWidget.js * Organize controls into "adders" and "movers" ve.ui.Widget.css * Add styles for adders/movers sections of outline controls * Make adders appear on hover to reduce clutter ve.ui.Icons-.css Add icon for "add item" ve.ui.Dialog.css * Add styles for add template fieldsets * Make placeholder items in the outline italic ve.ui.PagedDialog.js * Pass adders config to outline controls ve.ui.MWTransclusionDialog.js * Add support for adding content and templates ve.dm.MWTransclusionModel.js * Add addPlaceholder method ve.dm.MWTemplatePlaceholderModel.js * New class, pretty much an empty part * Using this makes the UI much easier to work with - no need to special case the outline control for new items * Because it's not supported specifically in ve.dm.MWTransclusionModel.getPlainObject, it produces nothing and goes away naturally on apply Change-Id: I3478560fb53ba2ccd3fb26bafb6a61e6415565eb 2013-06-18 21:24:16 +00:00			`*/`
Use super property to call parent methods Change-Id: I76982b844cf2871d7583463def4393e5bdc33aa2 2016-08-22 21:44:59 +00:00			`ve.dm.MWTemplatePlaceholderModel = function VeDmMWTemplatePlaceholderModel() {`
Template and content adding Objectives: * Allow adding content or templates within a transclusion * Add template placeholder to model and view which resolves to nothing when saving (thus disappearing if not resolved) Changes: .php Add links to new messages and files ve.ui.OutlineControlsWidget.js * Organize controls into "adders" and "movers" ve.ui.Widget.css * Add styles for adders/movers sections of outline controls * Make adders appear on hover to reduce clutter ve.ui.Icons-.css Add icon for "add item" ve.ui.Dialog.css * Add styles for add template fieldsets * Make placeholder items in the outline italic ve.ui.PagedDialog.js * Pass adders config to outline controls ve.ui.MWTransclusionDialog.js * Add support for adding content and templates ve.dm.MWTransclusionModel.js * Add addPlaceholder method ve.dm.MWTemplatePlaceholderModel.js * New class, pretty much an empty part * Using this makes the UI much easier to work with - no need to special case the outline control for new items * Because it's not supported specifically in ve.dm.MWTransclusionModel.getPlainObject, it produces nothing and goes away naturally on apply Change-Id: I3478560fb53ba2ccd3fb26bafb6a61e6415565eb 2013-06-18 21:24:16 +00:00			`// Parent constructor`
Use super property to call parent methods Change-Id: I76982b844cf2871d7583463def4393e5bdc33aa2 2016-08-22 21:44:59 +00:00			`ve.dm.MWTemplatePlaceholderModel.super.apply( this, arguments );`
Template and content adding Objectives: * Allow adding content or templates within a transclusion * Add template placeholder to model and view which resolves to nothing when saving (thus disappearing if not resolved) Changes: .php Add links to new messages and files ve.ui.OutlineControlsWidget.js * Organize controls into "adders" and "movers" ve.ui.Widget.css * Add styles for adders/movers sections of outline controls * Make adders appear on hover to reduce clutter ve.ui.Icons-.css Add icon for "add item" ve.ui.Dialog.css * Add styles for add template fieldsets * Make placeholder items in the outline italic ve.ui.PagedDialog.js * Pass adders config to outline controls ve.ui.MWTransclusionDialog.js * Add support for adding content and templates ve.dm.MWTransclusionModel.js * Add addPlaceholder method ve.dm.MWTemplatePlaceholderModel.js * New class, pretty much an empty part * Using this makes the UI much easier to work with - no need to special case the outline control for new items * Because it's not supported specifically in ve.dm.MWTransclusionModel.getPlainObject, it produces nothing and goes away naturally on apply Change-Id: I3478560fb53ba2ccd3fb26bafb6a61e6415565eb 2013-06-18 21:24:16 +00:00			`};`

			`/* Inheritance */`

Remove ve.{inheritClass,mixinClass} and use OO instead Change-Id: I8df9226a358a76b661eab6e967ff0d63d361f691 2013-10-11 21:44:09 +00:00			`OO.inheritClass( ve.dm.MWTemplatePlaceholderModel, ve.dm.MWTransclusionPartModel );`