mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/VisualEditor
synced 2024-11-16 19:09:29 +00:00
4367235dcc
This makes the code more readable and easier to reason about. The ESLint rule responsible for this code style was removed just recently. Notes: * I focus on classes that are relevant for what the WMDE team does right now. * I merge multiple `var` keywords only when the variables are strongly connected. * Caching the length in a for loop makes the code hard to read, but not really faster when it's a trivial property access anyway. Bug: T284895 Change-Id: I621fed61d894a83dc95f58129bbe679d82b0f5f5
494 lines
14 KiB
JavaScript
494 lines
14 KiB
JavaScript
/*!
|
|
* VisualEditor user interface MWParameterPage class.
|
|
*
|
|
* @copyright 2011-2020 VisualEditor Team and others; see AUTHORS.txt
|
|
* @license The MIT License (MIT); see LICENSE.txt
|
|
*/
|
|
|
|
/**
|
|
* MediaWiki transclusion dialog template page.
|
|
*
|
|
* @class
|
|
* @extends OO.ui.PageLayout
|
|
*
|
|
* @constructor
|
|
* @param {ve.dm.MWParameterModel} parameter Template parameter
|
|
* @param {string} name Unique symbolic name of page
|
|
* @param {Object} [config] Configuration options
|
|
* @cfg {jQuery} [$overlay] Overlay to render dropdowns in
|
|
* @cfg {boolean} [readOnly] Parameter is read-only
|
|
*/
|
|
ve.ui.MWParameterPage = function VeUiMWParameterPage( parameter, name, config ) {
|
|
var paramName = parameter.getName(),
|
|
veConfig = mw.config.get( 'wgVisualEditorConfig' );
|
|
|
|
// Configuration initialization
|
|
config = ve.extendObject( {
|
|
scrollable: false
|
|
}, config );
|
|
|
|
// Parent constructor
|
|
ve.ui.MWParameterPage.super.call( this, name, config );
|
|
|
|
// Properties
|
|
this.edited = false;
|
|
this.parameter = parameter;
|
|
this.originalValue = parameter.getValue();
|
|
this.spec = parameter.getTemplate().getSpec();
|
|
this.defaultValue = parameter.getDefaultValue();
|
|
this.exampleValue = parameter.getExampleValue();
|
|
|
|
this.$info = $( '<div>' );
|
|
this.$actions = $( '<div>' );
|
|
this.$labelElement = $( '<div>' );
|
|
this.$field = $( '<div>' );
|
|
|
|
// Note: Calling createValueInput() sets some properties we rely on later in this function
|
|
this.valueInput = this.createValueInput()
|
|
.setValue( this.parameter.getValue() )
|
|
.connect( this, { change: 'onValueInputChange' } );
|
|
|
|
if ( config.readOnly && this.valueInput.setReadOnly ) {
|
|
this.valueInput.setReadOnly( true );
|
|
}
|
|
|
|
this.statusIndicator = new OO.ui.IndicatorWidget( {
|
|
classes: [ 've-ui-mwParameterPage-statusIndicator' ]
|
|
} );
|
|
|
|
// Construct the field docs
|
|
|
|
var $doc = $( '<div>' )
|
|
.addClass( 've-ui-mwParameterPage-doc' )
|
|
.append( $( '<p>' )
|
|
.text( this.spec.getParameterDescription( paramName ) || '' ) );
|
|
|
|
if ( this.parameter.isRequired() ) {
|
|
this.statusIndicator
|
|
.setIndicator( 'required' )
|
|
.setTitle(
|
|
ve.msg( 'visualeditor-dialog-transclusion-required-parameter' )
|
|
);
|
|
$doc.append(
|
|
$( '<p>' )
|
|
.addClass( 've-ui-mwParameterPage-doc-required' )
|
|
.text(
|
|
ve.msg( 'visualeditor-dialog-transclusion-required-parameter-description' )
|
|
)
|
|
);
|
|
} else if ( this.parameter.isDeprecated() ) {
|
|
this.statusIndicator
|
|
.setIndicator( 'alert' )
|
|
.setTitle(
|
|
ve.msg( 'visualeditor-dialog-transclusion-deprecated-parameter' )
|
|
);
|
|
$doc.append(
|
|
$( '<p>' )
|
|
.addClass( 've-ui-mwParameterPage-doc-deprecated' )
|
|
.text(
|
|
ve.msg(
|
|
'visualeditor-dialog-transclusion-deprecated-parameter-description',
|
|
this.spec.getParameterDeprecationDescription( paramName )
|
|
)
|
|
)
|
|
);
|
|
}
|
|
|
|
if ( this.defaultValue ) {
|
|
$doc.append(
|
|
$( '<p>' )
|
|
.addClass( 've-ui-mwParameterPage-doc-default' )
|
|
.text(
|
|
ve.msg( 'visualeditor-dialog-transclusion-param-default', this.defaultValue )
|
|
)
|
|
);
|
|
}
|
|
|
|
if ( this.exampleValue ) {
|
|
$doc.append(
|
|
$( '<p>' )
|
|
.addClass( 've-ui-mwParameterPage-doc-example' )
|
|
.text(
|
|
ve.msg(
|
|
veConfig.transclusionDialogInlineDescriptions ?
|
|
'visualeditor-dialog-transclusion-param-example-long' :
|
|
'visualeditor-dialog-transclusion-param-example',
|
|
this.exampleValue
|
|
)
|
|
)
|
|
);
|
|
}
|
|
|
|
// Construct the action buttons
|
|
|
|
if ( !this.rawValueInput ) {
|
|
this.rawFallbackButton = new OO.ui.ButtonWidget( {
|
|
framed: false,
|
|
icon: 'wikiText',
|
|
title: ve.msg( 'visualeditor-dialog-transclusion-raw-fallback' )
|
|
} )
|
|
.connect( this, { click: 'onRawFallbackButtonClick' } );
|
|
|
|
this.$actions.append( this.rawFallbackButton.$element );
|
|
}
|
|
|
|
if ( !veConfig.transclusionDialogInlineDescriptions ) {
|
|
if ( $doc.text().trim() === '' ) {
|
|
this.infoButton = new OO.ui.ButtonWidget( {
|
|
disabled: true,
|
|
title: ve.msg( 'visualeditor-dialog-transclusion-param-info-missing' ),
|
|
framed: false,
|
|
icon: 'info',
|
|
classes: [ 've-ui-mwParameterPage-infoButton' ]
|
|
} );
|
|
} else {
|
|
this.infoButton = new OO.ui.PopupButtonWidget( {
|
|
$overlay: config.$overlay,
|
|
popup: {
|
|
$content: $doc
|
|
},
|
|
title: ve.msg( 'visualeditor-dialog-transclusion-param-info' ),
|
|
framed: false,
|
|
icon: 'info',
|
|
classes: [ 've-ui-mwParameterPage-infoButton' ]
|
|
} );
|
|
}
|
|
|
|
this.$actions.append( this.infoButton.$element );
|
|
}
|
|
|
|
if ( !this.parameter.isRequired() && !config.readOnly ) {
|
|
this.removeButton = new OO.ui.ButtonWidget( {
|
|
framed: false,
|
|
icon: 'trash',
|
|
title: ve.msg( 'visualeditor-dialog-transclusion-remove-param' ),
|
|
flags: [ 'destructive' ],
|
|
classes: [ 've-ui-mwParameterPage-removeButton' ]
|
|
} )
|
|
.connect( this, { click: 'onRemoveButtonClick' } );
|
|
|
|
this.$actions.append( this.removeButton.$element );
|
|
}
|
|
|
|
// Events
|
|
this.$labelElement.on( 'click', this.onLabelClick.bind( this ) );
|
|
|
|
// Initialization
|
|
this.$info
|
|
.addClass( 've-ui-mwParameterPage-info' )
|
|
.append( this.$labelElement, this.statusIndicator.$element );
|
|
this.$actions
|
|
.addClass( 've-ui-mwParameterPage-actions' );
|
|
this.$labelElement
|
|
.addClass( 've-ui-mwParameterPage-label' )
|
|
.text( this.spec.getParameterLabel( paramName ) );
|
|
this.$field
|
|
.addClass( 've-ui-mwParameterPage-field' )
|
|
.append(
|
|
this.valueInput.$element
|
|
);
|
|
if (
|
|
veConfig.transclusionDialogSuggestedValues &&
|
|
this.parameter.getSuggestedValues().length
|
|
) {
|
|
this.warningMessage = new OO.ui.MessageWidget( {
|
|
inline: true,
|
|
classes: [ 've-ui-mwParameterPage-warning' ]
|
|
} ).toggle( false );
|
|
this.$field.append( this.warningMessage.$element );
|
|
}
|
|
this.$element
|
|
.addClass( 've-ui-mwParameterPage' )
|
|
.append( this.$info, this.$field, this.$actions );
|
|
|
|
if ( veConfig.transclusionDialogInlineDescriptions ) {
|
|
this.$field.addClass( 've-ui-mwParameterPage-inlineDescription' );
|
|
this.collapsibleDoc = new ve.ui.MWExpandableContentElement( {
|
|
classes: [ 've-ui-mwParameterPage-inlineDescription' ],
|
|
$content: $doc
|
|
} );
|
|
this.$info.after( this.collapsibleDoc.$element );
|
|
}
|
|
|
|
if ( !config.readOnly ) {
|
|
var addButton = new OO.ui.ButtonWidget( {
|
|
framed: false,
|
|
icon: 'parameter',
|
|
label: ve.msg( 'visualeditor-dialog-transclusion-add-param' )
|
|
} )
|
|
.connect( this, { click: 'onAddButtonFocus' } );
|
|
$( '<div>' )
|
|
.addClass( 've-ui-mwParameterPage-addUndocumented' )
|
|
.append( addButton.$element )
|
|
.appendTo( this.$element );
|
|
}
|
|
};
|
|
|
|
/* Inheritance */
|
|
|
|
OO.inheritClass( ve.ui.MWParameterPage, OO.ui.PageLayout );
|
|
|
|
/* Methods */
|
|
|
|
/**
|
|
* Get default configuration for an input widget.
|
|
*
|
|
* @private
|
|
* @return {Object}
|
|
*/
|
|
ve.ui.MWParameterPage.prototype.getDefaultInputConfig = function () {
|
|
var required = this.parameter.isRequired(),
|
|
veConfig = mw.config.get( 'wgVisualEditorConfig' ),
|
|
valueInputConfig = {
|
|
autosize: true,
|
|
required: required,
|
|
validate: required ? 'non-empty' : null
|
|
};
|
|
|
|
if ( this.defaultValue ) {
|
|
valueInputConfig.placeholder = ve.msg(
|
|
'visualeditor-dialog-transclusion-param-default',
|
|
this.defaultValue
|
|
);
|
|
} else if ( this.exampleValue && !veConfig.transclusionDialogInlineDescriptions ) {
|
|
valueInputConfig.placeholder = ve.msg(
|
|
veConfig.transclusionDialogInlineDescriptions ?
|
|
'visualeditor-dialog-transclusion-param-example-long' :
|
|
'visualeditor-dialog-transclusion-param-example',
|
|
this.exampleValue
|
|
);
|
|
}
|
|
|
|
return valueInputConfig;
|
|
};
|
|
|
|
/**
|
|
* Create a value input widget based on the parameter type and whether it is
|
|
* required or not.
|
|
*
|
|
* @return {OO.ui.InputWidget}
|
|
*/
|
|
ve.ui.MWParameterPage.prototype.createValueInput = function () {
|
|
var type = this.parameter.getType(),
|
|
value = this.parameter.getValue(),
|
|
valueInputConfig = this.getDefaultInputConfig(),
|
|
veConfig = mw.config.get( 'wgVisualEditorConfig' );
|
|
|
|
this.rawValueInput = false;
|
|
delete valueInputConfig.validate;
|
|
|
|
// TODO:
|
|
// * date - T100206
|
|
// * number - T124850
|
|
// * unbalanced-wikitext/content - T106242
|
|
// * string? - T124917
|
|
if (
|
|
type === 'wiki-page-name' &&
|
|
( value === '' || mw.Title.newFromText( value ) )
|
|
) {
|
|
return new mw.widgets.TitleInputWidget( $.extend( {
|
|
api: ve.init.target.getContentApi()
|
|
}, valueInputConfig ) );
|
|
} else if (
|
|
type === 'wiki-file-name' &&
|
|
( value === '' || mw.Title.newFromText( value ) )
|
|
) {
|
|
return new mw.widgets.TitleInputWidget( $.extend( {}, valueInputConfig, {
|
|
api: ve.init.target.getContentApi(),
|
|
namespace: 6,
|
|
showImages: true
|
|
} ) );
|
|
} else if (
|
|
type === 'wiki-user-name' &&
|
|
( value === '' || mw.Title.newFromText( value ) )
|
|
) {
|
|
valueInputConfig.validate = function ( val ) {
|
|
// TODO: Check against wgMaxNameChars
|
|
// TODO: Check against unicode validation regex from MW core's User::isValidUserName
|
|
return !!mw.Title.newFromText( val );
|
|
};
|
|
return new mw.widgets.UserInputWidget( $.extend( {
|
|
api: ve.init.target.getContentApi()
|
|
}, valueInputConfig ) );
|
|
} else if (
|
|
type === 'wiki-template-name' &&
|
|
( value === '' || mw.Title.newFromText( value ) )
|
|
) {
|
|
return new mw.widgets.TitleInputWidget( $.extend( {
|
|
api: ve.init.target.getContentApi()
|
|
}, valueInputConfig, {
|
|
namespace: mw.config.get( 'wgNamespaceIds' ).template
|
|
} ) );
|
|
} else if ( type === 'boolean' && ( value === '1' || value === '0' ) ) {
|
|
return new ve.ui.MWParameterCheckboxInputWidget( valueInputConfig );
|
|
} else if (
|
|
type === 'url' &&
|
|
(
|
|
value === '' ||
|
|
ve.init.platform.getExternalLinkUrlProtocolsRegExp().exec( value.trim() )
|
|
)
|
|
) {
|
|
return ve.ui.MWExternalLinkAnnotationWidget.static.createExternalLinkInputWidget( valueInputConfig );
|
|
} else if (
|
|
veConfig.transclusionDialogSuggestedValues &&
|
|
this.parameter.getSuggestedValues().length &&
|
|
this.isSuggestedValueType( type )
|
|
) {
|
|
valueInputConfig.menu = { filterFromInput: true, highlightOnFilter: true };
|
|
valueInputConfig.options =
|
|
this.parameter.getSuggestedValues().map( function ( suggestedValue ) {
|
|
return { data: suggestedValue };
|
|
} );
|
|
this.rawValueInput = true;
|
|
return new OO.ui.ComboBoxInputWidget( valueInputConfig );
|
|
} else if ( type !== 'line' || value.indexOf( '\n' ) !== -1 ) {
|
|
// If the type is line, but there are already newlines in the provided
|
|
// value, don't break the existing content by only providing a single-
|
|
// line field. (This implies that the TemplateData for the field isn't
|
|
// complying with its use in practice...)
|
|
this.rawValueInput = true;
|
|
return new ve.ui.MWLazyMultilineTextInputWidget( valueInputConfig );
|
|
}
|
|
|
|
return new OO.ui.TextInputWidget( valueInputConfig );
|
|
};
|
|
|
|
/**
|
|
* Whether or not to show suggested values for a given parameter type
|
|
*
|
|
* @param {string} type Parameter type
|
|
* @return {boolean} True if suggested values should be shown
|
|
*/
|
|
ve.ui.MWParameterPage.prototype.isSuggestedValueType = function ( type ) {
|
|
return [ 'unknown', 'content', 'line', 'string', 'number', 'unbalanced-wikitext' ].indexOf( type ) > -1;
|
|
};
|
|
|
|
/**
|
|
* Check if the parameter is empty
|
|
*
|
|
* @return {boolean} The parameter is empty
|
|
*/
|
|
ve.ui.MWParameterPage.prototype.isEmpty = function () {
|
|
return this.valueInput.getValue() === '' && this.defaultValue === '';
|
|
};
|
|
|
|
/**
|
|
* Handle change events from the value input
|
|
*
|
|
* @param {string} value
|
|
*/
|
|
ve.ui.MWParameterPage.prototype.onValueInputChange = function () {
|
|
var value = this.valueInput.getValue();
|
|
|
|
if ( !this.edited ) {
|
|
ve.track( 'activity.transclusion', { action: 'edit-parameter-value' } );
|
|
}
|
|
this.edited = true;
|
|
this.parameter.setValue( value );
|
|
|
|
if ( this.outlineItem ) {
|
|
this.outlineItem.setFlags( { empty: this.isEmpty() } );
|
|
}
|
|
|
|
if ( this.warningMessage ) {
|
|
var isNotSuggestedValue = value &&
|
|
this.parameter.getSuggestedValues().length > 0 &&
|
|
this.parameter.getSuggestedValues().indexOf( value ) === -1;
|
|
if ( isNotSuggestedValue ) {
|
|
this.warningMessage.setLabel( ve.msg( 'visualeditor-dialog-transclusion-suggestedvalues-warning' ) );
|
|
}
|
|
this.warningMessage.toggle( isNotSuggestedValue );
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Handle click events from the remove button
|
|
*/
|
|
ve.ui.MWParameterPage.prototype.onRemoveButtonClick = function () {
|
|
this.parameter.remove();
|
|
};
|
|
|
|
/**
|
|
* Handle click events from the raw fallback button
|
|
*/
|
|
ve.ui.MWParameterPage.prototype.onRawFallbackButtonClick = function () {
|
|
this.valueInput.$element.detach();
|
|
if ( this.rawValueInput ) {
|
|
this.valueInput = this.createValueInput()
|
|
.setValue( this.valueInput.getValue() );
|
|
} else {
|
|
this.valueInput = new OO.ui.TextInputWidget( this.getDefaultInputConfig() )
|
|
.setValue( this.edited ? this.valueInput.getValue() : this.originalValue );
|
|
this.valueInput.$input.addClass( 've-ui-mwParameter-wikitextFallbackInput' );
|
|
this.rawValueInput = true;
|
|
}
|
|
this.valueInput.connect( this, { change: 'onValueInputChange' } );
|
|
this.$field.append( this.valueInput.$element );
|
|
};
|
|
|
|
/**
|
|
* Handle click events from the add button
|
|
*/
|
|
ve.ui.MWParameterPage.prototype.onAddButtonFocus = function () {
|
|
var template = this.parameter.getTemplate();
|
|
template.addParameter( new ve.dm.MWParameterModel( template ) );
|
|
};
|
|
|
|
/**
|
|
* Handle click events from the label element
|
|
*
|
|
* @param {jQuery.Event} e Click event
|
|
*/
|
|
ve.ui.MWParameterPage.prototype.onLabelClick = function () {
|
|
this.valueInput.simulateLabelClick();
|
|
};
|
|
|
|
/**
|
|
* @inheritdoc
|
|
*/
|
|
ve.ui.MWParameterPage.prototype.setOutlineItem = function () {
|
|
// Parent method
|
|
ve.ui.MWParameterPage.super.prototype.setOutlineItem.apply( this, arguments );
|
|
|
|
if ( this.outlineItem ) {
|
|
this.outlineItem
|
|
.setIcon( 'parameter' )
|
|
.setMovable( false )
|
|
.setRemovable( true )
|
|
.setLevel( 1 )
|
|
.setFlags( { empty: this.isEmpty() } )
|
|
.setLabel( this.spec.getParameterLabel( this.parameter.getName() ) );
|
|
|
|
if ( this.parameter.isRequired() ) {
|
|
this.outlineItem
|
|
.setIndicator( 'required' )
|
|
.setTitle(
|
|
ve.msg( 'visualeditor-dialog-transclusion-required-parameter' )
|
|
);
|
|
}
|
|
if ( this.parameter.isDeprecated() ) {
|
|
this.outlineItem
|
|
.setIndicator( 'alert' )
|
|
.setTitle(
|
|
ve.msg( 'visualeditor-dialog-transclusion-deprecated-parameter' )
|
|
);
|
|
}
|
|
}
|
|
};
|
|
|
|
/**
|
|
* @inheritdoc
|
|
*/
|
|
ve.ui.MWParameterPage.prototype.focus = function () {
|
|
this.valueInput.focus();
|
|
};
|
|
|
|
/**
|
|
* Refresh collapsible children.
|
|
*/
|
|
ve.ui.MWParameterPage.prototype.updateSize = function () {
|
|
if ( this.collapsibleDoc ) {
|
|
this.collapsibleDoc.updateSize();
|
|
}
|
|
};
|