2013-04-29 21:01:56 +00:00
|
|
|
/*!
|
|
|
|
* VisualEditor user interface MWMetaDialog class.
|
|
|
|
*
|
2023-12-01 16:06:11 +00:00
|
|
|
* @copyright See AUTHORS.txt
|
2013-04-29 21:01:56 +00:00
|
|
|
* @license The MIT License (MIT); see LICENSE.txt
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
2014-07-14 21:32:49 +00:00
|
|
|
* Dialog for editing MediaWiki page information.
|
Single-click insertion
Objectives:
* Reduce the number of clicks and mouse maneuvers required to insert
media, references or template parameters
* Make use of highlighting with mouse movement or arrow key presses,
similar to menus, to suggest action when clicked
* Improve the way media search results look and feel
Changes:
ve.ui.SelectWidget.js
* Add mouseleave handler to un-highlight when the mouse exits the widget
* Document highlight events (already being emitted)
ve.ui.SearchWidget.js
* Propagate both select and highlight events from results widget
* Make arrow keys change highlight instead of selection
* Get rid of enter event, make enter key select highlighted item instead
* Provide direct access to results widget through getResults method
ve.ui.MenuWidget.js
* Use the selected item as a starting point if nothing is currently
highlighted when adjusting the highlight position
ve.ui.Dialog.js
* Add footless option to hide the foot element and make the body extend
all the way down to the bottom
* Remove applyButton, which only some dialogs need, and should be creating
themselves, along with other buttons as needed
ve.ui.Widget.css
* Change highlight and selected colors of option widgets to match other
selection colors used elsewhere
* Leave selected and highlighted widget looking selected
ve.ui.Frame.css
* Add background color to combat any color that might have been applied to
the frame body in the imported CSS from the parent frame
ve.ui.Dialog.css
* Add rules for footless mode
ve.ui.MWReferenceResultWidget.js,
ve.ui.MWParameterResultWidget.js,
ve.ui.MWMediaResultWidget.js
* Allow highlighting
ve.ui.MWParamterSearchWidget.js
* Switch from selecting the first item when filtering to highlighting
ve-mw/ve.ui.Widget.js
* Adjust media result widget styling to better match other elements
ve.ui.MWTransclusionDialog.js,
ve.ui.MWReferenceListDialog.js,
ve.ui.MWReferenceEditDialog.js,
ve.ui.MWMetaDialog.js
ve.ui.MWMediaEditDialog.js
* Add apply button, as per it being removed from parent class
ve.ui.MWTransclusionDialog.js,
ve.ui.MWReferenceInsertDialog.js,
ve.ui.MWMediaInsertDialog.js
* Insert parameter/reference/media on select, instead of clicking an
insert button
* Use 'insert' instead of 'apply' as argument for close method
Bug: 50774
Bug: 51143
Change-Id: Ia18e79f1f8df2540f465468edb01f5ce989bf843
2013-07-15 21:07:53 +00:00
|
|
|
*
|
2013-04-29 21:01:56 +00:00
|
|
|
* @class
|
2014-12-09 22:09:35 +00:00
|
|
|
* @extends ve.ui.FragmentDialog
|
2013-04-29 21:01:56 +00:00
|
|
|
*
|
|
|
|
* @constructor
|
2013-09-25 10:21:09 +00:00
|
|
|
* @param {Object} [config] Configuration options
|
2013-04-29 21:01:56 +00:00
|
|
|
*/
|
2014-08-21 00:50:54 +00:00
|
|
|
ve.ui.MWMetaDialog = function VeUiMWMetaDialog( config ) {
|
2013-04-29 21:01:56 +00:00
|
|
|
// Parent constructor
|
2014-08-21 00:50:54 +00:00
|
|
|
ve.ui.MWMetaDialog.super.call( this, config );
|
2013-04-29 21:01:56 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
/* Inheritance */
|
|
|
|
|
2014-07-14 21:32:49 +00:00
|
|
|
OO.inheritClass( ve.ui.MWMetaDialog, ve.ui.FragmentDialog );
|
2013-07-03 01:30:10 +00:00
|
|
|
|
2013-04-29 21:01:56 +00:00
|
|
|
/* Static Properties */
|
|
|
|
|
2013-08-27 23:28:29 +00:00
|
|
|
ve.ui.MWMetaDialog.static.name = 'meta';
|
|
|
|
|
2014-02-12 21:45:37 +00:00
|
|
|
ve.ui.MWMetaDialog.static.title =
|
|
|
|
OO.ui.deferMsg( 'visualeditor-dialog-meta-title' );
|
2013-04-29 21:01:56 +00:00
|
|
|
|
2014-07-14 21:32:49 +00:00
|
|
|
ve.ui.MWMetaDialog.static.size = 'large';
|
|
|
|
|
2013-04-29 21:01:56 +00:00
|
|
|
/* Methods */
|
|
|
|
|
2014-07-14 21:32:49 +00:00
|
|
|
/**
|
|
|
|
* @inheritdoc
|
|
|
|
*/
|
|
|
|
ve.ui.MWMetaDialog.prototype.getBodyHeight = function () {
|
|
|
|
return 400;
|
|
|
|
};
|
|
|
|
|
2013-04-29 21:01:56 +00:00
|
|
|
/**
|
2013-11-05 00:29:50 +00:00
|
|
|
* @inheritdoc
|
2013-04-29 21:01:56 +00:00
|
|
|
*/
|
2013-11-05 00:29:50 +00:00
|
|
|
ve.ui.MWMetaDialog.prototype.initialize = function () {
|
|
|
|
// Parent method
|
2014-04-24 00:22:45 +00:00
|
|
|
ve.ui.MWMetaDialog.super.prototype.initialize.call( this );
|
2013-11-05 00:29:50 +00:00
|
|
|
|
|
|
|
// Properties
|
2015-04-09 23:47:15 +00:00
|
|
|
this.panels = new OO.ui.StackLayout();
|
|
|
|
this.bookletLayout = new OO.ui.BookletLayout( { outlined: true } );
|
2017-01-17 00:19:38 +00:00
|
|
|
this.categoriesPage = new ve.ui.MWCategoriesPage( 'categories', { $overlay: this.$overlay } );
|
2017-02-16 01:56:03 +00:00
|
|
|
this.settingsPage = new ve.ui.MWSettingsPage( 'settings', { $overlay: this.$overlay } );
|
|
|
|
this.advancedSettingsPage = new ve.ui.MWAdvancedSettingsPage( 'advancedSettings', { $overlay: this.$overlay } );
|
2018-04-04 20:37:32 +00:00
|
|
|
this.languagesPage = new ve.ui.MWLanguagesPage( 'languages', { $overlay: this.$overlay } );
|
|
|
|
this.templatesUsedPage = new ve.ui.MWTemplatesUsedPage( 'templatesUsed', { $overlay: this.$overlay } );
|
2013-11-05 00:29:50 +00:00
|
|
|
|
|
|
|
// Initialization
|
2014-07-14 21:32:49 +00:00
|
|
|
this.$body.append( this.panels.$element );
|
2014-04-24 00:22:45 +00:00
|
|
|
this.panels.addItems( [ this.bookletLayout ] );
|
2013-12-19 16:38:02 +00:00
|
|
|
this.bookletLayout.addPages( [
|
2017-01-04 19:18:00 +00:00
|
|
|
this.categoriesPage,
|
2013-12-19 16:38:02 +00:00
|
|
|
this.settingsPage,
|
2013-11-15 20:36:53 +00:00
|
|
|
this.advancedSettingsPage,
|
2016-12-18 19:04:20 +00:00
|
|
|
this.languagesPage,
|
|
|
|
this.templatesUsedPage
|
2013-12-19 16:38:02 +00:00
|
|
|
] );
|
2018-10-28 19:18:40 +00:00
|
|
|
|
2020-03-06 19:33:08 +00:00
|
|
|
this.bookletLayout.$menu.find( '[role=listbox]' ).first().attr( 'aria-label', OO.ui.deferMsg( 'visualeditor-dialog-meta-title' ) );
|
2018-10-28 19:18:40 +00:00
|
|
|
this.oldSettings = null;
|
|
|
|
this.widgetList = this.getAllWidgets();
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
2019-04-16 15:17:29 +00:00
|
|
|
* @return {boolean} Whether settings were changed.
|
2018-10-28 19:18:40 +00:00
|
|
|
*/
|
|
|
|
ve.ui.MWMetaDialog.prototype.compareSettings = function () {
|
|
|
|
var newSettings = this.extractSettings();
|
|
|
|
return !ve.compare( newSettings, this.oldSettings );
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
2019-04-16 15:17:29 +00:00
|
|
|
* @return {Object[]} An array of objects
|
2018-10-28 19:18:40 +00:00
|
|
|
* {
|
2020-08-18 12:16:49 +00:00
|
|
|
* widget: OO.ui.Widget,
|
2018-11-21 12:33:32 +00:00
|
|
|
* name: string,
|
|
|
|
* hasChildren: boolean
|
2018-10-28 19:18:40 +00:00
|
|
|
* }
|
|
|
|
*/
|
|
|
|
ve.ui.MWMetaDialog.prototype.getAllWidgets = function () {
|
|
|
|
var widgetList = [];
|
|
|
|
|
2019-02-20 20:23:43 +00:00
|
|
|
// eslint-disable-next-line no-jquery/no-each-util
|
2024-04-30 16:44:25 +00:00
|
|
|
$.each( this.bookletLayout.pages, ( pageName, page ) => {
|
2020-08-18 12:16:49 +00:00
|
|
|
var fieldsets = page.getFieldsets();
|
2024-04-30 16:44:25 +00:00
|
|
|
fieldsets.forEach( ( fieldset, fieldsetIndex ) => {
|
|
|
|
fieldset.items.forEach( ( item, itemIndex ) => {
|
2020-08-18 12:16:49 +00:00
|
|
|
var widget = item.fieldWidget;
|
2018-10-28 19:18:40 +00:00
|
|
|
// we can recheck the value
|
|
|
|
widgetList.push( {
|
|
|
|
widget: widget,
|
2020-08-18 12:16:49 +00:00
|
|
|
name: pageName + '/' + fieldsetIndex + '/' + itemIndex,
|
2018-10-28 19:18:40 +00:00
|
|
|
hasChildren: widget.items !== undefined
|
|
|
|
} );
|
|
|
|
} );
|
|
|
|
} );
|
|
|
|
} );
|
|
|
|
|
|
|
|
return widgetList;
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Assigns updateActions to all widget updates.
|
|
|
|
*/
|
|
|
|
ve.ui.MWMetaDialog.prototype.assignEvents = function () {
|
|
|
|
var widgetList = this.getAllWidgets(),
|
|
|
|
dialog = this;
|
2020-08-18 12:16:49 +00:00
|
|
|
|
2024-04-30 16:44:25 +00:00
|
|
|
widgetList.forEach( ( value ) => {
|
2018-10-28 19:18:40 +00:00
|
|
|
value.widget.connect( dialog, {
|
|
|
|
change: 'updateActions',
|
|
|
|
select: 'updateActions'
|
|
|
|
} );
|
|
|
|
} );
|
|
|
|
};
|
|
|
|
|
2018-10-31 20:56:13 +00:00
|
|
|
/**
|
|
|
|
* @param {Object} field Widget
|
2019-04-16 15:17:29 +00:00
|
|
|
* @return {string|boolean} Value of the field
|
2018-10-31 20:56:13 +00:00
|
|
|
*/
|
|
|
|
ve.ui.MWMetaDialog.prototype.extractValue = function ( field ) {
|
|
|
|
if ( field instanceof OO.ui.TextInputWidget ) {
|
|
|
|
return field.getValue();
|
|
|
|
} else if ( field instanceof OO.ui.CheckboxInputWidget ) {
|
|
|
|
return field.isSelected();
|
|
|
|
} else if ( field instanceof OO.ui.ButtonOptionWidget ) {
|
|
|
|
return field.selected;
|
|
|
|
} else if ( field instanceof ve.ui.MWCategoryItemWidget ) {
|
|
|
|
return {
|
|
|
|
value: field.value,
|
|
|
|
sortKey: field.sortKey };
|
|
|
|
} else {
|
|
|
|
throw new Error( 'Unhandled widget type', field );
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2018-10-28 19:18:40 +00:00
|
|
|
/**
|
2019-04-16 15:17:29 +00:00
|
|
|
* @return {Object[]} An array of all widgets with their current value.
|
2018-10-28 19:18:40 +00:00
|
|
|
* {
|
2018-11-21 12:33:32 +00:00
|
|
|
* name:string,
|
|
|
|
* value:string|boolean
|
2018-10-28 19:18:40 +00:00
|
|
|
* }
|
|
|
|
*/
|
|
|
|
ve.ui.MWMetaDialog.prototype.extractSettings = function () {
|
2018-10-31 20:56:13 +00:00
|
|
|
var ret = [],
|
|
|
|
dialog = this; // return value
|
2018-10-28 19:18:40 +00:00
|
|
|
|
2024-04-30 16:44:25 +00:00
|
|
|
this.widgetList.forEach( ( value ) => {
|
2018-10-28 19:18:40 +00:00
|
|
|
if ( value.hasChildren ) {
|
2024-04-30 16:44:25 +00:00
|
|
|
value.widget.items.forEach( ( item, index ) => {
|
2018-10-28 19:18:40 +00:00
|
|
|
ret.push( {
|
2020-08-18 12:16:49 +00:00
|
|
|
name: item.name + '/' + index,
|
|
|
|
value: dialog.extractValue( item )
|
2018-10-28 19:18:40 +00:00
|
|
|
} );
|
|
|
|
} );
|
|
|
|
} else {
|
|
|
|
ret.push( {
|
|
|
|
name: value.name,
|
2018-10-31 20:56:13 +00:00
|
|
|
value: dialog.extractValue( value.widget )
|
2018-10-28 19:18:40 +00:00
|
|
|
} );
|
|
|
|
}
|
|
|
|
} );
|
|
|
|
|
|
|
|
return ret;
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Compares oldSetting with new settings and toggles the apply button accordingly.
|
|
|
|
*/
|
|
|
|
ve.ui.MWMetaDialog.prototype.updateActions = function () {
|
|
|
|
this.actions.setAbilities( {
|
2019-02-19 17:08:38 +00:00
|
|
|
done: this.settingsPage.checkValidRedirect() && this.compareSettings()
|
2018-10-28 19:18:40 +00:00
|
|
|
} );
|
2013-04-29 21:01:56 +00:00
|
|
|
};
|
|
|
|
|
2019-02-19 17:08:38 +00:00
|
|
|
/**
|
|
|
|
* @inheritdoc ve.ui.FragmentWindow
|
|
|
|
*/
|
|
|
|
ve.ui.MWMetaDialog.prototype.isEditing = function () {
|
|
|
|
// Always in editing mode, used for setting 'done' button label.
|
|
|
|
return true;
|
|
|
|
};
|
|
|
|
|
2014-07-14 21:32:49 +00:00
|
|
|
/**
|
|
|
|
* @inheritdoc
|
|
|
|
*/
|
|
|
|
ve.ui.MWMetaDialog.prototype.getActionProcess = function ( action ) {
|
|
|
|
var surfaceModel = this.getFragment().getSurface();
|
|
|
|
|
2019-02-19 17:08:38 +00:00
|
|
|
if ( action === 'done' ) {
|
2024-04-30 21:25:39 +00:00
|
|
|
return new OO.ui.Process( () => {
|
2014-08-01 14:42:03 +00:00
|
|
|
surfaceModel.applyStaging();
|
2014-08-22 20:50:48 +00:00
|
|
|
this.close( { action: action } );
|
2024-04-30 21:25:39 +00:00
|
|
|
} );
|
2014-07-14 21:32:49 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
return ve.ui.MWMetaDialog.super.prototype.getActionProcess.call( this, action )
|
2024-04-30 16:44:25 +00:00
|
|
|
.next( () => {
|
2014-08-01 14:42:03 +00:00
|
|
|
surfaceModel.popStaging();
|
2024-04-30 21:25:39 +00:00
|
|
|
} );
|
2014-07-14 21:32:49 +00:00
|
|
|
};
|
|
|
|
|
2013-04-29 21:01:56 +00:00
|
|
|
/**
|
2013-11-05 00:29:50 +00:00
|
|
|
* @inheritdoc
|
2013-04-29 21:01:56 +00:00
|
|
|
*/
|
2014-05-31 04:47:08 +00:00
|
|
|
ve.ui.MWMetaDialog.prototype.getSetupProcess = function ( data ) {
|
2014-07-15 22:49:51 +00:00
|
|
|
data = data || {};
|
2014-05-31 04:47:08 +00:00
|
|
|
return ve.ui.MWMetaDialog.super.prototype.getSetupProcess.call( this, data )
|
2024-04-30 21:25:39 +00:00
|
|
|
.next( () => {
|
2022-02-21 18:07:07 +00:00
|
|
|
var surfaceModel = this.getFragment().getSurface(),
|
2018-10-30 18:53:43 +00:00
|
|
|
promises = [],
|
2016-12-18 19:04:20 +00:00
|
|
|
selectWidget = this.bookletLayout.outlineSelectWidget,
|
2017-01-17 00:19:38 +00:00
|
|
|
visualOnlyPages = [ 'categories', 'settings', 'advancedSettings', 'languages' ],
|
2016-12-18 19:04:20 +00:00
|
|
|
isSource = ve.init.target.getSurface().getMode() === 'source';
|
|
|
|
|
2024-04-30 16:44:25 +00:00
|
|
|
visualOnlyPages.forEach( ( page ) => {
|
2017-12-28 06:23:29 +00:00
|
|
|
selectWidget.findItemFromData( page ).setDisabled( isSource );
|
2016-12-18 19:04:20 +00:00
|
|
|
} );
|
|
|
|
|
2017-01-17 00:17:51 +00:00
|
|
|
if ( isSource && visualOnlyPages.indexOf( data.page || 'categories' ) !== -1 ) {
|
2016-12-18 19:04:20 +00:00
|
|
|
data.page = 'templatesUsed';
|
|
|
|
}
|
2014-05-31 04:47:08 +00:00
|
|
|
|
2016-02-18 17:09:53 +00:00
|
|
|
// Force all previous transactions to be separate from this history state
|
|
|
|
surfaceModel.pushStaging();
|
2018-06-21 21:08:17 +00:00
|
|
|
|
2022-02-21 18:07:07 +00:00
|
|
|
var config = {
|
2019-02-25 12:04:03 +00:00
|
|
|
data: data,
|
|
|
|
isReadOnly: this.isReadOnly()
|
|
|
|
};
|
|
|
|
|
2018-06-21 21:08:17 +00:00
|
|
|
// Let each page set itself up ('languages' page doesn't need this yet)
|
2022-01-19 14:25:39 +00:00
|
|
|
promises.push( this.categoriesPage.setup( surfaceModel.getFragment(), config ) );
|
|
|
|
promises.push( this.settingsPage.setup( surfaceModel.getFragment(), config ) );
|
|
|
|
promises.push( this.advancedSettingsPage.setup( surfaceModel.getFragment(), config ) );
|
2019-11-02 16:29:11 +00:00
|
|
|
return ve.promiseAll( promises );
|
2024-04-30 21:25:39 +00:00
|
|
|
} )
|
|
|
|
.next( () => {
|
2018-06-21 21:08:17 +00:00
|
|
|
if ( data.page && this.bookletLayout.getPage( data.page ) ) {
|
|
|
|
// HACK: Prevent the setPage() call from focussing stuff in the selected page. For the
|
|
|
|
// 'categories' page, this causes a dropdown to appear, and if it's done in the setup
|
|
|
|
// process, the dropdown will be misaligned (T185944). We don't pass `autoFocus: false`
|
|
|
|
// in the config because we want the auto-focus behavior when the user changes the page
|
|
|
|
// after the dialog is open. We focus in getReadyProcess() anyway.
|
|
|
|
this.bookletLayout.autoFocus = false;
|
|
|
|
this.bookletLayout.setPage( data.page );
|
|
|
|
this.bookletLayout.autoFocus = true;
|
|
|
|
}
|
2018-10-28 19:18:40 +00:00
|
|
|
|
|
|
|
if ( this.oldSettings === null ) {
|
|
|
|
this.assignEvents();
|
|
|
|
}
|
|
|
|
this.oldSettings = this.extractSettings(); // setting that were just loaded
|
|
|
|
|
2019-02-19 17:08:38 +00:00
|
|
|
this.actions.setAbilities( { done: false } );
|
2024-04-30 21:25:39 +00:00
|
|
|
} );
|
2016-02-18 17:09:53 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @inheritdoc
|
|
|
|
*/
|
|
|
|
ve.ui.MWMetaDialog.prototype.getReadyProcess = function ( data ) {
|
|
|
|
data = data || {};
|
|
|
|
return ve.ui.MWMetaDialog.super.prototype.getReadyProcess.call( this, data )
|
2024-04-30 21:25:39 +00:00
|
|
|
.next( () => {
|
2014-05-31 04:47:08 +00:00
|
|
|
if ( data.page && this.bookletLayout.getPage( data.page ) ) {
|
2016-02-19 17:34:41 +00:00
|
|
|
this.bookletLayout.getPage( data.page ).focus();
|
2014-05-31 04:47:08 +00:00
|
|
|
}
|
2024-04-30 21:25:39 +00:00
|
|
|
} );
|
2013-04-29 21:01:56 +00:00
|
|
|
};
|
|
|
|
|
2014-08-01 14:42:03 +00:00
|
|
|
/**
|
|
|
|
* @inheritdoc
|
|
|
|
*/
|
|
|
|
ve.ui.MWMetaDialog.prototype.getTeardownProcess = function ( data ) {
|
|
|
|
data = data || {};
|
|
|
|
return ve.ui.MWMetaDialog.super.prototype.getTeardownProcess.call( this, data )
|
2024-04-30 21:25:39 +00:00
|
|
|
.first( () => {
|
2014-08-01 14:42:03 +00:00
|
|
|
// Let each page tear itself down ('languages' page doesn't need this yet)
|
2017-01-17 00:19:38 +00:00
|
|
|
this.categoriesPage.teardown( { action: data.action } );
|
2014-08-22 20:50:48 +00:00
|
|
|
this.settingsPage.teardown( { action: data.action } );
|
|
|
|
this.advancedSettingsPage.teardown( { action: data.action } );
|
2018-10-05 17:11:23 +00:00
|
|
|
|
|
|
|
this.bookletLayout.setPage( 'categories' );
|
|
|
|
this.bookletLayout.resetScroll();
|
2024-04-30 21:25:39 +00:00
|
|
|
} );
|
2014-08-01 14:42:03 +00:00
|
|
|
};
|
|
|
|
|
2013-04-29 21:01:56 +00:00
|
|
|
/* Registration */
|
|
|
|
|
2014-04-21 22:31:21 +00:00
|
|
|
ve.ui.windowFactory.register( ve.ui.MWMetaDialog );
|