Add WoltLab/WCF/Language

[GitHub/WoltLab/WCF.git] / wcfsetup / install / files / js / WoltLab / WCF / Language.js

/**
 * Manages language items.
 * 
 * @author	Tim Duesterhus
 * @copyright	2001-2015 WoltLab GmbH
 * @license	GNU Lesser General Public License <http://opensource.org/licenses/lgpl-license.php>
 * @module	WoltLab/WCF/Language
 */
define(['Dictionary'], function(Dictionary) {
	"use strict";
	
	var languageItems = new Dictionary();
	
	/**
	 * @constructor
	 */
	function Language() { };
	Language.prototype = {
		/**
		 * Adds all the language items in the given object to the store.
		 * 
		 * @param	{Object.<string, string>}	object
		 */
		addObject: function (object) {
			languageItems.merge(Dictionary.fromObject(object));
		},
		
		/**
		 * Adds a single language item to the store.
		 * 
		 * @param	{string}	key
		 * @param	{string}	value
		 */
		add: function(key, value) {
			languageItems.set(key, value);
		},
		
		/**
		 * Fetches the language item specified by the given key.
		 * If the language item is a string it will be evaluated as
		 * WCF.Template with the given parameters.
		 * 
		 * @param	{string}	key		Language item to return.
		 * @param	{Object=}	parameters	Parameters to provide to WCF.Template.
		 * @return	{string}
		 */
		get: function(key, parameters) {
			if (!parameters) parameters = { };
			
			var value = languageItems.get(key);
			
			if (value === undefined) {
				console.warn("Trying to get() undefined language item.");
				return key;
			}
			
			if (typeof value === 'string') {
				// lazily convert to WCF.Template
				languageItems.set(key, new WCF.Template(value));
				value = languageItems.get(key);
			}
			
			if (value instanceof WCF.Template) {
				value = value.fetch(parameters);
			}
			
			return value;
		}
	};
	
	return new Language();
});