/*! * VisualEditor MediaWiki Initialization DesktopArticleTarget class. * * @copyright See AUTHORS.txt * @license The MIT License (MIT); see LICENSE.txt */ /* eslint-disable no-jquery/no-global-selector */ /** * MediaWiki desktop article target. * * @class * @extends ve.init.mw.ArticleTarget * * @constructor * @param {Object} [config] */ ve.init.mw.DesktopArticleTarget = function VeInitMwDesktopArticleTarget( config ) { // Parent constructor ve.init.mw.DesktopArticleTarget.super.call( this, config ); // Parent constructor bound key event handlers, but we don't want them bound until // we activate; so unbind them again this.unbindHandlers(); this.onWatchToggleHandler = this.onWatchToggle.bind( this ); // Properties this.onBeforeUnloadFallback = null; this.onBeforeUnload = this.onBeforeUnload.bind( this ); this.onUnloadHandler = this.onUnload.bind( this ); this.activating = false; this.deactivating = false; this.deactivatingDeferred = null; this.recreating = false; this.activatingDeferred = null; this.toolbarSetupDeferred = null; this.suppressNormalStartupDialogs = false; this.editingTabDialog = null; this.welcomeDialog = null; this.welcomeDialogPromise = null; // If this is true then #transformPage / #restorePage will not call pushState // This is to avoid adding a new history entry for the url we just got from onpopstate // (which would mess up with the expected order of Back/Forwards browsing) this.actFromPopState = false; this.popState = { tag: 'visualeditor' }; this.scrollTop = null; this.section = null; if ( $( '#wpSummary' ).length ) { this.initialEditSummary = $( '#wpSummary' ).val(); } else { this.initialEditSummary = this.currentUrl.searchParams.get( 'summary' ); } this.initialCheckboxes = $( '.editCheckboxes input' ).toArray() .reduce( ( initialCheckboxes, node ) => { initialCheckboxes[ node.name ] = node.checked; return initialCheckboxes; }, {} ); this.tabLayout = mw.config.get( 'wgVisualEditorConfig' ).tabLayout; this.events = new ve.init.mw.ArticleTargetEvents( this ); this.$originalContent = $( '
' ).addClass( 've-init-mw-desktopArticleTarget-originalContent' ); this.$editableContent.addClass( 've-init-mw-desktopArticleTarget-editableContent' ); // Initialization this.$element .addClass( 've-init-mw-desktopArticleTarget' ) .append( this.$originalContent ); // We replace the current state with one that's marked with our tag. This way, when users // use the Back button to exit the editor we can restore Read mode. This is because we want // to ignore foreign states in onWindowPopState. Without this, the Read state is foreign. // FIXME: There should be a much better solution than this. history.replaceState( this.popState, '', this.currentUrl ); this.setupSkinTabs(); window.addEventListener( 'popstate', this.onWindowPopState.bind( this ) ); }; /* Inheritance */ OO.inheritClass( ve.init.mw.DesktopArticleTarget, ve.init.mw.ArticleTarget ); /* Static Properties */ ve.init.mw.DesktopArticleTarget.static.toolbarGroups = ve.copy( ve.init.mw.DesktopArticleTarget.static.toolbarGroups ); ve.init.mw.DesktopArticleTarget.static.toolbarGroups.push( { name: 'help', align: 'after', type: 'mwHelpList', icon: 'help', indicator: null, title: ve.msg( 'visualeditor-help-tool' ), include: [ { group: 'help' } ], promote: [ 'mwUserGuide' ] }, { name: 'notices', align: 'after', include: [ { group: 'notices' } ] }, { name: 'pageMenu', align: 'after', type: 'list', icon: 'menu', indicator: null, title: ve.msg( 'visualeditor-pagemenu-tooltip' ), label: ve.msg( 'visualeditor-pagemenu-tooltip' ), invisibleLabel: true, include: [ { group: 'utility' } ], demote: [ 'changeDirectionality', 'findAndReplace' ] }, { name: 'editMode', align: 'after', type: 'list', icon: 'edit', title: ve.msg( 'visualeditor-mweditmode-tooltip' ), label: ve.msg( 'visualeditor-mweditmode-tooltip' ), invisibleLabel: true, include: [ { group: 'editMode' } ] }, { name: 'save', align: 'after', type: 'bar', include: [ { group: 'save' } ] } ); /** * Compatibility map used with jQuery.client to decide if a browser should * receive a compatibility warning. Blacklisting is handled in DesktopArticleTarget.init. * * @static * @property {Object} */ ve.init.mw.DesktopArticleTarget.static.compatibility = { // The key is the browser name returned by jQuery.client // The value is either null (match all versions) or a list of tuples // containing an inequality (<,>,<=,>=) and a version number supportedList: { chrome: [ [ '>=', 19 ] ], opera: [ [ '>=', 15 ] ], // All versions not in unsupportedList are fully supported: firefox: null, safari: null, msie: null, edge: null } }; ve.init.mw.DesktopArticleTarget.static.platformType = 'desktop'; /* Events */ /** * @event ve.init.mw.DesktopArticleTarget#deactivate */ /** * @event ve.init.mw.DesktopArticleTarget#transformPage */ /** * @event ve.init.mw.DesktopArticleTarget#restorePage */ /** * Fired when user clicks the button to open the save dialog. * * @event ve.init.mw.DesktopArticleTarget#saveWorkflowBegin */ /** * Fired when user exits the save workflow * * @event ve.init.mw.DesktopArticleTarget#saveWorkflowEnd */ /** * Fired when user initiates review changes in save workflow * * @event ve.init.mw.DesktopArticleTarget#saveReview */ /** * Fired when user initiates saving of the document * * @event ve.init.mw.DesktopArticleTarget#saveInitiated */ /* Methods */ /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.addSurface = function ( dmDoc, config ) { config = ve.extendObject( { $overlayContainer: $( document.querySelector( '[data-mw-ve-target-container]' ) || document.getElementById( 'content' ) ), // Vector-2022 content area has no padding itself, so popups render too close // to the edge of the text (T258501). Use a negative value to allow popups to // position slightly outside the content. Padding elsewhere means we are // guaranteed 30px of space between the content and the edge of the viewport. // Other skins pass 'undefined' to use the default padding of +10px. overlayPadding: mw.config.get( 'skin' ) === 'vector-2022' ? -10 : undefined }, config ); return ve.init.mw.DesktopArticleTarget.super.prototype.addSurface.call( this, dmDoc, config ); }; /** * Set the container for the target, appending the target to it * * @param {jQuery} $container */ ve.init.mw.DesktopArticleTarget.prototype.setContainer = function ( $container ) { $container.append( this.$element ); this.$container = $container; }; /** * Verify that a PopStateEvent correlates to a state we created. * * @param {any} popState From PopStateEvent#state * @return {boolean} */ ve.init.mw.DesktopArticleTarget.prototype.verifyPopState = function ( popState ) { return popState && popState.tag === 'visualeditor'; }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.setupToolbar = function ( surface ) { const mode = surface.getMode(), wasSetup = !!this.toolbar; ve.track( 'trace.setupToolbar.enter', { mode: mode } ); // Parent method ve.init.mw.DesktopArticleTarget.super.prototype.setupToolbar.call( this, surface ); const toolbar = this.getToolbar(); // Allow the toolbar to start floating now if necessary this.onContainerScroll(); ve.track( 'trace.setupToolbar.exit', { mode: mode } ); if ( !wasSetup ) { toolbar.$element .addClass( 've-init-mw-desktopArticleTarget-toolbar-open' ); if ( !toolbar.isFloating() ) { toolbar.$element.css( 'height', '' ); } this.toolbarSetupDeferred.resolve(); this.toolbarSetupDeferred.done( () => { const newSurface = this.getSurface(); // Check the surface wasn't torn down while the toolbar was animating if ( newSurface ) { ve.track( 'trace.initializeToolbar.enter', { mode: mode } ); this.getToolbar().initialize(); newSurface.getView().emit( 'position' ); newSurface.getContext().updateDimensions(); ve.track( 'trace.initializeToolbar.exit', { mode: mode } ); ve.track( 'trace.activate.exit', { mode: mode } ); } } ); } }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.attachToolbar = function () { // Set edit notices, will be shown after welcome dialog. // Make sure notices actually exists, because this might be a mode-switch and // we've already removed it. const editNotices = this.getEditNotices(), actionTools = this.toolbar.tools; if ( editNotices && editNotices.length && actionTools.notices ) { actionTools.notices.setNotices( editNotices ); } else if ( actionTools.notices ) { actionTools.notices.destroy(); actionTools.notices = null; } // Move the toolbar to top of target, before heading etc. // Avoid re-attaching as it breaks CSS animations if ( !this.toolbar.$element.parent().is( this.$element ) ) { this.toolbar.$element // Set 0 before attach (expanded in #setupToolbar) .css( 'height', '0' ) .addClass( 've-init-mw-desktopArticleTarget-toolbar' ); this.$element.prepend( this.toolbar.$element ); // Calculate if the 'oo-ui-toolbar-narrow' class is needed (OOUI does it too late for our // toolbar because the methods are called in the wrong order, see T92282). this.toolbar.onWindowResize(); } }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.setupToolbarSaveButton = function () { this.toolbarSaveButton = this.toolbar.getToolGroupByName( 'save' ).items[ 0 ]; }; /** * Set up notices for things like unknown browsers. * Needs to be done on each activation because localNoticeMessages is cleared in clearState. */ ve.init.mw.DesktopArticleTarget.prototype.setupLocalNoticeMessages = function () { if ( !( this.currentUrl.searchParams.has( 'vesupported' ) || $.client.test( this.constructor.static.compatibility.supportedList, null, true ) ) ) { // Show warning in unknown browsers that pass the support test // Continue at own risk. this.localNoticeMessages.push( 'visualeditor-browserwarning' ); } }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.updateTabs = function () { mw.libs.ve.updateTabs( true, this.getDefaultMode(), this.section === 'new' ); }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.loadSuccess = function () { // Parent method ve.init.mw.DesktopArticleTarget.super.prototype.loadSuccess.apply( this, arguments ); this.wikitextFallbackLoading = false; // Duplicate of this code in ve.init.mw.DesktopArticleTarget.init.js // eslint-disable-next-line no-jquery/no-class-state if ( $( '#ca-edit' ).hasClass( 'visualeditor-showtabdialog' ) ) { $( '#ca-edit' ).removeClass( 'visualeditor-showtabdialog' ); // Set up a temporary window manager const windowManager = new OO.ui.WindowManager(); $( OO.ui.getTeleportTarget() ).append( windowManager.$element ); this.editingTabDialog = new mw.libs.ve.EditingTabDialog(); windowManager.addWindows( [ this.editingTabDialog ] ); windowManager.openWindow( this.editingTabDialog ) .closed.then( ( data ) => { // Detach the temporary window manager windowManager.destroy(); if ( data && data.action === 'prefer-wt' ) { this.switchToWikitextEditor( false ); } else if ( data && data.action === 'multi-tab' ) { location.reload(); } } ); // Pretend the user saw the welcome dialog before suppressing it. mw.libs.ve.stopShowingWelcomeDialog(); this.suppressNormalStartupDialogs = true; } }; /** * Handle the watch button being toggled on/off. * * @param {boolean} isWatched * @param {string} expiry * @param {string} expirySelected */ ve.init.mw.DesktopArticleTarget.prototype.onWatchToggle = function ( isWatched ) { if ( !this.active && !this.activating ) { return; } if ( this.checkboxesByName && this.checkboxesByName.wpWatchthis ) { this.checkboxesByName.wpWatchthis.setSelected( !!mw.user.options.get( 'watchdefault' ) || ( !!mw.user.options.get( 'watchcreations' ) && !this.pageExists ) || isWatched ); } }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.bindHandlers = function () { ve.init.mw.DesktopArticleTarget.super.prototype.bindHandlers.call( this ); if ( this.onWatchToggleHandler ) { mw.hook( 'wikipage.watchlistChange' ).add( this.onWatchToggleHandler ); } }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.unbindHandlers = function () { ve.init.mw.DesktopArticleTarget.super.prototype.unbindHandlers.call( this ); if ( this.onWatchToggleHandler ) { mw.hook( 'wikipage.watchlistChange' ).remove( this.onWatchToggleHandler ); } }; /** * Switch to edit mode. * * @param {jQuery.Promise} [dataPromise] Promise for pending request from * mw.libs.ve.targetLoader#requestPageData, if any * @return {jQuery.Promise} */ ve.init.mw.DesktopArticleTarget.prototype.activate = function ( dataPromise ) { // We may be re-activating an old target, during which time ve.init.target // has been overridden. ve.init.target = ve.init.articleTarget; if ( !this.active && !this.activating ) { this.activating = true; this.activatingDeferred = ve.createDeferred(); this.toolbarSetupDeferred = ve.createDeferred(); $( 'html' ).addClass( 've-activating' ); ve.promiseAll( [ this.activatingDeferred, this.toolbarSetupDeferred ] ).done( () => { if ( !this.suppressNormalStartupDialogs ) { this.maybeShowWelcomeDialog(); this.maybeShowMetaDialog(); } this.afterActivate(); } ).fail( () => { $( 'html' ).removeClass( 've-activating' ); } ); // Handlers were unbound in constructor. Will be unbound again in teardown. this.bindHandlers(); this.originalEditondbclick = mw.user.options.get( 'editondblclick' ); mw.user.options.set( 'editondblclick', 0 ); // User interface changes this.changeDocumentTitle(); this.transformPage(); this.setupLocalNoticeMessages(); this.load( dataPromise ); } return this.activatingDeferred.promise(); }; /** * Edit mode has finished activating */ ve.init.mw.DesktopArticleTarget.prototype.afterActivate = function () { $( 'html' ).removeClass( 've-activating' ).addClass( 've-active' ); // Disable TemplateStyles in the original content // (We do this here because toggling 've-active' class above hides it) this.$editableContent.find( 'style[data-mw-deduplicate^="TemplateStyles:"]' ).prop( 'disabled', true ); this.afterSurfaceReady(); if ( !this.editingTabDialog ) { if ( this.sectionTitle ) { this.sectionTitle.focus(); } else { // We have to focus the page after hiding the original content, otherwise // in firefox the contentEditable container was below the view page, and // 'focus' scrolled the screen down. // Support: Firefox this.getSurface().getView().focus(); } // Transfer and initial source range to the surface (e.g. from tempWikitextEditor) if ( this.initialSourceRange && this.getSurface().getMode() === 'source' ) { const surfaceModel = this.getSurface().getModel(); const range = surfaceModel.getRangeFromSourceOffsets( this.initialSourceRange.from, this.initialSourceRange.to ); surfaceModel.setLinearSelection( range ); } } }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.setSurface = function ( surface ) { const resetSurface = surface !== this.surface; if ( resetSurface ) { this.$editableContent.after( surface.$element ); } // Parent method ve.init.mw.DesktopArticleTarget.super.prototype.setSurface.apply( this, arguments ); if ( resetSurface ) { this.setupNewSection( surface ); } }; /** * Setup new section input for a surface, if required * * @param {ve.ui.Surface} surface */ ve.init.mw.DesktopArticleTarget.prototype.setupNewSection = function ( surface ) { if ( surface.getMode() === 'source' && this.section === 'new' ) { if ( !this.sectionTitle ) { this.sectionTitle = new OO.ui.TextInputWidget( { $element: $( '

' ), classes: [ 've-init-mw-desktopArticleTarget-sectionTitle' ], placeholder: ve.msg( 'visualeditor-section-title-placeholder' ), spellcheck: true } ); if ( this.recovered ) { this.sectionTitle.setValue( ve.init.platform.sessionStorage.get( 've-docsectiontitle' ) || '' ); } this.sectionTitle.connect( this, { change: 'onSectionTitleChange' } ); } surface.setPlaceholder( ve.msg( 'visualeditor-section-body-placeholder' ) ); this.$editableContent.before( this.sectionTitle.$element ); if ( this.currentUrl.searchParams.has( 'preloadtitle' ) ) { this.sectionTitle.setValue( this.currentUrl.searchParams.get( 'preloadtitle' ) ); } surface.once( 'destroy', this.teardownNewSection.bind( this, surface ) ); } else { ve.init.platform.sessionStorage.remove( 've-docsectiontitle' ); } }; /** * Handle section title changes */ ve.init.mw.DesktopArticleTarget.prototype.onSectionTitleChange = function () { ve.init.platform.sessionStorage.set( 've-docsectiontitle', this.sectionTitle.getValue() ); this.updateToolbarSaveButtonState(); }; /** * Teardown new section inputs * * @param {ve.ui.Surface} surface */ ve.init.mw.DesktopArticleTarget.prototype.teardownNewSection = function ( surface ) { surface.setPlaceholder( '' ); if ( this.sectionTitle ) { this.sectionTitle.$element.remove(); this.sectionTitle = null; } }; /** * @inheritdoc * * A prompt will not be shown if tryTeardown() is called while activation is still in progress. * If tryTeardown() is called while the target is deactivating, or while it's not active and * not activating, nothing happens. */ ve.init.mw.DesktopArticleTarget.prototype.tryTeardown = function ( noPrompt, trackMechanism ) { if ( this.deactivating || ( !this.active && !this.activating ) ) { return this.teardownPromise || ve.createDeferred().resolve().promise(); } // Just in case these weren't closed before if ( this.welcomeDialog ) { this.welcomeDialog.close(); } if ( this.editingTabDialog ) { this.editingTabDialog.close(); } this.editingTabDialog = null; // Parent method return ve.init.mw.DesktopArticleTarget.super.prototype.tryTeardown.call( this, noPrompt || this.activating, trackMechanism ); }; /** * @inheritdoc * * @param {string} [trackMechanism] * @fires ve.init.mw.DesktopArticleTarget#deactivate */ ve.init.mw.DesktopArticleTarget.prototype.teardown = function ( trackMechanism ) { // Event tracking let abortType, abortedMode; if ( trackMechanism ) { if ( this.activating ) { abortType = 'preinit'; } else if ( !this.edited ) { abortType = 'nochange'; } else if ( this.saving ) { abortType = 'abandonMidsave'; } else { // switchwith and switchwithout do not go through this code path, // they go through switchToWikitextEditor() instead abortType = 'abandon'; } abortedMode = this.surface ? this.surface.getMode() : this.getDefaultMode(); } // Cancel activating, start deactivating this.deactivating = true; this.deactivatingDeferred = ve.createDeferred(); this.activating = false; this.activatingDeferred.reject(); $( 'html' ).addClass( 've-deactivating' ).removeClass( 've-activated ve-active' ); this.emit( 'deactivate' ); // Restore TemplateStyles of the original content // (We do this here because toggling 've-active' class above displays it) this.$editableContent.find( 'style[data-mw-deduplicate^="TemplateStyles:"]' ).prop( 'disabled', false ); // User interface changes this.restorePage(); this.restoreDocumentTitle(); mw.user.options.set( 'editondblclick', this.originalEditondbclick ); this.originalEditondbclick = undefined; // TODO: Use better checks to see if these restorations are required. if ( this.getSurface() ) { if ( this.active ) { this.teardownUnloadHandlers(); } } // Parent method return ve.init.mw.DesktopArticleTarget.super.prototype.teardown.call( this ).then( () => { // After teardown this.active = false; // If there is a load in progress, try to abort it if ( this.loading && this.loading.abort ) { this.loading.abort(); } this.clearState(); this.initialEditSummary = new URL( location.href ).searchParams.get( 'summary' ); this.editSummaryValue = null; // Move original content back out of the target this.$element.parent().append( this.$originalContent.children() ); $( '.ve-init-mw-desktopArticleTarget-uneditableContent' ) .removeClass( 've-init-mw-desktopArticleTarget-uneditableContent' ); this.deactivating = false; this.deactivatingDeferred.resolve(); $( 'html' ).removeClass( 've-deactivating' ); // Event tracking if ( trackMechanism ) { ve.track( 'editAttemptStep', { action: 'abort', type: abortType, mechanism: trackMechanism, mode: abortedMode } ); } if ( !this.isViewPage ) { const newUrl = new URL( this.viewUrl ); if ( mw.config.get( 'wgIsRedirect' ) ) { newUrl.searchParams.set( 'redirect', 'no' ); } location.href = newUrl; } } ); }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.loadFail = function ( code, errorDetails ) { // Parent method ve.init.mw.DesktopArticleTarget.super.prototype.loadFail.apply( this, arguments ); if ( this.wikitextFallbackLoading ) { // Failed twice now mw.log.warn( 'Failed to fall back to wikitext', code, errorDetails ); const newUrl = new URL( this.viewUrl ); newUrl.searchParams.set( 'action', 'edit' ); newUrl.searchParams.set( 'veswitched', '1' ); location.href = newUrl; return; } if ( !this.activating ) { // Load failed after activation abandoned (e.g. user pressed escape). // Nothing more to do. return; } const $confirmPromptMessage = this.extractErrorMessages( errorDetails ); OO.ui.confirm( $confirmPromptMessage, { actions: [ { action: 'accept', label: OO.ui.msg( 'ooui-dialog-process-retry' ), flags: 'primary' }, { action: 'reject', label: OO.ui.msg( 'ooui-dialog-message-reject' ), flags: 'safe' } ] } ).done( ( confirmed ) => { if ( confirmed ) { // Retry load this.load(); } else { // User pressed "cancel" if ( this.getSurface() ) { // Restore the mode of the current surface this.setDefaultMode( this.getSurface().getMode() ); this.activatingDeferred.reject(); } else { // We're switching from read mode or the 2010 wikitext editor: // just give up and stay where you are this.tryTeardown( true ); } } } ); }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.surfaceReady = function () { if ( !this.activating ) { // Activation was aborted before we got here. Do nothing // TODO are there things we need to clean up? return; } const surface = this.getSurface(); this.activating = false; // TODO: mwTocWidget should probably live in a ve.ui.MWSurface subclass if ( mw.config.get( 'wgVisualEditorConfig' ).enableTocWidget ) { surface.mwTocWidget = new ve.ui.MWTocWidget( this.getSurface() ); surface.once( 'destroy', () => { surface.mwTocWidget.$element.remove(); } ); } const metaList = this.getSurface().getModel().getDocument().getMetaList(); metaList.connect( this, { insert: 'onMetaItemInserted', remove: 'onMetaItemRemoved' } ); // Rebuild the category list from the page we got from the API. This makes // it work regardless of whether we came here from activating on an // existing page, or loading via an edit URL. this.rebuildCategories( metaList.getItemsInGroup( 'mwCategory' ), true ); // Parent method ve.init.mw.DesktopArticleTarget.super.prototype.surfaceReady.apply( this, arguments ); const redirectMetaItems = metaList.getItemsInGroup( 'mwRedirect' ); if ( redirectMetaItems.length ) { this.setFakeRedirectInterface( redirectMetaItems[ 0 ].getAttribute( 'title' ) ); } else { this.setFakeRedirectInterface( null ); } this.setupUnloadHandlers(); this.activatingDeferred.resolve(); this.events.trackActivationComplete(); }; /** * Update the redirect and category interfaces when a meta item is inserted into the page. * * @param {ve.dm.MetaItem} metaItem Item that was inserted */ ve.init.mw.DesktopArticleTarget.prototype.onMetaItemInserted = function ( metaItem ) { switch ( metaItem.getType() ) { case 'mwRedirect': this.setFakeRedirectInterface( metaItem.getAttribute( 'title' ) ); break; case 'mwCategory': { const metaList = this.getSurface().getModel().getDocument().getMetaList(); this.rebuildCategories( metaList.getItemsInGroup( 'mwCategory' ) ); break; } } }; /** * Update the redirect and category interfaces when a meta item is removed from the page. * * @param {ve.dm.MetaItem} metaItem Item that was removed * @param {number} offset Linear model offset that the item was at * @param {number} index Index within that offset the item was at */ ve.init.mw.DesktopArticleTarget.prototype.onMetaItemRemoved = function ( metaItem ) { switch ( metaItem.getType() ) { case 'mwRedirect': this.setFakeRedirectInterface( null ); break; case 'mwCategory': { const metaList = this.getSurface().getModel().getDocument().getMetaList(); this.rebuildCategories( metaList.getItemsInGroup( 'mwCategory' ) ); break; } } }; /** * Redisplay the category list on the page * * This is used for the preview while editing. Leaving the editor either restores the initial * categories, or uses the ones generated by the save API. * * @param {ve.dm.MetaItem[]} categoryItems Array of category metaitems to display */ ve.init.mw.DesktopArticleTarget.prototype.rebuildCategories = function ( categoryItems ) { this.renderCategories( categoryItems ).done( ( $categories ) => { // Clone the existing catlinks for any specific properties which might // be needed by the rest of the page. Also gives us a not-attached // version, which we can pass to wikipage.categories as it requests. const $catlinks = $( '#catlinks' ).clone().empty().removeClass( 'categories-allhidden' ) .append( $categories.children() ); // If all categories are hidden, we need to hide the box. $catlinks.toggleClass( 'catlinks-allhidden', $catlinks.find( '.mw-normal-catlinks' ).length === 0 && // Some situations make the hidden-categories visible (a user // preference, and being on a category page) so rather than // encoding that logic here just check whether they're visible: // eslint-disable-next-line no-jquery/no-sizzle $catlinks.find( '.mw-hidden-catlinks:visible' ).length === 0 ); this.transformCategoryLinks( $catlinks ); mw.hook( 'wikipage.categories' ).fire( $catlinks ); $( '#catlinks' ).replaceWith( $catlinks ); } ); }; /** * Handle clicks on the view tab. * * @param {jQuery.Event} e Mouse click event */ ve.init.mw.DesktopArticleTarget.prototype.onViewTabClick = function ( e ) { if ( ( !this.active && !this.activating ) || !ve.isUnmodifiedLeftClick( e ) ) { return; } this.tryTeardown( false, 'navigate-read' ); e.preventDefault(); }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.saveComplete = function ( data ) { // Parent method ve.init.mw.DesktopArticleTarget.super.prototype.saveComplete.apply( this, arguments ); // If there is no content, then parent method will reload the whole page if ( !data.nocontent ) { // Fix permalinks if ( data.newrevid !== undefined ) { $( '#t-permalink' ).add( '#coll-download-as-rl' ).find( 'a' ).each( ( i, el ) => { const permalinkUrl = new URL( el.href ); permalinkUrl.searchParams.set( 'oldid', data.newrevid ); $( el ).attr( 'href', permalinkUrl.toString() ); } ); } // Actually fire the postEdit hook now that the save is complete if ( data.newrevid !== undefined ) { require( 'mediawiki.action.view.postEdit' ).fireHook( 'saved' ); } } }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.serialize = function () { // Parent method const promise = ve.init.mw.DesktopArticleTarget.super.prototype.serialize.apply( this, arguments ); return promise.fail( ( error, response ) => { const $errorMessages = this.extractErrorMessages( response ); OO.ui.alert( $errorMessages ); // It's possible to get here while the save dialog has never been opened (if the user uses // the switch to source mode option) if ( this.saveDialog ) { this.saveDialog.popPending(); } } ); }; /** * Handle clicks on the MwMeta button in the toolbar. * * @param {jQuery.Event} e Mouse click event */ ve.init.mw.DesktopArticleTarget.prototype.onToolbarMetaButtonClick = function () { this.getSurface().getDialogs().openWindow( 'meta' ); }; /** * Modify tabs in the skin to support in-place editing. * * 'Read' and 'Edit source' (when not using single edit tab) bound here, * 'Edit' and single edit tab are bound in mw.DesktopArticleTarget.init. */ ve.init.mw.DesktopArticleTarget.prototype.setupSkinTabs = function () { if ( this.isViewPage ) { const namespaceNumber = mw.config.get( 'wgNamespaceNumber' ); const namespaceName = mw.config.get( 'wgCanonicalNamespace' ); const isTalkNamespace = mw.Title.isTalkNamespace( namespaceNumber ); // Title::getNamespaceKey() let namespaceKey = namespaceName.toLowerCase() || 'main'; if ( namespaceKey === 'file' ) { namespaceKey = 'image'; } let namespaceTabId; // SkinTemplate::buildContentNavigationUrls() if ( isTalkNamespace ) { namespaceTabId = 'ca-talk'; } else { namespaceTabId = 'ca-nstab-' + namespaceKey; } // Allow instant switching back to view mode, without refresh $( '#ca-view' ).add( '#' + namespaceTabId ).find( 'a' ) .on( 'click.ve-target', this.onViewTabClick.bind( this ) ); } // Used by Extension:GuidedTour mw.hook( 've.skinTabSetupComplete' ).fire(); }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.getSaveDialogOpeningData = function () { const data = ve.init.mw.DesktopArticleTarget.super.prototype.getSaveDialogOpeningData.apply( this, arguments ); data.editSummary = this.editSummaryValue || this.initialEditSummary; return data; }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.teardownToolbar = function () { const deferred = ve.createDeferred(); if ( !this.toolbar ) { return deferred.resolve().promise(); } this.toolbar.$element .addClass( 've-init-mw-desktopArticleTarget-toolbar-preclose' ) .css( 'height', this.toolbar.$bar[ 0 ].offsetHeight ); setTimeout( () => { this.toolbar.$element .css( 'height', '0' ) .addClass( 've-init-mw-desktopArticleTarget-toolbar-close' ); setTimeout( () => { // Parent method ve.init.mw.DesktopArticleTarget.super.prototype.teardownToolbar.call( this ); deferred.resolve(); }, 250 ); } ); return deferred.promise(); }; /** * Change the document title to state that we are now editing. */ ve.init.mw.DesktopArticleTarget.prototype.changeDocumentTitle = function () { const title = mw.Title.newFromText( this.getPageName() ); const pageTitleMsg = mw.message( 'pagetitle', ve.msg( this.pageExists ? 'editing' : 'creating', title.getPrefixedText() ) ); // T317600 if ( pageTitleMsg.isParseable() ) { // Use the real title if we loaded a view page, otherwise reconstruct it this.originalDocumentTitle = this.isViewPage ? document.title : ve.msg( 'pagetitle', title.getPrefixedText() ); // Reconstruct an edit title document.title = pageTitleMsg.text(); } else { mw.log.warn( 'VisualEditor: MediaWiki:Pagetitle contains unsupported syntax. ' + 'https://www.mediawiki.org/wiki/Manual:Messages_API#Feature_support_in_JavaScript' ); } }; /** * Restore the original document title. */ ve.init.mw.DesktopArticleTarget.prototype.restoreDocumentTitle = function () { if ( this.originalDocumentTitle ) { document.title = this.originalDocumentTitle; } }; /** * Page modifications for switching to edit mode. * * @fires ve.init.mw.DesktopArticleTarget#transformPage */ ve.init.mw.DesktopArticleTarget.prototype.transformPage = function () { this.updateTabs(); this.emit( 'transformPage' ); // TODO: Deprecate in favour of ve.activationComplete // Only used by one gadget mw.hook( 've.activate' ).fire(); // Move all native content inside the target // Exclude notification area to work around T143837 this.$originalContent.append( this.$element.siblings() .not( '.mw-notification-area' ) .not( '.ve-init-mw-desktopArticleTarget-toolbarPlaceholder' ) ); // To preserve event handlers (e.g. HotCat) if editing is cancelled, detach the original container // and replace it with a clone during editing this.$originalCategories = $( '#catlinks' ); this.$originalCategories.after( this.$originalCategories.clone() ); this.$originalCategories.detach(); // Mark every non-direct ancestor between editableContent and the container as uneditable let $content = this.$editableContent; while ( $content && $content.length && !$content.parent().is( this.$container ) ) { $content.prevAll( ':not( .ve-init-mw-tempWikitextEditorWidget )' ).addClass( 've-init-mw-desktopArticleTarget-uneditableContent' ); $content.nextAll( ':not( .ve-init-mw-tempWikitextEditorWidget )' ).addClass( 've-init-mw-desktopArticleTarget-uneditableContent' ); $content = $content.parent(); } this.restoreEditTabsIfNeeded( $content ); this.updateHistoryState(); }; /** * Checks the edit/view tabs have not been marked as disabled. The view tab provides a way * to exit the VisualEditor so its important it is not marked as uneditable. * * @param {jQuery} $content area */ ve.init.mw.DesktopArticleTarget.prototype.restoreEditTabsIfNeeded = function ( $content ) { const $viewTab = $content.find( '.ve-init-mw-desktopArticleTarget-uneditableContent #ca-view' ); if ( $viewTab.length ) { $viewTab.parents( '.ve-init-mw-desktopArticleTarget-uneditableContent' ).removeClass( 've-init-mw-desktopArticleTarget-uneditableContent' ); } }; /** * Category link section transformations for switching to edit mode. Broken out * so it can be re-applied when displaying changes to the categories. * * @param {jQuery} $catlinks Category links container element */ ve.init.mw.DesktopArticleTarget.prototype.transformCategoryLinks = function ( $catlinks ) { // Un-disable the catlinks wrapper, but not the links if ( this.getSurface() && this.getSurface().getMode() === 'visual' ) { $catlinks.removeClass( 've-init-mw-desktopArticleTarget-uneditableContent' ) .on( 'click.ve-target', () => { const windowAction = ve.ui.actionFactory.create( 'window', this.getSurface() ); windowAction.open( 'meta', { page: 'categories' } ); return false; } ) .find( 'a' ).addClass( 've-init-mw-desktopArticleTarget-uneditableContent' ); } else { $catlinks.addClass( 've-init-mw-desktopArticleTarget-uneditableContent' ).off( 'click.ve-target' ); } }; /** * Update the history state based on the editor mode */ ve.init.mw.DesktopArticleTarget.prototype.updateHistoryState = function () { const veaction = this.getDefaultMode() === 'visual' ? 'edit' : 'editsource', section = this.section; // Push veaction=edit(source) url in history (if not already present). // If we got here from DesktopArticleTarget.init, then it will be already present. if ( !this.actFromPopState && ( this.currentUrl.searchParams.get( 'veaction' ) !== veaction || this.currentUrl.searchParams.get( 'section' ) !== section ) && this.currentUrl.searchParams.get( 'action' ) !== 'edit' ) { // Set the current URL const url = this.currentUrl; if ( mw.libs.ve.isSingleEditTab ) { url.searchParams.set( 'action', 'edit' ); mw.config.set( 'wgAction', 'edit' ); } else { url.searchParams.set( 'veaction', veaction ); url.searchParams.delete( 'action' ); mw.config.set( 'wgAction', 'view' ); } if ( this.section !== null ) { url.searchParams.set( 'section', this.section ); } else { url.searchParams.delete( 'section' ); } history.pushState( this.popState, '', url ); } this.actFromPopState = false; }; /** * Page modifications for switching back to view mode. * * @fires ve.init.mw.DesktopArticleTarget#restorePage */ ve.init.mw.DesktopArticleTarget.prototype.restorePage = function () { // Restore any previous redirectMsg/redirectsub this.setRealRedirectInterface(); if ( this.$originalCategories ) { $( '#catlinks' ).replaceWith( this.$originalCategories ); } // TODO: Deprecate in favour of ve.deactivationComplete mw.hook( 've.deactivate' ).fire(); this.emit( 'restorePage' ); // Push article url into history if ( !this.actFromPopState ) { // Remove the VisualEditor query parameters const url = this.currentUrl; if ( url.searchParams.has( 'veaction' ) ) { url.searchParams.delete( 'veaction' ); } if ( this.section !== null ) { // Translate into a hash for the new URL: // This should be after replacePageContent if this is post-save, so we can just look // at the headers on the page. const hash = this.getSectionHashFromPage(); if ( hash ) { url.hash = hash; this.viewUrl.hash = hash; const target = document.getElementById( hash.slice( 1 ) ); if ( target ) { // Scroll the page to the edited section setTimeout( () => { target.scrollIntoView( true ); } ); } } url.searchParams.delete( 'section' ); } if ( url.searchParams.has( 'action' ) && $( '#wpTextbox1:not(.ve-dummyTextbox)' ).length === 0 ) { // If we're not overlaid on an edit page, remove action=edit url.searchParams.delete( 'action' ); mw.config.set( 'wgAction', 'view' ); } if ( url.searchParams.has( 'oldid' ) && !this.restoring ) { // We have an oldid in the query string but it's the most recent one, so remove it url.searchParams.delete( 'oldid' ); } // Remove parameters which are only intended for the editor, not for read mode url.searchParams.delete( 'editintro' ); url.searchParams.delete( 'preload' ); url.searchParams.delete( 'preloadparams[]' ); url.searchParams.delete( 'preloadtitle' ); url.searchParams.delete( 'summary' ); // If there are any other query parameters left, re-use that URL object. // Otherwise use the canonical style view URL (T44553, T102363). const keys = []; url.searchParams.forEach( ( val, key ) => { keys.push( key ); } ); if ( !keys.length || ( keys.length === 1 && keys[ 0 ] === 'title' ) ) { history.pushState( this.popState, '', this.viewUrl ); } else { history.pushState( this.popState, '', url ); } } }; /** * @param {Event} e Native event object */ ve.init.mw.DesktopArticleTarget.prototype.onWindowPopState = function ( e ) { if ( !this.verifyPopState( e.state ) ) { // Ignore popstate events fired for states not created by us // This also filters out the initial fire in Chrome (T59901). return; } const oldUrl = this.currentUrl; this.currentUrl = new URL( location.href ); let veaction = this.currentUrl.searchParams.get( 'veaction' ); const action = this.currentUrl.searchParams.get( 'action' ); if ( !veaction && action === 'edit' ) { veaction = this.getDefaultMode() === 'source' ? 'editsource' : 'edit'; } if ( this.isModeAvailable( 'source' ) && this.active ) { if ( veaction === 'editsource' && this.getDefaultMode() === 'visual' ) { this.actFromPopState = true; this.switchToWikitextEditor(); } else if ( veaction === 'edit' && this.getDefaultMode() === 'source' ) { this.actFromPopState = true; this.switchToVisualEditor(); } } if ( !this.active && ( veaction === 'edit' || veaction === 'editsource' ) ) { this.actFromPopState = true; this.emit( 'reactivate' ); } if ( this.active && veaction !== 'edit' && veaction !== 'editsource' ) { this.actFromPopState = true; // "Undo" the pop-state, as the event is not cancellable history.pushState( this.popState, '', oldUrl ); this.currentUrl = oldUrl; this.tryTeardown( false, 'navigate-back' ).then( () => { // Teardown was successful, re-apply the undone state history.back(); } ).always( () => { this.actFromPopState = false; } ); } }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.replacePageContent = function ( html, categoriesHtml, displayTitle, lastModified /* , contentSub, sections */ ) { // Parent method ve.init.mw.DesktopArticleTarget.super.prototype.replacePageContent.apply( this, arguments ); if ( lastModified ) { // If we were not viewing the most recent revision before (a requirement // for lastmod to have been added by MediaWiki), we will be now. if ( !$( '#footer-info-lastmod' ).length ) { $( '#footer-info' ).prepend( $( '
  • ' ).attr( 'id', 'footer-info-lastmod' ) ); } // Intentionally treated as HTML // eslint-disable-next-line no-jquery/no-html $( '#footer-info-lastmod' ).html( ' ' + mw.msg( 'lastmodifiedat', lastModified.date, lastModified.time ) ); } this.$originalCategories = null; // Re-set any edit section handlers now that the page content has been replaced mw.libs.ve.setupEditLinks(); }; /** * Add onunload and onbeforeunload handlers. */ ve.init.mw.DesktopArticleTarget.prototype.setupUnloadHandlers = function () { if ( window.onbeforeunload !== this.onBeforeUnload ) { // Remember any already set beforeunload handler this.onBeforeUnloadFallback = window.onbeforeunload; // Attach our handlers window.onbeforeunload = this.onBeforeUnload; window.addEventListener( 'unload', this.onUnloadHandler ); } }; /** * Remove onunload and onbeforunload handlers. */ ve.init.mw.DesktopArticleTarget.prototype.teardownUnloadHandlers = function () { // Restore whatever previous onbeforeunload hook existed window.onbeforeunload = this.onBeforeUnloadFallback; this.onBeforeUnloadFallback = null; window.removeEventListener( 'unload', this.onUnloadHandler ); }; /** * Show the beta dialog as needed */ ve.init.mw.DesktopArticleTarget.prototype.maybeShowWelcomeDialog = function () { const editorMode = this.getDefaultMode(), windowManager = this.getSurface().dialogs; this.welcomeDialogPromise = ve.createDeferred(); if ( mw.libs.ve.shouldShowWelcomeDialog() ) { this.welcomeDialog = new mw.libs.ve.WelcomeDialog(); windowManager.addWindows( [ this.welcomeDialog ] ); windowManager.openWindow( this.welcomeDialog, { switchable: editorMode === 'source' ? this.isModeAvailable( 'visual' ) : true, editor: editorMode } ) .closed.then( ( data ) => { this.welcomeDialogPromise.resolve(); this.welcomeDialog = null; if ( data && data.action === 'switch-wte' ) { this.switchToWikitextEditor( false ); } else if ( data && data.action === 'switch-ve' ) { this.switchToVisualEditor(); } } ); mw.libs.ve.stopShowingWelcomeDialog(); } else { this.welcomeDialogPromise.reject(); } }; /** * Show the meta dialog as needed on load. */ ve.init.mw.DesktopArticleTarget.prototype.maybeShowMetaDialog = function () { if ( this.welcomeDialogPromise ) { // Pop out the notices when the welcome dialog is closed this.welcomeDialogPromise .always( () => { if ( this.switched && !mw.user.options.get( 'visualeditor-hidevisualswitchpopup' ) ) { // Show "switched" popup const popup = new mw.libs.ve.SwitchPopupWidget( 'visual' ); this.toolbar.tools.editModeSource.toolGroup.$element.append( popup.$element ); popup.toggle( true ); } else if ( this.toolbar.tools.notices ) { // Show notices this.toolbar.tools.notices.getPopup().toggle( true ); } } ); } const redirectMetaItems = this.getSurface().getModel().getDocument().getMetaList().getItemsInGroup( 'mwRedirect' ); if ( redirectMetaItems.length ) { const windowAction = ve.ui.actionFactory.create( 'window', this.getSurface() ); windowAction.open( 'meta', { page: 'settings' } ); } }; /** * Handle before unload event. * * @return {string|undefined} Message */ ve.init.mw.DesktopArticleTarget.prototype.onBeforeUnload = function () { // Check if someone already set on onbeforeunload hook if ( this.onBeforeUnloadFallback ) { // Get the result of their onbeforeunload hook const fallbackResult = this.onBeforeUnloadFallback(); // If it returned something, exit here and return their message if ( fallbackResult !== undefined ) { return fallbackResult; } } // Check if there's been an edit if ( this.getSurface() && $.contains( document, this.getSurface().$element.get( 0 ) ) && this.edited && !this.submitting && mw.user.options.get( 'useeditwarning' ) ) { // Return our message return ve.msg( 'mw-widgets-abandonedit' ); } }; /** * Handle unload event. */ ve.init.mw.DesktopArticleTarget.prototype.onUnload = function () { if ( !this.submitting ) { ve.track( 'editAttemptStep', { action: 'abort', type: this.edited ? 'unknown-edited' : 'unknown', mechanism: 'navigate', mode: this.surface ? this.surface.getMode() : this.getDefaultMode() } ); } }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.switchToVisualEditor = function () { // Parent method ve.init.mw.DesktopArticleTarget.super.prototype.switchToVisualEditor.apply( this, arguments ); if ( this.isModeAvailable( 'visual' ) ) { ve.track( 'activity.editor-switch', { action: 'visual-desktop' } ); } }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.switchToWikitextEditor = function () { // Parent method ve.init.mw.DesktopArticleTarget.super.prototype.switchToWikitextEditor.apply( this, arguments ); if ( this.isModeAvailable( 'source' ) ) { ve.track( 'activity.editor-switch', { action: 'source-nwe-desktop' } ); } }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.switchToWikitextSection = function () { // Parent method ve.init.mw.DesktopArticleTarget.super.prototype.switchToWikitextSection.apply( this, arguments ); ve.track( 'activity.editor-switch', { action: 'source-nwe-desktop' } ); }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.switchToFallbackWikitextEditor = function ( modified ) { const oldId = mw.config.get( 'wgRevisionId' ) || $( 'input[name=parentRevId]' ).val(); const prefPromise = mw.libs.ve.setEditorPreference( 'wikitext' ); if ( !modified ) { ve.track( 'activity.editor-switch', { action: 'source-desktop' } ); ve.track( 'editAttemptStep', { action: 'abort', type: 'switchnochange', mechanism: 'navigate', mode: 'visual' } ); this.submitting = true; return prefPromise.then( () => { const url = new URL( this.viewUrl ); url.searchParams.set( 'action', 'edit' ); // No changes, safe to stay in section mode if ( this.section !== null ) { url.searchParams.set( 'section', this.section ); } else { url.searchParams.delete( 'section' ); } url.searchParams.set( 'veswitched', '1' ); if ( oldId && oldId !== mw.config.get( 'wgCurRevisionId' ) ) { url.searchParams.set( 'oldid', oldId ); } if ( mw.libs.ve.isWelcomeDialogSuppressed() ) { url.searchParams.set( 'vehidebetadialog', '1' ); } location.href = url.toString(); } ); } else { return this.serialize( this.getDocToSave() ).then( ( data ) => { ve.track( 'activity.editor-switch', { action: 'source-desktop' } ); ve.track( 'editAttemptStep', { action: 'abort', type: 'switchwith', mechanism: 'navigate', mode: 'visual' } ); this.submitWithSaveFields( { wpDiff: true, wpAutoSummary: '' }, data.content ); } ); } }; /** * @inheritdoc */ ve.init.mw.DesktopArticleTarget.prototype.reloadSurface = function () { this.activating = true; this.activatingDeferred = ve.createDeferred(); // Parent method ve.init.mw.DesktopArticleTarget.super.prototype.reloadSurface.apply( this, arguments ); this.activatingDeferred.done( () => { this.updateHistoryState(); this.afterActivate(); this.setupTriggerListeners(); } ); this.toolbarSetupDeferred.resolve(); }; /* Registration */ ve.init.mw.targetFactory.register( ve.init.mw.DesktopArticleTarget );