mediawiki-extensions-TemplateData/modules/ext.templateDataGenerator.ui.js

( function () {
	/**
	 * TemplateData Generator data model.
	 * This singleton is independent of any UI; it expects
	 * a templatedata string, converts it into the object
	 * model and manages it, fully event-driven.
	 *
	 * @author Moriel Schottlender
	 */
	'use strict';
	mw.libs.tdgUi = ( function () {
		var isPageSubLevel,
			isDocPage,
			pageName,
			parentPage,
			$textbox,
			/**
			 * ooui Window Manager
			 */
			tdgDialog,
			windowManager,
			/**
			 * Edit window elements
			 */
			editOpenDialogButton,
			editNoticeLabel,

		editArea = {
			/**
			 * Display error message in the edit window
			 * @param {string} msg Message to display
			 * @param {string} type Message type 'notice' or 'error'
			 * @param {boolean} [parseHTML] The message should be parsed
			 */
			setNoticeMessage: function ( msg, type, parseHTML ) {
				type = type || 'error';
				editNoticeLabel.$element.toggleClass( 'errorbox', type === 'error' );

				if ( parseHTML ) {
					// OOUI's label elements do not parse strings and display them
					// as-is. If the message contains html that should be parsed,
					// we have to transform it into a jQuery object
					msg = $( '<span>' ).append( $.parseHTML( msg ) );
				}
				editNoticeLabel.setLabel( msg );
				editNoticeLabel.toggle( true );
			},

			/**
			 * Reset the error message in the edit window
			 */
			resetNoticeMessage: function () {
				editNoticeLabel.setLabel( '' );
				editNoticeLabel.toggle( false );
			}
		},

		/**
		 * Respond to edit dialog button click.
		 */
		onEditOpenDialogButton = function () {
			// Reset notice message
			editArea.resetNoticeMessage();
			// Open the dialog
			windowManager.openWindow( tdgDialog, {
				wikitext: $textbox.val(),
				config: {
					parentPage: parentPage,
					isPageSubLevel: !!isPageSubLevel
				}
			} );
		},

		/**
		 * Respond to edit dialog apply event
		 * @param {string} templateDataString New templatedata string
		 */
		onDialogApply = function ( templateDataString ) {
			$textbox.val( replaceTemplateData( templateDataString ) );
		},

		/**
		 * Replace the old templatedata string with the new one, or
		 * insert the new one into the page if an old one doesn't exist
		 * @param {string} newTemplateData New templatedata string
		 * @return {string} Full wikitext content with the new templatedata
		 *  string.
		 */
		replaceTemplateData = function ( newTemplateData ) {
			var finalOutput,
				fullWikitext = $textbox.val(),
				parts = fullWikitext.match(
					/<templatedata>([\s\S]*?)<\/templatedata>/i
				);

			if ( parts && parts[1] ) {
				// <templatedata> exists. Replace it
				finalOutput = fullWikitext.replace(
					/(<templatedata>)([\s\S]*?)(<\/templatedata>)/i,
					'<templatedata>\n' + newTemplateData + '\n</templatedata>'
				);
			} else {
				if ( isPageSubLevel ) {
					// Add the <templatedata>
					finalOutput = fullWikitext + '\n<templatedata>\n' +
						newTemplateData +
						'\n</templatedata>\n';
				} else {
					// If we are not in a subpage, add <noinclude> tags
					finalOutput = fullWikitext + '\n<noinclude>\n<templatedata>\n' +
						newTemplateData +
						'\n</templatedata>\n</noinclude>\n';
				}
			}
			return finalOutput;
		};

		return {
			/**
			 * Initialize UI
			 * @param {jQuery} $container The container to attach UI buttons to
			 * @param {jQuery} $editorTextbox The editor textbox to take the
			 *  current wikitext from.
			 */
			init: function ( $container, $editorTextbox, userConfig ) {
				var editHelpButtonWidget, relatedPage,
					config = userConfig;

				$textbox = $editorTextbox;

				pageName = config.pageName;
				parentPage = config.parentPage;
				isPageSubLevel = !!config.isPageSubLevel;
				isDocPage = !!config.isDocPage;

				editOpenDialogButton = new OO.ui.ButtonWidget( {
					label: mw.msg( 'templatedata-editbutton' )
				} );

				editNoticeLabel = new OO.ui.LabelWidget( {
					classes: [ 'tdg-editscreen-error-msg' ]
				} )
					.toggle( false );

				editHelpButtonWidget = new OO.ui.ButtonWidget( {
					label: mw.msg( 'templatedata-helplink' ),
					classes: [ 'tdg-editscreen-main-helplink' ],
					href: 'https://www.mediawiki.org/wiki/Extension:TemplateData',
					target: '_blank',
					framed: false
				} );

				// Dialog
				windowManager = new OO.ui.WindowManager();
				tdgDialog = new mw.TemplateData.Dialog( config );
				windowManager.addWindows( [ tdgDialog ] );

				// Check if there's already a templatedata in a related page
				relatedPage = isDocPage ? parentPage : pageName + '/doc';
				editOpenDialogButton.setDisabled( true );
				mw.TemplateData.Model.static.getApi( relatedPage, true )
					.then( function ( result ) {
						var msg;
						if ( !$.isEmptyObject( result.pages ) ) {
							// HACK: Setting a link in the messages doesn't work. The bug report offers
							// a somewhat hacky work around that includes setting a separate message
							// to be parsed.
							// https://phabricator.wikimedia.org/T49395#490610
							msg = mw.message( 'templatedata-exists-on-related-page', relatedPage ).plain();
							mw.messages.set( { 'templatedata-string-exists-hack-message': msg } );
							msg = mw.message( 'templatedata-string-exists-hack-message' ).parse();

							editArea.setNoticeMessage( msg, 'error', true );
						}
						editOpenDialogButton.setDisabled( false );
					} );

				// Prepend to container
				$container
					.prepend(
						$( '<div>' )
							.addClass( 'tdg-editscreen-main' )
							.append(
								editOpenDialogButton.$element,
								editHelpButtonWidget.$element,
								editNoticeLabel.$element
							)
					);
				$( 'body' )
					.append( windowManager.$element );

				// UI events
				editOpenDialogButton.connect( this, { click: onEditOpenDialogButton } );

				tdgDialog.connect( this, {
					apply: onDialogApply
				} );
			}
		};
	}() );
}() );