mirror of
https://gerrit.wikimedia.org/r/mediawiki/extensions/VisualEditor
synced 2024-11-15 18:39:52 +00:00
aa556e3ef8
I tried to review all of them. Some of the changes I did: * Make sure the `config` parameter is not marked as optional when it is not. * Make sure default values are mentioned. * List individual `@cfg` options when it makes sense. Note I don't list all options a class could accept (e.g. via all its parent classes and mixins). That's too much. Instead I checked how a class is actually used and list only these options. Even then I don't list everything, e.g. unspecific options like "classes" that can be used pretty much everywhere. Change-Id: Idf4fbe1dc3608ace277df9e385f2f140df3a2f50
129 lines
3.5 KiB
JavaScript
129 lines
3.5 KiB
JavaScript
/*!
|
|
* VisualEditor UserInterface MediaWiki EducationPopup class.
|
|
*
|
|
* @copyright 2011-2020 VisualEditor Team and others; see AUTHORS.txt
|
|
* @license The MIT License (MIT); see LICENSE.txt
|
|
*/
|
|
|
|
/**
|
|
* UserInterface education popup.
|
|
*
|
|
* Shows a pulsating blue dot which, when you click,
|
|
* reveals a popup with useful information.
|
|
*
|
|
* @class
|
|
*
|
|
* @constructor
|
|
* @extends OO.ui.Widget
|
|
* @param {jQuery} $target Element to attach to
|
|
* @param {Object} config Configuration options
|
|
* @cfg {string} popupTitle
|
|
* @cfg {string} popupText
|
|
* @cfg {string} [popupImage] Popup image class
|
|
* @cfg {string} [trackingName]
|
|
*/
|
|
ve.ui.MWEducationPopupWidget = function VeUiMwEducationPopup( $target, config ) {
|
|
var $popupContent;
|
|
|
|
config = config || {};
|
|
|
|
// HACK: Do not display on platforms other than desktop
|
|
if ( !( ve.init.mw.DesktopArticleTarget && ve.init.target instanceof ve.init.mw.DesktopArticleTarget ) ) {
|
|
return;
|
|
}
|
|
|
|
// Do not display if the user already acknowledged the popups
|
|
if ( !mw.libs.ve.shouldShowEducationPopups() ) {
|
|
return;
|
|
}
|
|
|
|
// Parent method
|
|
ve.ui.MWEducationPopupWidget.super.call( this, config );
|
|
|
|
// Properties
|
|
this.$target = $target;
|
|
this.popupCloseButton = new OO.ui.ButtonWidget( {
|
|
label: ve.msg( 'visualeditor-educationpopup-dismiss' ),
|
|
flags: [ 'progressive', 'primary' ],
|
|
classes: [ 've-ui-educationPopup-dismiss' ]
|
|
} );
|
|
this.trackingName = config.trackingName;
|
|
this.$pulsatingDot = $( '<div>' ).addClass( 'mw-pulsating-dot' );
|
|
|
|
$popupContent = $( '<div>' ).append(
|
|
$( '<h3>' ).text( config.popupTitle ),
|
|
$( '<p>' ).text( config.popupText ),
|
|
this.popupCloseButton.$element
|
|
);
|
|
if ( config.popupImage ) {
|
|
$popupContent.prepend(
|
|
// eslint-disable-next-line mediawiki/class-doc
|
|
$( '<div>' ).addClass( 've-ui-educationPopup-image ve-ui-educationPopup-image-' + config.popupImage )
|
|
);
|
|
}
|
|
|
|
this.popup = new OO.ui.PopupWidget( {
|
|
$floatableContainer: this.$target,
|
|
$content: $popupContent,
|
|
padded: true,
|
|
width: 300
|
|
} );
|
|
|
|
this.onTargetMouseDownHandler = this.onTargetMouseDown.bind( this );
|
|
|
|
// Events
|
|
this.$target.on( 'mousedown', this.onTargetMouseDownHandler );
|
|
this.popupCloseButton.connect( this, { click: 'onPopupCloseButtonClick' } );
|
|
|
|
// DOME
|
|
this.$element.addClass( 've-ui-educationPopup' ).append( this.$pulsatingDot, this.popup.$element );
|
|
};
|
|
|
|
/* Inheritance */
|
|
|
|
OO.inheritClass( ve.ui.MWEducationPopupWidget, OO.ui.Widget );
|
|
|
|
/* Methods */
|
|
|
|
/**
|
|
* Handle mouse down events on the handle
|
|
*
|
|
* @param {jQuery.Event} e
|
|
*/
|
|
ve.ui.MWEducationPopupWidget.prototype.onTargetMouseDown = function () {
|
|
if ( ve.init.target.openEducationPopup ) {
|
|
ve.init.target.openEducationPopup.popup.toggle( false );
|
|
ve.init.target.openEducationPopup.$pulsatingDot.removeClass( 'oo-ui-element-hidden' );
|
|
}
|
|
ve.init.target.openEducationPopup = this;
|
|
|
|
this.$pulsatingDot.addClass( 'oo-ui-element-hidden' );
|
|
this.popup.toggle( true );
|
|
this.popupCloseButton.focus();
|
|
|
|
if ( this.trackingName ) {
|
|
ve.track( 'activity.' + this.trackingName + 'EducationPopup', { action: 'show' } );
|
|
}
|
|
return false;
|
|
};
|
|
|
|
/**
|
|
* Click handler for the popup close button
|
|
*/
|
|
ve.ui.MWEducationPopupWidget.prototype.onPopupCloseButtonClick = function () {
|
|
var mouseLeft;
|
|
|
|
this.$target.off( 'mousedown', this.onTargetMouseDownHandler );
|
|
this.popup.toggle( false );
|
|
|
|
ve.init.target.openEducationPopup = null;
|
|
mw.libs.ve.stopShowingEducationPopups();
|
|
|
|
mouseLeft = { which: OO.ui.MouseButtons.LEFT };
|
|
this.$target
|
|
.trigger( $.Event( 'mousedown', mouseLeft ) )
|
|
.trigger( $.Event( 'mouseup', mouseLeft ) )
|
|
.trigger( $.Event( 'click', mouseLeft ) );
|
|
|
|
};
|