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

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

/**
 * MediaWiki template placeholder model.
 *
 * @class
 * @extends ve.dm.MWTransclusionPartModel
 *
 * @constructor
 * @param {ve.dm.MWTransclusionModel} transclusion Transclusion
 */
ve.dm.MWTemplatePlaceholderModel = function VeDmMWTemplatePlaceholderModel( transclusion ) {
	// Parent constructor
	ve.dm.MWTransclusionPartModel.call( this, transclusion );
};

/* 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.`
			`*`
			`* @copyright 2011-2013 VisualEditor Team and others; see AUTHORS.txt`
			`* @license The MIT License (MIT); see LICENSE.txt`
			`*/`

			`/**`
			`* MediaWiki template placeholder model.`
			`*`
			`* @class`
			`* @extends ve.dm.MWTransclusionPartModel`
			`*`
			`* @constructor`
			`* @param {ve.dm.MWTransclusionModel} transclusion Transclusion`
			`*/`
Preserve unused Parsoid template properties Problem: Parsoid has a property called "i" which we don't use, but they need for round-tripping purposes. Since we were generating a structure from Parsoid data and then generating data from the structure without preserving properties we didn't use, it was getting lost. Solution: Abstract creating a template from data vs. creating it from name. Make only templates have an origin argument in their constructors, so and set it within a set of static constructors that create a template for either data or a template name. Store the original data in the former case, and use it as a base when serializing. Changes: ve.ui.MWTranslcusionDialog.js * Remove no-longer-needed mw global declaration * Move most of the addTemplate function to a static constructor in the template model class ve.dm.MWTransclusionPartModel.js, ve.dm.MWTransclusionContentModel.js, ve.dm.MWTemplatePlaceholder * Remove unused origin argument/property/getter * Add serialize method (if needed) ve.dm.MWTranclusionModel.js * Move template/parameter generation from data into static constructor of template model * Move serialization to part classes ve.dm.MWTemplateModel.js * Add mw global declaration * Stop passing origin to parent constructor, store it locally instead * Add original data property/setter for preserving unused properties when round tripping * Add static constructors for generating a template from data or by name * Add serialize method Bug: 51150 Change-Id: Ide596a0ca0ae8f93ffce6e79b7234a1db7e0586c 2013-07-12 00:23:33 +00:00			`ve.dm.MWTemplatePlaceholderModel = function VeDmMWTemplatePlaceholderModel( 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			`// Parent constructor`
Preserve unused Parsoid template properties Problem: Parsoid has a property called "i" which we don't use, but they need for round-tripping purposes. Since we were generating a structure from Parsoid data and then generating data from the structure without preserving properties we didn't use, it was getting lost. Solution: Abstract creating a template from data vs. creating it from name. Make only templates have an origin argument in their constructors, so and set it within a set of static constructors that create a template for either data or a template name. Store the original data in the former case, and use it as a base when serializing. Changes: ve.ui.MWTranslcusionDialog.js * Remove no-longer-needed mw global declaration * Move most of the addTemplate function to a static constructor in the template model class ve.dm.MWTransclusionPartModel.js, ve.dm.MWTransclusionContentModel.js, ve.dm.MWTemplatePlaceholder * Remove unused origin argument/property/getter * Add serialize method (if needed) ve.dm.MWTranclusionModel.js * Move template/parameter generation from data into static constructor of template model * Move serialization to part classes ve.dm.MWTemplateModel.js * Add mw global declaration * Stop passing origin to parent constructor, store it locally instead * Add original data property/setter for preserving unused properties when round tripping * Add static constructors for generating a template from data or by name * Add serialize method Bug: 51150 Change-Id: Ide596a0ca0ae8f93ffce6e79b7234a1db7e0586c 2013-07-12 00:23:33 +00:00			`ve.dm.MWTransclusionPartModel.call( this, 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			`};`

			`/* 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 );`