mediawiki-extensions-Multim.../resources/mmv/ui/mmv.ui.permission.js
Gergő Tisza d85e7bf32e Utilities to transform HTML to plain or filtered text
This takes care of several minor annoyances:
* centralizes all the text processing functions which have been
  floating all around the code, and adds proper tests
* filters out invisible elements (sometimes used for metadata)
* avoids merging separate words on HTML->text transformation
* adds caching since doing all this transformations could be
  processing-intensive for big chunks of HTML. (This might or
  might not be a good idea. I haven't done performance tests, so
  this might be premature optimization, and increases memory use.
  OTOH these functions are often called in situations where an
  immediate UI response is expected (such as selecting a size
  from the list) so even small delays would be perceivable.

Bug: 63126
Change-Id: I1ef1e3a33efdfea17612df00da6b629bf39e07aa
Mingle: https://wikimedia.mingle.thoughtworks.com/projects/multimedia/cards/388
Mingle: https://wikimedia.mingle.thoughtworks.com/projects/multimedia/cards/369
2014-03-27 19:11:09 +00:00

147 lines
4 KiB
JavaScript

/*
* 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 ) );