mediawiki-extensions-Visual.../modules/ve-mw/ui/widgets/ve.ui.MWDismissibleMessageWidget.js
Thiemo Kreuz 36bd65dda7 Cleanups and optimizations related to .parseDom()
E.g. avoid calling the rather expensive method multiple times
in a row, if only 1 of the results is needed.

Change-Id: Iff1d2c0892367e927303f6f45d3231e04c045cab
2021-09-02 18:29:09 +00:00

73 lines
1.9 KiB
JavaScript

/**
* Creates a ve.ui.MWDismissibleMessageWidget object.
*
* This widget allows a user to permanently dismiss a message widget
* {@see OO.ui.MessageWidget}. When the widget is dismissed, a flag
* is set in the local storage. This flag will then be used to prevent
* the widget from being shown on subsequent views.
*
* @class
* @extends OO.ui.MessageWidget
*
* @constructor
* @param {Object} config Configuration options
* @cfg {mw.Message} message Message to display
*/
ve.ui.MWDismissibleMessageWidget = function VeUiMWDismissibleMessageWidget( config ) {
config.label = config.message.parseDom();
// Parent constructor
ve.ui.MWDismissibleMessageWidget.super.call( this, config );
ve.targetLinksToNewWindow( this.$label[ 0 ] );
// Properties
this.messageKey = config.message.key;
delete config.message;
var dismissButton = new OO.ui.ButtonWidget( {
icon: 'close',
framed: false,
title: mw.msg( 'visualeditor-dismissible-message-close' )
} )
.connect( this, { click: 'onDismissClick' } );
this.$element
.addClass( 've-ui-dismissibleMessageWidget' )
.prepend( dismissButton.$element );
var hidden = !!mw.storage.get( this.getStorageKey() );
this.toggle( !hidden );
};
/* Inheritance */
OO.inheritClass( ve.ui.MWDismissibleMessageWidget, OO.ui.MessageWidget );
/* Static Properties */
ve.ui.MWDismissibleMessageWidget.static.storageKeyPrefix = 'mwe-visualeditor-hide-';
/* Methods */
/**
* Generates a local storage key using both a shared prefix and
* the message's key {@see mw.Message}.
*
* @return {string} The local storage key
*/
ve.ui.MWDismissibleMessageWidget.prototype.getStorageKey = function () {
return this.constructor.static.storageKeyPrefix + this.messageKey;
};
/**
* Respond to dismiss button click event.
*
* @fires close
*/
ve.ui.MWDismissibleMessageWidget.prototype.onDismissClick = function () {
mw.storage.set( this.getStorageKey(), '1' );
this.toggle( false );
this.emit( 'close' );
};