2021-05-17 15:43:49 +00:00
|
|
|
/**
|
2022-07-12 09:55:54 +00:00
|
|
|
* Container for the entire transclusion dialog sidebar, may contain a single or
|
|
|
|
* multiple templates or raw wikitext snippets.
|
2021-05-17 15:43:49 +00:00
|
|
|
*
|
|
|
|
* @class
|
|
|
|
* @extends OO.ui.Widget
|
|
|
|
*
|
|
|
|
* @constructor
|
2021-07-09 15:33:16 +00:00
|
|
|
* @property {Object.<string,ve.ui.MWTransclusionOutlinePartWidget>} partWidgets Map of top-level
|
|
|
|
* items currently visible in this container, indexed by part id
|
2021-05-17 15:43:49 +00:00
|
|
|
*/
|
2021-09-21 08:35:36 +00:00
|
|
|
ve.ui.MWTransclusionOutlineWidget = function VeUiMWTransclusionOutlineWidget() {
|
2021-05-17 15:43:49 +00:00
|
|
|
// Parent constructor
|
2021-09-21 08:35:36 +00:00
|
|
|
ve.ui.MWTransclusionOutlineWidget.super.call( this, {
|
|
|
|
classes: [ 've-ui-mwTransclusionOutlineWidget' ]
|
2021-09-10 19:18:59 +00:00
|
|
|
} );
|
2021-05-17 15:43:49 +00:00
|
|
|
|
|
|
|
// Initialization
|
2021-07-09 15:33:16 +00:00
|
|
|
this.partWidgets = {};
|
2021-05-17 15:43:49 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
/* Inheritance */
|
|
|
|
|
2021-09-21 08:35:36 +00:00
|
|
|
OO.inheritClass( ve.ui.MWTransclusionOutlineWidget, OO.ui.Widget );
|
2021-06-17 11:20:50 +00:00
|
|
|
|
|
|
|
/* Events */
|
|
|
|
|
2021-08-05 12:36:10 +00:00
|
|
|
/**
|
2021-08-31 08:05:25 +00:00
|
|
|
* @event filterPagesByName
|
|
|
|
* @param {Object.<string,boolean>} visibility Keyed by unique id of the {@see OO.ui.BookletLayout}
|
|
|
|
* page, e.g. something like "part_1/param1".
|
2021-08-05 12:36:10 +00:00
|
|
|
*/
|
|
|
|
|
2021-08-19 11:02:11 +00:00
|
|
|
/**
|
2022-07-04 08:41:37 +00:00
|
|
|
* Respond to the intent to select a sidebar item
|
|
|
|
*
|
2022-07-15 12:30:26 +00:00
|
|
|
* @event sidebarItemSelected
|
2021-08-31 08:05:25 +00:00
|
|
|
* @param {string} pageName Unique id of the {@see OO.ui.BookletLayout} page, e.g. something like
|
|
|
|
* "part_1" or "part_1/param1".
|
2022-07-12 18:10:02 +00:00
|
|
|
* @param {boolean} [soft] If true, don't focus the content pane. Defaults to false.
|
2021-08-19 11:02:11 +00:00
|
|
|
*/
|
|
|
|
|
2022-07-04 08:41:37 +00:00
|
|
|
/* Methods */
|
|
|
|
|
2021-06-17 11:20:50 +00:00
|
|
|
/**
|
2021-07-07 08:04:40 +00:00
|
|
|
* @param {ve.dm.MWTransclusionPartModel|null} removed Removed part
|
|
|
|
* @param {ve.dm.MWTransclusionPartModel|null} added Added part
|
2021-07-15 15:07:21 +00:00
|
|
|
* @param {number} [newPosition]
|
2021-06-17 11:20:50 +00:00
|
|
|
*/
|
2021-09-21 08:35:36 +00:00
|
|
|
ve.ui.MWTransclusionOutlineWidget.prototype.onReplacePart = function ( removed, added, newPosition ) {
|
2021-07-09 15:33:16 +00:00
|
|
|
if ( removed ) {
|
|
|
|
this.removePartWidget( removed );
|
2021-06-17 11:20:50 +00:00
|
|
|
}
|
2021-07-09 15:33:16 +00:00
|
|
|
if ( added ) {
|
2022-02-22 10:37:21 +00:00
|
|
|
this.addPartWidget( added, newPosition, removed );
|
2021-06-17 11:20:50 +00:00
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2022-06-30 14:32:39 +00:00
|
|
|
/**
|
|
|
|
* Handle spacebar in a part header
|
|
|
|
*
|
2022-07-12 18:10:02 +00:00
|
|
|
* @param {string} pageName
|
2022-07-15 12:30:26 +00:00
|
|
|
* @fires sidebarItemSelected
|
2022-06-30 14:32:39 +00:00
|
|
|
*/
|
|
|
|
ve.ui.MWTransclusionOutlineWidget.prototype.onTransclusionPartSoftSelected = function ( pageName ) {
|
2022-07-15 12:30:26 +00:00
|
|
|
this.emit( 'sidebarItemSelected', pageName, true );
|
2022-06-30 14:32:39 +00:00
|
|
|
};
|
|
|
|
|
2021-06-17 11:20:50 +00:00
|
|
|
/**
|
|
|
|
* @private
|
2021-07-09 15:33:16 +00:00
|
|
|
* @param {ve.dm.MWTransclusionPartModel} part
|
2021-06-17 11:20:50 +00:00
|
|
|
*/
|
2021-09-21 08:35:36 +00:00
|
|
|
ve.ui.MWTransclusionOutlineWidget.prototype.removePartWidget = function ( part ) {
|
2021-08-27 16:22:37 +00:00
|
|
|
var id = part.getId();
|
|
|
|
if ( id in this.partWidgets ) {
|
|
|
|
this.partWidgets[ id ]
|
|
|
|
.disconnect( this )
|
|
|
|
.$element.remove();
|
|
|
|
delete this.partWidgets[ id ];
|
2021-07-09 15:33:16 +00:00
|
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @private
|
|
|
|
* @param {ve.dm.MWTransclusionPartModel} part
|
2021-07-15 15:07:21 +00:00
|
|
|
* @param {number} [newPosition]
|
2022-02-22 10:37:21 +00:00
|
|
|
* @param {ve.dm.MWTransclusionPartModel|null} [removed]
|
2021-08-31 08:05:25 +00:00
|
|
|
* @fires filterPagesByName
|
2021-07-09 15:33:16 +00:00
|
|
|
*/
|
2022-02-22 10:37:21 +00:00
|
|
|
ve.ui.MWTransclusionOutlineWidget.prototype.addPartWidget = function ( part, newPosition, removed ) {
|
2021-07-09 15:33:16 +00:00
|
|
|
var widget;
|
|
|
|
|
|
|
|
if ( part instanceof ve.dm.MWTemplateModel ) {
|
2022-02-22 10:37:21 +00:00
|
|
|
widget = new ve.ui.MWTransclusionOutlineTemplateWidget( part, removed instanceof ve.dm.MWTemplatePlaceholderModel );
|
2021-08-05 12:36:10 +00:00
|
|
|
// This forwards events from the nested ve.ui.MWTransclusionOutlineTemplateWidget upwards.
|
2021-08-31 10:35:26 +00:00
|
|
|
widget.connect( this, {
|
2022-06-30 15:27:55 +00:00
|
|
|
filterParametersById: 'onFilterParametersByName'
|
2021-08-31 10:35:26 +00:00
|
|
|
} );
|
2021-07-09 15:33:16 +00:00
|
|
|
} else if ( part instanceof ve.dm.MWTemplatePlaceholderModel ) {
|
|
|
|
widget = new ve.ui.MWTransclusionOutlinePlaceholderWidget( part );
|
|
|
|
} else if ( part instanceof ve.dm.MWTransclusionContentModel ) {
|
|
|
|
widget = new ve.ui.MWTransclusionOutlineWikitextWidget( part );
|
|
|
|
}
|
|
|
|
|
2021-08-31 10:35:26 +00:00
|
|
|
widget.connect( this, {
|
2022-06-30 14:32:39 +00:00
|
|
|
transclusionPartSoftSelected: 'onTransclusionPartSoftSelected',
|
2022-07-18 12:45:51 +00:00
|
|
|
transclusionOutlineItemSelected: [ 'emit', 'sidebarItemSelected' ]
|
2021-08-31 10:35:26 +00:00
|
|
|
} );
|
2021-07-13 11:02:26 +00:00
|
|
|
|
2021-07-09 15:33:16 +00:00
|
|
|
this.partWidgets[ part.getId() ] = widget;
|
2021-07-15 15:07:21 +00:00
|
|
|
if ( typeof newPosition === 'number' && newPosition < this.$element.children().length ) {
|
|
|
|
this.$element.children().eq( newPosition ).before( widget.$element );
|
|
|
|
} else {
|
|
|
|
this.$element.append( widget.$element );
|
|
|
|
}
|
2021-06-17 11:20:50 +00:00
|
|
|
};
|
2021-07-13 11:02:26 +00:00
|
|
|
|
2022-02-03 12:30:29 +00:00
|
|
|
ve.ui.MWTransclusionOutlineWidget.prototype.hideAllUnusedParameters = function () {
|
|
|
|
for ( var id in this.partWidgets ) {
|
|
|
|
var partWidget = this.partWidgets[ id ];
|
|
|
|
if ( partWidget instanceof ve.ui.MWTransclusionOutlineTemplateWidget &&
|
|
|
|
partWidget.toggleUnusedWidget
|
|
|
|
) {
|
|
|
|
partWidget.toggleUnusedWidget.toggleUnusedParameters( false );
|
|
|
|
}
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2021-08-27 17:07:17 +00:00
|
|
|
/**
|
|
|
|
* This is inspired by {@see OO.ui.SelectWidget.selectItem}, but isn't one.
|
|
|
|
*
|
2022-07-05 12:37:12 +00:00
|
|
|
* @param {string} [pageName] Symbolic name of page. Omit to remove current selection.
|
2021-08-27 17:07:17 +00:00
|
|
|
*/
|
2021-09-30 11:08:10 +00:00
|
|
|
ve.ui.MWTransclusionOutlineWidget.prototype.setSelectionByPageName = function ( pageName ) {
|
2022-07-05 12:37:12 +00:00
|
|
|
var selectedPartId = pageName ? pageName.split( '/', 1 )[ 0 ] : null,
|
|
|
|
isParameter = pageName ? pageName.length > selectedPartId.length : false;
|
2021-09-21 09:32:32 +00:00
|
|
|
|
2022-06-30 07:19:43 +00:00
|
|
|
for ( var partId in this.partWidgets ) {
|
|
|
|
var partWidget = this.partWidgets[ partId ],
|
|
|
|
selected = partId === pageName;
|
2021-09-21 09:32:32 +00:00
|
|
|
|
2022-07-18 10:48:45 +00:00
|
|
|
partWidget.setSelected( selected );
|
2022-07-06 12:58:55 +00:00
|
|
|
if ( selected && !isParameter ) {
|
|
|
|
partWidget.scrollElementIntoView();
|
2021-09-13 11:42:20 +00:00
|
|
|
}
|
2021-09-21 09:32:32 +00:00
|
|
|
|
2022-06-30 07:19:43 +00:00
|
|
|
if ( partWidget instanceof ve.ui.MWTransclusionOutlineTemplateWidget ) {
|
|
|
|
var selectedParamName = ( partId === selectedPartId && isParameter ) ?
|
|
|
|
pageName.slice( selectedPartId.length + 1 ) : null;
|
2022-07-09 06:54:35 +00:00
|
|
|
partWidget.setParameter( selectedParamName );
|
2021-09-21 09:32:32 +00:00
|
|
|
}
|
2021-09-13 11:42:20 +00:00
|
|
|
}
|
2021-08-27 17:07:17 +00:00
|
|
|
};
|
|
|
|
|
2022-06-15 14:47:54 +00:00
|
|
|
/**
|
|
|
|
* @param {string} pageName
|
|
|
|
* @param {boolean} hasValue
|
|
|
|
*/
|
|
|
|
ve.ui.MWTransclusionOutlineWidget.prototype.toggleHasValueByPageName = function ( pageName, hasValue ) {
|
2022-07-22 13:10:46 +00:00
|
|
|
var idParts = pageName.split( '/', 2 ),
|
2022-06-15 14:47:54 +00:00
|
|
|
templatePartWidget = this.partWidgets[ idParts[ 0 ] ];
|
|
|
|
|
|
|
|
templatePartWidget.toggleHasValue( idParts[ 1 ], hasValue );
|
|
|
|
};
|
|
|
|
|
2021-07-16 12:37:34 +00:00
|
|
|
/**
|
|
|
|
* Removes all {@see ve.ui.MWTransclusionOutlinePartWidget}, i.e. empties the list.
|
|
|
|
*/
|
2021-09-21 08:35:36 +00:00
|
|
|
ve.ui.MWTransclusionOutlineWidget.prototype.clear = function () {
|
2021-08-27 16:22:37 +00:00
|
|
|
for ( var id in this.partWidgets ) {
|
|
|
|
this.partWidgets[ id ]
|
|
|
|
.disconnect( this )
|
|
|
|
.$element.remove();
|
2021-07-16 12:37:34 +00:00
|
|
|
}
|
|
|
|
this.partWidgets = {};
|
|
|
|
};
|
2022-06-30 15:27:55 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @private
|
2022-07-12 18:10:02 +00:00
|
|
|
* @param {Object.<string,boolean>} visibility
|
|
|
|
* @fires filterPagesByName
|
2022-06-30 15:27:55 +00:00
|
|
|
*/
|
2022-07-12 18:10:02 +00:00
|
|
|
ve.ui.MWTransclusionOutlineWidget.prototype.onFilterParametersByName = function ( visibility ) {
|
|
|
|
this.emit( 'filterPagesByName', visibility );
|
2022-06-30 15:27:55 +00:00
|
|
|
this.setSelectionByPageName();
|
|
|
|
};
|