mediawiki-extensions-Visual.../modules/ve/ui/widgets/ve.ui.PopupButtonWidget.js
Trevor Parscal 6ec34a3dee Toolbar action widgetization and UI refactoring
Objectives:

* Use widgets to render toolbar actions
* Remove labels next to help notices and edit notices buttons
* Add a close button to the help notices and edit notices

Overview:

* ve.ui.ButtonWidget is now abstract, use ve.ui.PushButtonWidget instead
* ve.ui.IconButtonWidget now inherits from ve.ui.ButtonWidget
* ve.ui.PopupWidget's display method no longer takes x and y arguments
* Fixup naming issues in MWCategoryPopupWidget
* Fixup naming issues with some ve-init-mw CSS classes
* Rename ve-mw/ui/styles/ve.ui.Widget.css to ve.ui.MWWidget.css
* Change uses of "callout" to "tail"
* Add hyperlink functionality to buttons
* Make buttons accessible through focusing, but make unfocusable by
  clicking
* Add head option to popup for rendering a title and close button

Bug: 52386
Change-Id: Iea2c8df1be64d40f9c039873d89ee540cc56e687
2013-10-04 16:26:13 -07:00

97 lines
2 KiB
JavaScript

/*!
* VisualEditor UserInterface PopupButtonWidget class.
*
* @copyright 2011-2013 VisualEditor Team and others; see AUTHORS.txt
* @license The MIT License (MIT); see LICENSE.txt
*/
/**
* Button that shows and hides a popup.
*
* @class
* @extends ve.ui.IconButtonWidget
*
* @constructor
* @param {Object} [config] Configuration options
* @cfg {number} [width=320] Width of popup
* @cfg {number} [height] Height of popup
* @cfg {Object} [popup] Configuration to pass to popup
*/
ve.ui.PopupButtonWidget = function VeUiPopupButtonWidget( config ) {
// Configuration initialization
config = ve.extendObject( { 'width': 320 }, config );
// Parent constructor
ve.ui.IconButtonWidget.call( this, config );
// Properties
this.popup = new ve.ui.PopupWidget( ve.extendObject(
{ 'align': 'center', 'autoClose': true },
config.popup,
{ '$$': this.$$, '$autoCloseIgnore': this.$ }
) );
this.width = config.width;
this.height = config.height;
// Initialization
this.$.addClass( 've-ui-popupButtonWidget' );
this.$.append( this.popup.$ );
};
/* Inheritance */
ve.inheritClass( ve.ui.PopupButtonWidget, ve.ui.IconButtonWidget );
/* Methods */
/**
* Handles mouse click events.
*
* @method
* @param {jQuery.Event} e Mouse click event
*/
ve.ui.PopupButtonWidget.prototype.onClick = function ( e ) {
// Skip clicks within the popup
if ( $.contains( this.popup.$[0], e.target ) ) {
return;
}
if ( !this.disabled ) {
if ( this.popup.isVisible() ) {
this.hidePopup();
} else {
this.showPopup();
}
ve.ui.IconButtonWidget.prototype.onClick.call( this );
}
return false;
};
/**
* Get popup.
*
* @method
* @returns {ve.ui.PopupWidget} Popup widget
*/
ve.ui.PopupButtonWidget.prototype.getPopup = function () {
return this.popup;
};
/**
* Show popup.
*
* @method
*/
ve.ui.PopupButtonWidget.prototype.showPopup = function () {
this.popup.show().display( this.width, this.height );
};
/**
* Hide popup.
*
* @method
*/
ve.ui.PopupButtonWidget.prototype.hidePopup = function () {
this.popup.hide();
};