mediawiki-extensions-VisualEditor/modules/ve/ui/elements/ve.ui.IconedElement.js

/*!
 * VisualEditor UserInterface IconedElement class.
 *
 * @copyright 2011-2013 VisualEditor Team and others; see AUTHORS.txt
 * @license The MIT License (MIT); see LICENSE.txt
 */

/**
 * Iconed element.
 *
 * @class
 * @abstract
 *
 * @constructor
 * @param {jQuery} $icon Icon element
 * @param {Object} [config] Config options
 * @cfg {Object|string} [icon=''] Symbolic icon name, or map of icon names keyed by language ID
 */
ve.ui.IconedElement = function VeUiIconedElement( $icon, config ) {
	// Config intialization
	config = config || {};

	// Properties
	this.$icon = $icon;
	this.icon = null;

	// Initialization
	this.$icon.addClass( 've-ui-iconedElement-icon' );
	this.setIcon( config.icon );
};

/* Methods */

/**
 * Set the icon.
 *
 * @method
 * @param {string} [value] Symbolic name of icon to use
 * @chainable
 */
ve.ui.IconedElement.prototype.setIcon = function ( value ) {
	var i, len, icon, lang,
		langs = ve.init.platform.getUserLanguages();

	if ( ve.isPlainObject( value ) ) {
		icon = value['default'];
		for ( i = 0, len = langs.length; i < len; i++ ) {
			lang = langs[i];
			if ( value[lang] ) {
				icon = value[lang];
				break;
			}
		}
	} else {
		icon = value;
	}

	if ( this.icon ) {
		this.$icon.removeClass( 've-ui-icon-' + this.icon );
	}
	if ( typeof icon === 'string' ) {
		icon = icon.trim();
		if ( icon.length ) {
			this.$icon.addClass( 've-ui-icon-' + icon );
			this.icon = icon;
		}
	}
	return this;
};