2013-12-02 20:10:55 +00:00
|
|
|
/*!
|
|
|
|
* VisualEditor user interface MWTemplatePage class.
|
|
|
|
*
|
2023-12-01 16:06:11 +00:00
|
|
|
* @copyright See AUTHORS.txt
|
2013-12-02 20:10:55 +00:00
|
|
|
* @license The MIT License (MIT); see LICENSE.txt
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
2022-07-12 09:55:54 +00:00
|
|
|
* Template dialog content pane header for a template. Includes informational
|
|
|
|
* messages about the template, such as a link to the page where it's defined.
|
2013-12-02 20:10:55 +00:00
|
|
|
*
|
|
|
|
* @class
|
|
|
|
* @extends OO.ui.PageLayout
|
|
|
|
*
|
|
|
|
* @constructor
|
2015-08-19 18:33:59 +00:00
|
|
|
* @param {ve.dm.MWTemplateModel} template Template model
|
2013-12-02 20:10:55 +00:00
|
|
|
* @param {string} name Unique symbolic name of page
|
|
|
|
* @param {Object} [config] Configuration options
|
2018-04-04 20:37:32 +00:00
|
|
|
* @cfg {jQuery} [$overlay] Overlay to render dropdowns in
|
2019-02-24 12:38:03 +00:00
|
|
|
* @cfg {boolean} [isReadOnly] Page is read-only
|
2013-12-02 20:10:55 +00:00
|
|
|
*/
|
|
|
|
ve.ui.MWTemplatePage = function VeUiMWTemplatePage( template, name, config ) {
|
2022-06-21 10:30:42 +00:00
|
|
|
var link = template.getTemplateDataQueryTitle();
|
2014-03-06 23:40:43 +00:00
|
|
|
|
2014-04-25 23:50:21 +00:00
|
|
|
// Configuration initialization
|
|
|
|
config = ve.extendObject( {
|
2014-08-22 20:50:48 +00:00
|
|
|
scrollable: false
|
2014-04-25 23:50:21 +00:00
|
|
|
}, config );
|
|
|
|
|
2013-12-02 20:10:55 +00:00
|
|
|
// Parent constructor
|
2016-08-22 21:44:59 +00:00
|
|
|
ve.ui.MWTemplatePage.super.call( this, name, config );
|
2013-12-02 20:10:55 +00:00
|
|
|
|
|
|
|
// Properties
|
|
|
|
this.template = template;
|
2014-02-27 23:58:37 +00:00
|
|
|
this.spec = template.getSpec();
|
2021-08-26 13:34:39 +00:00
|
|
|
this.$description = $( '<div>' )
|
|
|
|
.addClass( 've-ui-mwTemplatePage-description' );
|
2013-12-02 20:10:55 +00:00
|
|
|
this.infoFieldset = new OO.ui.FieldsetLayout( {
|
2014-08-22 20:50:48 +00:00
|
|
|
label: this.spec.getLabel(),
|
2017-07-06 16:52:56 +00:00
|
|
|
icon: 'puzzle'
|
2013-12-02 20:10:55 +00:00
|
|
|
} );
|
|
|
|
|
|
|
|
// Initialization
|
2022-12-29 00:07:50 +00:00
|
|
|
var description = this.spec.getDescription();
|
|
|
|
if ( description ) {
|
|
|
|
this.$description.append(
|
|
|
|
$( '<p>' ).text( description )
|
|
|
|
);
|
|
|
|
}
|
2021-08-23 14:08:51 +00:00
|
|
|
|
2021-08-26 13:34:39 +00:00
|
|
|
// The transcluded page may be dynamically generated or unspecified in the DOM
|
|
|
|
// for other reasons (T68724). In that case we can't tell the user what the
|
|
|
|
// template is called, nor link to the template page. However, if we know for
|
|
|
|
// certain that the template doesn't exist, be explicit about it (T162694).
|
2021-08-23 14:08:51 +00:00
|
|
|
var linkData = ve.init.platform.linkCache.getCached( '_missing/' + link ),
|
2021-09-21 13:25:43 +00:00
|
|
|
knownAsMissing = link && linkData && linkData.missing;
|
2021-08-23 14:08:51 +00:00
|
|
|
|
2021-09-21 13:25:43 +00:00
|
|
|
var key,
|
2022-12-29 00:07:50 +00:00
|
|
|
messageStyle = 've-ui-mwTemplatePage-description-missing';
|
|
|
|
if ( description ) {
|
2022-06-21 10:30:42 +00:00
|
|
|
key = 'visualeditor-dialog-transclusion-see-template';
|
2021-09-21 13:25:43 +00:00
|
|
|
messageStyle = 've-ui-mwTemplatePage-description-extra';
|
|
|
|
} else if ( !link || knownAsMissing ) {
|
|
|
|
var title;
|
|
|
|
try {
|
|
|
|
title = link && new mw.Title( link );
|
|
|
|
} catch ( e ) {
|
2014-07-02 19:38:29 +00:00
|
|
|
}
|
2021-09-21 13:25:43 +00:00
|
|
|
// When {{User:Foo}} can be parsed as "Foo", we know the ":" is not syntax.
|
|
|
|
key = title && title.getMain().indexOf( ':' ) === -1 ?
|
|
|
|
'visualeditor-dialog-transclusion-template-title-nonexistent' :
|
|
|
|
'visualeditor-dialog-transclusion-template-title-modifier';
|
2021-09-21 14:12:00 +00:00
|
|
|
} else {
|
2021-09-21 13:25:43 +00:00
|
|
|
key = 'visualeditor-dialog-transclusion-no-template-description';
|
2014-03-06 23:40:43 +00:00
|
|
|
}
|
2021-09-21 13:25:43 +00:00
|
|
|
|
|
|
|
if ( key ) {
|
2022-12-29 00:07:50 +00:00
|
|
|
var $addMessageHere = $( '<p>' );
|
2021-10-25 15:51:29 +00:00
|
|
|
// The following messages are used here:
|
|
|
|
// * visualeditor-dialog-transclusion-no-template-description
|
|
|
|
// * visualeditor-dialog-transclusion-see-template
|
|
|
|
// * visualeditor-dialog-transclusion-template-title-modifier
|
|
|
|
// * visualeditor-dialog-transclusion-template-title-nonexistent
|
|
|
|
var $msg = mw.message( key, this.spec.getLabel(), link ).parseDom();
|
2021-09-21 13:25:43 +00:00
|
|
|
// The following classes are used here:
|
|
|
|
// * ve-ui-mwTemplatePage-description-extra
|
|
|
|
// * ve-ui-mwTemplatePage-description-missing
|
2021-10-25 15:51:29 +00:00
|
|
|
$addMessageHere.addClass( messageStyle ).append( $msg );
|
2021-09-21 13:25:43 +00:00
|
|
|
ve.targetLinksToNewWindow( $addMessageHere[ 0 ] );
|
2022-12-29 00:07:50 +00:00
|
|
|
this.$description.append( $addMessageHere );
|
2021-09-21 13:25:43 +00:00
|
|
|
}
|
|
|
|
|
2020-11-26 09:49:17 +00:00
|
|
|
this.$description.find( 'a[href]' )
|
|
|
|
.on( 'click', function () {
|
|
|
|
ve.track( 'activity.transclusion', { action: 'template-doc-link-click' } );
|
|
|
|
} );
|
2014-07-09 20:09:05 +00:00
|
|
|
|
2021-08-23 14:08:51 +00:00
|
|
|
this.infoFieldset.$element
|
|
|
|
.append( this.$description );
|
|
|
|
|
2022-06-21 10:30:42 +00:00
|
|
|
if ( !knownAsMissing ) {
|
2021-08-31 11:04:27 +00:00
|
|
|
var noticeWidget;
|
|
|
|
|
2022-04-28 11:54:33 +00:00
|
|
|
if ( this.template.getSpec().getDocumentedParameterOrder().length &&
|
|
|
|
!this.template.getSpec().isDocumented()
|
|
|
|
) {
|
2021-08-31 11:04:27 +00:00
|
|
|
noticeWidget = new OO.ui.MessageWidget( {
|
2021-08-23 14:08:51 +00:00
|
|
|
label: mw.message( 'visualeditor-dialog-transclusion-no-template-data-description', link ).parseDom(),
|
|
|
|
classes: [ 've-ui-mwTransclusionDialog-template-note' ],
|
|
|
|
type: 'warning'
|
|
|
|
} );
|
2021-08-31 11:04:27 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
if ( noticeWidget && noticeWidget.$element ) {
|
|
|
|
ve.targetLinksToNewWindow( noticeWidget.$element[ 0 ] );
|
|
|
|
this.infoFieldset.$element.append( noticeWidget.$element );
|
2021-08-23 14:08:51 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-02-27 23:58:37 +00:00
|
|
|
this.$element
|
|
|
|
.addClass( 've-ui-mwTemplatePage' )
|
2019-02-24 12:38:03 +00:00
|
|
|
.append( this.infoFieldset.$element );
|
2013-12-02 20:10:55 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
/* Inheritance */
|
|
|
|
|
|
|
|
OO.inheritClass( ve.ui.MWTemplatePage, OO.ui.PageLayout );
|
|
|
|
|
|
|
|
/* Methods */
|
|
|
|
|
2021-07-16 12:26:07 +00:00
|
|
|
ve.ui.MWTemplatePage.prototype.addPlaceholderParameter = function () {
|
2014-03-04 22:56:14 +00:00
|
|
|
this.template.addParameter( new ve.dm.MWParameterModel( this.template ) );
|
|
|
|
};
|