/* * This file is part of the MediaWiki extension MultimediaViewer. * * MultimediaViewer is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 2 of the License, or * (at your option) any later version. * * MultimediaViewer is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with MultimediaViewer. If not, see . */ ( function ( mw, $, oo ) { // Shortcut for prototype later var DP; /** * Represents a dialog and the link to open it. * * @class mw.mmv.ui.Dialog * @extends mw.mmv.ui.Element * @param {jQuery} $container the element to which the dialog will be appended * @param {jQuery} $openButton the button which opens the dialog. Only used for positioning. * @param {mw.mmv.Config} config */ function Dialog( $container, $openButton, config ) { mw.mmv.ui.Element.call( this, $container ); /** @property {mw.mmv.Config} config - */ this.config = config; this.$openButton = $openButton; this.$dialog = $( '
' ) .addClass( 'mw-mmv-dialog' ); this.$downArrow = $( '
' ) .addClass( 'mw-mmv-dialog-down-arrow' ) .appendTo( this.$dialog ); this.$dialog.appendTo( this.$container ); /** @property {boolean} Whether or not the dialog is open. */ this.isOpen = false; /** * @property {string[]} loadDependencies Dependencies to load before showing the dialog. */ this.loadDependencies = []; /** * @property {string} eventPrefix Prefix specific to the class to be applied to events. */ this.eventPrefix = ''; } oo.inheritClass( Dialog, mw.mmv.ui.Element ); DP = Dialog.prototype; /** * Handles click on link that opens/closes the dialog. * * @param {jQuery.Event} openEvent Event object for the mmv-$dialog-open event. * @param {jQuery.Event} e Event object for the click event. * @return {boolean} False to cancel the default event */ DP.handleOpenCloseClick = function ( openEvent, e ) { var dialog = this; mw.loader.using( this.loadDependencies, function () { dialog.dependenciesLoaded = true; dialog.toggleDialog( e ); }, function ( error ) { if ( window.console && window.console.error ) { window.console.error( 'mw.loader.using error when trying to load dialog dependencies', error ); } } ); return false; }; /** * Toggles the open state on the dialog. * * @param {jQuery.Event} [e] Event object when the close action is caused by a user * action, as opposed to closing the window or something. */ DP.toggleDialog = function ( e ) { if ( this.isOpen ) { this.closeDialog( e ); } else { this.openDialog(); } }; /** * Opens a dialog. */ DP.openDialog = function () { mw.mmv.actionLogger.log( this.eventPrefix + '-open' ); this.startListeningToOutsideClick(); this.$dialog.show(); this.isOpen = true; this.$openButton.addClass( 'mw-mmv-dialog-open' ); }; /** * Closes a dialog. */ DP.closeDialog = function () { if ( this.isOpen ) { mw.mmv.actionLogger.log( this.eventPrefix + '-close' ); } this.stopListeningToOutsideClick(); this.$dialog.hide(); this.isOpen = false; this.$openButton.removeClass( 'mw-mmv-dialog-open' ); }; /** * Sets up the event handler which closes the dialog when the user clicks outside. */ DP.startListeningToOutsideClick = function () { var dialog = this; this.outsideClickHandler = this.outsideClickHandler || function ( e ) { var $clickTarget = $( e.target ); // Don't close the dialog if the click inside a dialog or on an navigation arrow if ( $clickTarget.closest( dialog.$dialog ).length || $clickTarget.closest( '.mw-mmv-next-image' ).length || $clickTarget.closest( '.mw-mmv-prev-image' ).length || e.which === 3 ) { return; } dialog.closeDialog(); return false; }; $( document ).on( 'click.mmv.' + this.eventPrefix, this.outsideClickHandler ); }; /** * Removes the event handler set up by startListeningToOutsideClick(). */ DP.stopListeningToOutsideClick = function () { $( document ).off( 'click.mmv.' + this.eventPrefix, this.outsideClickHandler ); }; /** * Clears listeners. */ DP.unattach = function () { mw.mmv.ui.Element.prototype.unattach.call( this ); this.stopListeningToOutsideClick(); }; /** * @inheritdoc */ DP.empty = function () { this.closeDialog(); }; mw.mmv.ui.Dialog = Dialog; }( mediaWiki, jQuery, OO ) );