mediawiki-extensions-Multim.../resources/mmv/ui/mmv.ui.permission.js

147 lines
4 KiB
JavaScript
Raw Normal View History

/*
* This file is part of the MediaWiki extension MediaViewer.
*
* MediaViewer 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.
*
* MediaViewer 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 MediaViewer. If not, see <http://www.gnu.org/licenses/>.
*/
( function( mw, $, oo ) {
var P;
/**
* A box to display additional terms or remarks from the image author.
* (Typically comes from the Permission field of the {{Information}} template.)
* It has two states: when closed, it just shows some text, when open, it shows the HTML
* block supplied by the author in its full beauty.
* @class mw.mmv.ui.Permission
* @extends mw.mmv.ui.Element
* @constructor
* @param {jQuery} $container
*/
function Permission( $container ) {
var permission = this;
mw.mmv.ui.Element.call( this, $container );
/** @property {mw.mmv.HtmlUtils} htmlUtils - */
this.htmlUtils = new mw.mmv.HtmlUtils();
/**
* Contains everything else.
* @property {jQuery}
*/
this.$box = $( '<div>' )
.addClass( 'mw-mlb-permission-box mw-mlb-info-box empty')
.appendTo( this.$container );
/**
* Box title
* @property {jQuery}
*/
this.$title = $( '<h3>' )
.text( mw.message( 'multimediaviewer-permission-title' ).text() )
.appendTo( this.$box );
/**
* Plain-text version of the author's message
* This is just the text parsed out from the original markup, it might not make much sense
* (e.g. if the original is a HTML table)
* @property {jQuery}
*/
this.$text = $( '<div>' )
.addClass( 'mw-mlb-permission-text' )
.appendTo( this.$box )
.on( 'click', '.mw-mlb-permission-text-viewmore', function( e ) {
e.preventDefault();
permission.grow();
} )
;
/**
* A helper element to fade off text
* @property {jQuery}
*/
this.$fader = $( '<div>' )
.addClass( 'mw-mlb-permission-text-fader' )
.append(
$( '<a>' )
.addClass( 'mw-mlb-permission-text-viewmore' )
.prop( 'href', '#' )
.text( mw.message( 'multimediaviewer-permission-viewmore' ).text() )
);
/**
* Original (HTML) version of the author's message
* This can be scary sometimes (huge tables, black text on dark purple background etc).
* @property {jQuery}
*/
this.$html = $( '<div>' )
.addClass( 'mw-mlb-permission-html' )
.appendTo( this.$box );
/**
* "Close" button (does not actually close the box, just makes it smaller).
* @property {jQuery}
*/
this.$close = $( '<div>' )
.addClass( 'mw-mlb-permission-close' )
.on( 'click', function() {
permission.shrink();
} )
.appendTo( this.$box );
}
oo.inheritClass( Permission, mw.mmv.ui.Element );
P = Permission.prototype;
/**
* Clear everything
*/
P.empty = function() {
this.$box.addClass( 'empty' );
this.$text.empty();
this.$html.empty();
};
/**
* Set permission text/html
* @param {string} permission the text or HTML code written by the image author
*/
P.set = function( permission ) {
this.$box.removeClass( 'empty' );
this.$text.html( this.htmlUtils.htmlToTextWithLinks( permission ) );
this.$text.append( this.$fader );
this.$html.html( permission );
};
/**
* Enlarge the box, show HTML instead of text.
*/
P.grow = function() {
this.$box.addClass( 'full-size' )
.stop( true )
.animate( { backgroundColor: '#FFFFA0' }, 500)
.animate( { backgroundColor: '#FFFFFF' }, 500);
};
/**
* Limit the size of the box, show text only.
*/
P.shrink = function() {
this.$box.removeClass( 'full-size' );
};
mw.mmv.ui.Permission = Permission;
}( mediaWiki, jQuery, OO ) );