mediawiki-extensions-Visual.../modules/ve-mw/ui/widgets/ve.ui.MWGalleryItemWidget.js
Ed Sanders ac652a2e36 MWGalleryItemWidget: Remove unnecessary event argument
Listeners will already know which object emitted the event.
Currently this event is used once as a aggregate event,
(as 'editItem' in the ve.ui.MWGalleryGroupWidget constructor)
in which case the emitting object is already prepended as the
first argument (as documented in OO.EmitterList.prototype.aggregate).

Change-Id: I490f368af8e9cae60eacac918bf83702999f705b
2024-09-04 10:58:06 +01:00

140 lines
3.7 KiB
JavaScript

/*!
* VisualEditor user interface MWGalleryItemWidget class.
*
* @copyright See AUTHORS.txt
* @license The MIT License (MIT); see LICENSE.txt
*/
/**
* Draggable item widget for the MWGalleryGroupWidget
*
* @class
* @extends OO.ui.Widget
* @mixes OO.ui.mixin.DraggableElement
*
* @constructor
* @param {Object} imageInfo Image information object
* @param {Object} [config] Configuration options
* @param {boolean} [config.isMobile=false]
* @param {boolean} [config.draggable=true]
*/
ve.ui.MWGalleryItemWidget = function VeUiMWGalleryItemWidget( imageInfo, config ) {
this.resource = imageInfo.resource;
this.altText = imageInfo.altText || '';
this.altTextSame = imageInfo.altTextSame;
this.href = imageInfo.href;
// Keep the original value which may be null
this.originalAltText = imageInfo.altText;
this.src = imageInfo.src;
this.height = imageInfo.height;
this.width = imageInfo.width;
this.thumbUrl = imageInfo.thumbUrl;
this.captionDocument = imageInfo.captionDocument;
this.highlighted = false;
this.tagName = imageInfo.tagName;
this.isError = imageInfo.isError;
this.imageClassAttr = imageInfo.imageClassAttr;
this.imgWrapperClassAttr = imageInfo.imgWrapperClassAttr;
this.mw = imageInfo.mw;
this.mediaClass = imageInfo.mediaClass;
this.mediaTag = imageInfo.mediaTag;
// Configuration initialization
config = config || {};
// Parent constructor
ve.ui.MWGalleryItemWidget.super.call( this, config );
this.$element
.addClass( 've-ui-mwGalleryDialog-image-container mw-no-invert' ) // TODO: put in new CSS file?
.addClass( config.isMobile ?
've-ui-mwGalleryDialog-image-container-mobile' :
've-ui-mwGalleryDialog-image-container-desktop'
)
.css( 'background-image', 'url(' + this.thumbUrl + ')' );
// Mixin constructors
OO.ui.mixin.DraggableElement.call( this, ve.extendObject( { $handle: this.$element }, config ) );
OO.ui.mixin.TabIndexedElement.call( this, config );
this.$element.on( {
click: this.onItemClick.bind( this ),
keypress: this.onItemKeyPress.bind( this )
} );
};
/* Inheritance */
OO.inheritClass( ve.ui.MWGalleryItemWidget, OO.ui.Widget );
OO.mixinClass( ve.ui.MWGalleryItemWidget, OO.ui.mixin.DraggableElement );
OO.mixinClass( ve.ui.MWGalleryItemWidget, OO.ui.mixin.TabIndexedElement );
/* Events */
/**
* @event ve.ui.MWGalleryItemWidget#edit
*/
/* Methods */
/**
* Handle clicking on an item
*
* @fires ve.ui.MWGalleryItemWidget#edit
*/
ve.ui.MWGalleryItemWidget.prototype.onItemClick = function () {
this.emit( 'edit' );
};
/**
* Handle key press events
*
* @param {jQuery.Event} e Key press event
* @return {boolean|undefined}
* @fires ve.ui.MWGalleryItemWidget#edit
*/
ve.ui.MWGalleryItemWidget.prototype.onItemKeyPress = function ( e ) {
if ( e.which === OO.ui.Keys.ENTER ) {
this.emit( 'edit', this );
return false;
}
};
/**
* Set the captionDocument property
*
* @param {ve.dm.Document} captionDocument The caption document
*/
ve.ui.MWGalleryItemWidget.prototype.setCaptionDocument = function ( captionDocument ) {
this.captionDocument = captionDocument;
};
/**
* Set the altText property
*
* @param {string} altText The altText
*/
ve.ui.MWGalleryItemWidget.prototype.setAltText = function ( altText ) {
this.altText = altText;
};
/**
* Set the altTextSame property
*
* @param {boolean} same
*/
ve.ui.MWGalleryItemWidget.prototype.setAltTextSame = function ( same ) {
this.altTextSame = same;
};
/**
* Toggle highlighted class
*
* @param {boolean} highlighted The item is highlighted
*/
ve.ui.MWGalleryItemWidget.prototype.toggleHighlighted = function ( highlighted ) {
highlighted = highlighted !== undefined ? highlighted : !this.highlighted;
this.$element.toggleClass( 've-ui-mwGalleryDialog-image-container-highlighted', !!highlighted );
};