backlog 0.0.3 → 0.0.4

data/public/javascripts/zapatec/utils/zapatec.js

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Loads generic modules required for all widgets.
+ *
+ * <pre>
+ * Copyright (c) 2004-2006 by Zapatec, Inc.
+ * http://www.zapatec.com
+ * 1700 MLK Way, Berkeley, California,
+ * 94709, U.S.A.
+ * All rights reserved.
+ * </pre>
+ */
+
+/* $Id: zapatec.js 4908 2006-10-25 15:19:32Z alex $ */
+
+if (typeof Zapatec == 'undefined') {
+  /**
+   * Namespace definition.
+   * @constructor
+   */
+  Zapatec = function() {};
+}
+
+/**
+ * Zapatec Suite version.
+ * @private
+ */
+Zapatec.version = '2.1';
+
+/**
+ * Path to main Zapatec script.
+ * @private
+ */
+Zapatec.zapatecPath = function() {
+  // Get all script elements
+  var arrScripts = document.getElementsByTagName('script');
+  // Find the script in the list
+  for (var iScript = arrScripts.length - 1; iScript >= 0; iScript--) {
+    var strSrc = arrScripts[iScript].getAttribute('src');
+    if (!strSrc) {
+      continue;
+    }
+    var arrTokens = strSrc.split('/');
+    // Remove last token
+    var strLastToken;
+    if (Array.prototype.pop) {
+      strLastToken = arrTokens.pop();
+    } else {
+      // IE 5
+      strLastToken = arrTokens[arrTokens.length - 1];
+      arrTokens.length -= 1;
+    }
+    if (strLastToken.indexOf('zapatec.js') == 0) {
+      return arrTokens.length ? arrTokens.join('/') + '/' : '';
+    }
+  }
+  // Not found
+  return '';
+} ();
+
+// For backward compatibility
+if (Zapatec.version == '2.1.comp') {
+  Zapatec.zapatecPath = Zapatec.zapatecPath.replace(/utils\/$/, '../utils/');
+}
+
+/**
+ * Simply writes script tag to the document.
+ *
+ * <pre>
+ * If special Zapatec.doNotInclude flag is set, this function does nothing.
+ * </pre>
+ *
+ * @private
+ * @param {string} strSrc Src attribute value of the script element
+ * @param {string} strId Optional. Id of the script element
+ */
+Zapatec.include = function(strSrc, strId) {
+  // Check flag
+  if (Zapatec.doNotInclude) {
+    return;
+  }
+  // Include file
+  document.write('<script type="text/javascript" src="' + 
+   strSrc + (typeof strId == 'string' ? '" id="' + strId : '') + '"></script>');
+};
+
+// Include required scripts
+Zapatec.include(Zapatec.zapatecPath + 'utils.js', 'Zapatec.Utils');
+Zapatec.include(Zapatec.zapatecPath + 'zpeventdriven.js', 'Zapatec.EventDriven');
+Zapatec.include(Zapatec.zapatecPath + 'transport.js', 'Zapatec.Transport');
+Zapatec.include(Zapatec.zapatecPath + 'zpwidget.js', 'Zapatec.Widget');

data/public/javascripts/zapatec/utils/zpeventdriven.js

@@ -0,0 +1,212 @@
+// $Id: zpeventdriven.js 4322 2006-09-04 08:49:33Z shacka $
+/**
+ * @fileoverview Zapatec EventDriven library. Base EventDriven class. Contains
+ * functions to handle events and basic methods for event-driven class.
+ *
+ * <pre>
+ * Copyright (c) 2004-2006 by Zapatec, Inc.
+ * http://www.zapatec.com
+ * 1700 MLK Way, Berkeley, California,
+ * 94709, U.S.A.
+ * All rights reserved.
+ * </pre>
+ */
+
+if (typeof Zapatec == 'undefined') {
+  /**
+   * @ignore Namespace definition.
+   */
+  Zapatec = {};
+}
+
+/**
+ * Base event-driven class.
+ *
+ * @constructor
+ */
+Zapatec.EventDriven = function() {};
+
+/**
+ * Initializes object.
+ */
+Zapatec.EventDriven.prototype.init = function() {
+  // Holds events of this object
+  this.events = {};
+};
+
+/**
+ * Adds event listener.
+ *
+ * @param {string} strEvent Event name
+ * @param {function} funcListener Event listener
+ * @param {function} first If true funcListener will be put as the first one
+ */
+Zapatec.EventDriven.prototype.
+ addEventListener = function(strEvent, funcListener, first) {
+  if (typeof funcListener != "function") {
+    return false;
+  }
+  if (!this.events[strEvent]) {
+    this.events[strEvent] = {
+      listeners: []
+    };
+  }
+  if (!first) {
+    this.events[strEvent].listeners.push(funcListener);
+  } else {
+    this.events[strEvent].listeners.unshift(funcListener);
+  }
+};
+
+/**
+ * Removes event listener.
+ *
+ * @param {string} strEvent Event name
+ * @param {function} funcListener Event listener
+ */
+Zapatec.EventDriven.prototype.
+ removeEventListener = function(strEvent, funcListener) {
+  if (!this.events[strEvent]) {
+    return;
+  }
+  var arrListeners = this.events[strEvent].listeners;
+  for (var iListener = 0; iListener < arrListeners.length; iListener++) {
+    if (arrListeners[iListener] == funcListener) {
+      arrListeners.splice(iListener, 1);
+      return;
+    }
+  }
+};
+
+/**
+ * Checks if the event exists.
+ *
+ * @param {string} strEvent Event name
+ * @return Exists
+ * @type boolean
+ */
+Zapatec.EventDriven.prototype.isEvent = function(strEvent) {
+  if (this.events[strEvent]) {
+    return true;
+  }
+  return false;
+};
+
+/**
+ * Removes all listeners for the event.
+ *
+ * @param {string} strEvent Event name
+ */
+Zapatec.EventDriven.prototype.removeEvent = function(strEvent) {
+  if (this.events[strEvent]) {
+    var undef;
+    this.events[strEvent] = undef;
+  }
+};
+
+/**
+ * Fires event. Takes in one mandatory argument strEvent and optionally
+ * any number of other arguments that should be passed to the listeners.
+ *
+ * @param {string} strEvent Event name
+ */
+Zapatec.EventDriven.prototype.fireEvent = function(strEvent) {
+  if (!this.events[strEvent]) {
+    return;
+  }
+  var arrListeners = this.events[strEvent].listeners;
+  for (var iListener = 0; iListener < arrListeners.length; iListener++) {
+    // Remove first argument
+    var arrArgs = [].slice.call(arguments, 1);
+    // Call in scope of this object
+    arrListeners[iListener].apply(this, arrArgs);
+  }
+};
+
+/**
+ * Holds static events.
+ * @private
+ */
+Zapatec.EventDriven.events = {};
+
+/**
+ * Adds event listener to static event.
+ *
+ * @param {string} strEvent Event name
+ * @param {function} funcListener Event listener
+ */
+Zapatec.EventDriven.addEventListener = function(strEvent, funcListener) {
+  if (typeof funcListener != "function") {
+    return false;
+  }
+  if (!Zapatec.EventDriven.events[strEvent]) {
+    Zapatec.EventDriven.events[strEvent] = {
+      listeners: []
+    };
+  }
+  Zapatec.EventDriven.events[strEvent].listeners.push(funcListener);
+};
+
+/**
+ * Removes event listener from static event.
+ *
+ * @param {string} strEvent Event name
+ * @param {function} funcListener Event listener
+ */
+Zapatec.EventDriven.removeEventListener = function(strEvent, funcListener) {
+  if (!Zapatec.EventDriven.events[strEvent]) {
+    return;
+  }
+  var arrListeners = Zapatec.EventDriven.events[strEvent].listeners;
+  for (var iListener = 0; iListener < arrListeners.length; iListener++) {
+    if (arrListeners[iListener] == funcListener) {
+      arrListeners.splice(iListener, 1);
+      return;
+    }
+  }
+};
+
+/**
+ * Checks if the static event exists.
+ *
+ * @param {string} strEvent Event name
+ * @return Exists
+ * @type boolean
+ */
+Zapatec.EventDriven.isEvent = function(strEvent) {
+  if (Zapatec.EventDriven.events[strEvent]) {
+    return true;
+  }
+  return false;
+};
+
+/**
+ * Removes all listeners for the static event.
+ *
+ * @param {string} strEvent Event name
+ */
+Zapatec.EventDriven.removeEvent = function(strEvent) {
+  if (Zapatec.EventDriven.events[strEvent]) {
+    var undef;
+    Zapatec.EventDriven.events[strEvent] = undef;
+  }
+};
+
+/**
+ * Fires static event. Takes in one mandatory argument strEvent and optionally
+ * any number of other arguments that should be passed to the listeners.
+ *
+ * @param {string} strEvent Event name
+ */
+Zapatec.EventDriven.fireEvent = function(strEvent) {
+  if (!Zapatec.EventDriven.events[strEvent]) {
+    return;
+  }
+  var arrListeners = Zapatec.EventDriven.events[strEvent].listeners;
+  for (var iListener = 0; iListener < arrListeners.length; iListener++) {
+    // Remove first argument
+    var arrArgs = [].slice.call(arguments, 1);
+    // Call listener
+    arrListeners[iListener].apply(arrListeners[iListener], arrArgs);
+  }
+};

data/public/javascripts/zapatec/utils/zpwidget.js

@@ -0,0 +1,729 @@
+/**
+ * @fileoverview Zapatec Widget library. Base Widget class.
+ *
+ * <pre>
+ * Copyright (c) 2004-2006 by Zapatec, Inc.
+ * http://www.zapatec.com
+ * 1700 MLK Way, Berkeley, California,
+ * 94709, U.S.A.
+ * All rights reserved.
+ * </pre>
+ */
+
+/* $Id: zpwidget.js 4907 2006-10-25 15:09:26Z andrew $ */
+
+if (typeof Zapatec == 'undefined') {
+  /**
+   * @ignore Namespace definition.
+   */
+  Zapatec = {};
+}
+
+/**
+ * Base widget class.
+ *
+ * <pre>
+ * Defines following config options:
+ *
+ * <b>theme</b> [string] Theme name that will be used to display the widget.
+ * Corresponding CSS file will be picked and added into the HTML document
+ * automatically. Case insensitive. Default: "default".
+ * May also contain relative or absolute URL of themes directory.
+ * E.g. "../themes/default.css" or "http://my.web.host/themes/default.css".
+ *
+ * <b>themePath</b> [string] Relative or absolute URL to themes directory.
+ * Trailing slash is required. Default: path to child widget's file +
+ * "../themes/". You may also include path into "theme" option instead of using
+ * "themePath" option.
+ *
+ * <b>asyncTheme</b> [boolean] Load theme asynchronously. This means that script
+ * execution will not be suspended until theme is loaded. Theme will be applied
+ * once it is loaded. Default: false.
+ *
+ * <b>source</b> Depends on "sourceType" option. Possible sources:
+ * -----------------------------------------------------------------------------
+ * sourceType     | source
+ * ---------------|-------------------------------------------------------------
+ * 1) "html"      | [object or string] HTMLElement or its id.
+ * 2) "html/text" | [string] HTML fragment.
+ * 3) "html/url"  | [string] URL of HTML fragment.
+ * 4) "json"      | [object or string] JSON object or string (http://json.org).
+ * 5) "json/url"  | [string] URL of JSON data source.
+ * 6) "xml"       | [object or string] XMLDocument object or XML string.
+ * 7) "xml/url"   | [string] URL of XML data source.
+ * -----------------------------------------------------------------------------
+ *
+ * <b>sourceType</b> [string] Used together with "source" option to specify how
+ * source should be processed. Possible source types:
+ * "html", "html/text", "html/url", "json", "json/url", "xml", "xml/url".
+ * JSON format is described at http://www.json.org.
+ *
+ * <b>callbackSource</b> [function] May be used instead of "source" and
+ * "sourceType" config options to get source depending on passed arguments.
+ * Receives object with passed arguments. Must return following object:
+ * {
+ *   source: [object or string] see table above for possible sources,
+ *   sourceType: [string] see table above for possible source types
+ * }
+ *
+ * <b>asyncSource</b> [boolean] Load source asynchronously. This means that
+ * script execution will not be suspended until source is loaded. Source will be
+ * processed once it is loaded. Default: true.
+ *
+ * <b>reliableSource</b> [boolean] Used together with "json" or "json/url"
+ * sourceType to skip JSON format verification. It saves a lot of time for large
+ * data sets. Default: true.
+ *
+ * <b>eventListeners</b> [object] Associative array with event listeners:
+ * {
+ *   [string] event name: [function] event listener,
+ *   ...
+ * }
+ * </pre>
+ *
+ * @constructor
+ * @extends Zapatec.EventDriven
+ * @param {object} objArgs User configuration
+ */
+Zapatec.Widget = function(objArgs) {
+  // User configuration
+  this.config = {};
+  // Call constructor of superclass
+  Zapatec.Widget.SUPERconstructor.call(this);
+  // Initialize object
+  this.init(objArgs);
+};
+
+// Inherit EventDriven
+Zapatec.inherit(Zapatec.Widget, Zapatec.EventDriven);
+
+/**
+ * @private Holds path to this file.
+ */
+Zapatec.Widget.path = Zapatec.getPath('Zapatec.Widget');
+
+/**
+ * Initializes object.
+ *
+ * <pre>
+ * Important: Before calling this method, define config options for the widget.
+ * Initially "this.config" object should contain all config options with their
+ * default values. Then values of config options will be changed with user
+ * configuration in this method. Config options provided by user that were not
+ * found in "this.config" object will be ignored.
+ * </pre>
+ *
+ * @param {object} objArgs User configuration
+ */
+Zapatec.Widget.prototype.init = function(objArgs) {
+  // Call parent method
+  Zapatec.Widget.SUPERclass.init.call(this);
+  // Add this widget to the list
+  if (typeof this.id == 'undefined') {
+    this.id = Zapatec.Widget.all.length;
+    Zapatec.Widget.all.push(this);
+  }
+  // Configure
+  this.configure(objArgs);
+  // Add custom event listeners
+  this.addUserEventListeners();
+  // Add standard event listeners
+  this.addStandardEventListeners();
+  // Load theme
+  this.loadTheme();
+};
+
+/**
+ * Reconfigures the widget with new config options after it was initialized.
+ * May be used to change look or behavior of the widget after it has loaded
+ * the data. In the argument pass only values for changed config options.
+ * There is no need to pass config options that were not changed.
+ *
+ * <pre>
+ * Note: "eventListeners" config option is ignored by this method because it is
+ * useful only on initialization. To add event listener after the widget was
+ * initialized, use addEventListener method instead.
+ * </pre>
+ *
+ * @param {object} objArgs Changes to user configuration
+ */
+Zapatec.Widget.prototype.reconfigure = function(objArgs) {
+  // Configure
+  this.configure(objArgs);
+  // Load theme
+  this.loadTheme();
+};
+
+/**
+ * Configures widget.
+ *
+ * @param {object} objArgs User configuration
+ */
+Zapatec.Widget.prototype.configure = function(objArgs) {
+  // Default configuration
+  this.defineConfigOption('theme', 'default');
+  if (typeof this.constructor.path != 'undefined') {
+    this.defineConfigOption('themePath', this.constructor.path + '../themes/');
+  } else {
+    this.defineConfigOption('themePath', '../themes/');
+  }
+  this.defineConfigOption('asyncTheme', false);
+  this.defineConfigOption('source');
+  this.defineConfigOption('sourceType');
+  this.defineConfigOption('callbackSource');
+  this.defineConfigOption('asyncSource', true);
+  this.defineConfigOption('reliableSource', true);
+  this.defineConfigOption('eventListeners', {});
+  // Get user configuration
+  if (objArgs) {
+    for (var strOption in objArgs) {
+      if (typeof this.config[strOption] != 'undefined') {
+        this.config[strOption] = objArgs[strOption];
+      } else {
+        Zapatec.Log({
+          description: "Unknown config option: " + strOption
+        });
+      }
+    }
+  }
+};
+
+/**
+ * Returns current configuration of the widget.
+ *
+ * @return Current configuration
+ * @type object
+ */
+Zapatec.Widget.prototype.getConfiguration = function() {
+  return this.config;
+};
+
+/**
+ * @private Array to access any widget on the page by its id number.
+ */
+Zapatec.Widget.all = [];
+
+/**
+ * Finds a widget by id.
+ *
+ * @param {number} Widget id
+ * @return Widget or undefined if not found
+ * @type object
+ */
+Zapatec.Widget.getWidgetById = function(iId) {
+  return Zapatec.Widget.all[iId];
+};
+
+/**
+ * @private Defines config option if it is not defined yet. Sets default value
+ * of new config option. If default value is not specified, it is set to null.
+ *
+ * @param {string} strOption Config option name
+ * @param {any} val Optional. Config option default value
+ */
+Zapatec.Widget.prototype.defineConfigOption = function(strOption, val) {
+  if (typeof this.config[strOption] == 'undefined') {
+    if (typeof val == 'undefined') {
+      this.config[strOption] = null;
+    } else {
+      this.config[strOption] = val;
+    }
+  }
+};
+
+/**
+ * Adds custom event listeners.
+ */
+Zapatec.Widget.prototype.addUserEventListeners = function() {
+  for (var strEvent in this.config.eventListeners) {
+    if (this.config.eventListeners.hasOwnProperty(strEvent)) {
+      this.addEventListener(strEvent, this.config.eventListeners[strEvent]);
+    }
+  }
+};
+
+/**
+ * Adds standard event listeners.
+ */
+Zapatec.Widget.prototype.addStandardEventListeners = function() {
+  this.addEventListener('loadThemeError', Zapatec.Widget.loadThemeError);
+};
+
+/**
+ * Displays the reason why the theme was not loaded.
+ * @private
+ */
+Zapatec.Widget.loadThemeError = function(objError) {
+  var strDescription = "Can't load theme.";
+  if (objError && objError.errorDescription) {
+    strDescription += ' ' + objError.errorDescription;
+  }
+  Zapatec.Log({
+    description: strDescription
+  });
+};
+
+/**
+ * Loads specified theme.
+ */
+Zapatec.Widget.prototype.loadTheme = function() {
+	// Correct theme config option
+	if (typeof this.config.theme == 'string' && this.config.theme.length) {
+		// Remove path
+		var iPos = this.config.theme.lastIndexOf('/');
+		if (iPos >= 0) {
+			iPos++; // Go to first char of theme name
+			this.config.themePath = this.config.theme.substring(0, iPos);
+			this.config.theme = this.config.theme.substring(iPos);
+		}
+		// Remove file extension
+		iPos = this.config.theme.lastIndexOf('.');
+		if (iPos >= 0) {
+			this.config.theme = this.config.theme.substring(0, iPos);
+		}
+		// Make lower case
+		this.config.theme = this.config.theme.toLowerCase();
+	} else {
+		this.config.theme = '';
+	}
+	// Load theme
+	if(this.config.theme){
+    this.fireEvent('loadThemeStart');
+		this.themeLoaded = false;
+		var objWidget = this;
+		var strUrl = this.config.themePath + this.config.theme + '.css';
+		Zapatec.Transport.loadCss({
+			// URL of theme file
+			url: strUrl,
+			// Suspend script execution until theme is loaded or error received
+			async: this.config.asyncTheme,
+			// Onload event handler
+			onLoad: function() {
+        objWidget.fireEvent('loadThemeEnd');
+				objWidget.themeLoaded = true;
+				objWidget.hideLoader();
+			},
+			onError: function(objError) {
+        objWidget.fireEvent('loadThemeEnd');
+        objWidget.fireEvent('loadThemeError', objError);
+				objWidget.themeLoaded = true;
+				objWidget.hideLoader();
+			}
+		});
+	}
+}
+/**
+ * Forms class name from theme name and provided prefix and suffix.
+ *
+ * <pre>
+ * Arguments object format:
+ * {
+ *   prefix: [string, optional] prefix,
+ *   suffix: [string, optional] suffix
+ * }
+ * E.g. if this.config.theme == 'default' and following object provided
+ * {
+ *   prefix: 'zpWidget',
+ *   suffix: 'Container'
+ * },
+ * class name will be 'zpWidgetDefaultContainer'.
+ * </pre>
+ *
+ * @param objArgs [object] Arguments object
+ * @return Class name
+ * @type string
+ */
+Zapatec.Widget.prototype.getClassName = function(objArgs) {
+  var arrClassName = [];
+  if (objArgs && objArgs.prefix) {
+    arrClassName.push(objArgs.prefix);
+  }
+  if (this.config.theme != '') {
+    arrClassName.push(this.config.theme.charAt(0).toUpperCase());
+    arrClassName.push(this.config.theme.substr(1));
+  }
+  if (objArgs && objArgs.suffix) {
+    arrClassName.push(objArgs.suffix);
+  }
+  return arrClassName.join('');
+};
+
+/**
+ * @private if theme for current widget is not loaded yet - this method will
+ * hide widget container and show progress bar instead of it.
+ */
+Zapatec.Widget.prototype.showLoader = function(message){
+	if(this.container != null && this.config.theme && !this.themeLoaded){
+		// if window content is not fulle loaded - progress bar can resize
+		// incorrectly
+		if(!Zapatec.windowLoaded){
+			var self = this;
+			Zapatec.Utils.addEvent(window, "load", function(){self.showLoader(message)});
+			return null;
+		}
+
+		if(typeof(Zapatec.Progress) == 'undefined'){
+			var self = this;
+
+			Zapatec.Transport.loadJS({
+				module: 'progress',
+				onLoad: function() {
+					// if theme is already loaded - do not show progress bar
+					if(self.themeLoaded){
+						return null;
+					}
+
+					self.showLoader(message);
+				}
+			});
+
+			return null;
+		}
+
+		this.loader = new Zapatec.Progress({
+			container: this.container,
+			themePath: Zapatec.zapatecPath + "../zpextra/themes/progress/"
+		});
+
+		this.loader.start(message || 'loading');
+		this.container.style.visibility = 'hidden';
+	}
+}
+
+/**
+ * @private Hides progressbar created using #showLoader and shows widget.
+ * This method will be called automatically on theme loading.
+ */
+Zapatec.Widget.prototype.hideLoader = function(){
+	if(this.loader && this.loader.isActive()){
+		this.container.style.visibility = '';
+		this.loader.stop();
+	}
+}
+
+/**
+ * Shows widget using given effects and animation speed. You need to define
+ * this.container to use this method.
+ * @param {object} effects list of effects to apply
+ * @param {number} animSpeed possible values - 1..100. Bigger value - more fast animation.
+ * @param {function} onFinish Function to call on effect end.
+ */
+Zapatec.Widget.prototype.showContainer = function(effects, animSpeed, onFinish){
+	return this.showHideContainer(effects, animSpeed, onFinish, true);
+}
+
+/**
+ * Hides widget using given effects and animation speed. You need to define
+ * this.container to use this method.
+ * @param {object} effects list of effects to apply
+ * @param {number} animSpeed possible values - 1..100. Bigger value - more fast animation.
+ */
+Zapatec.Widget.prototype.hideContainer = function(effects, animSpeed, onFinish){
+	return this.showHideContainer(effects, animSpeed, onFinish, false);
+}
+
+/**
+ * Show/hides widget using given effects and animation speed. You need to define
+ * this.container to use this method.
+ * @param {object} effects list of effects to apply
+ * @param {number} animSpeed possible values - 1..100. Bigger value - more fast animation.
+ * @param {boolean} show if true - show widget. Otherwise - hide.
+ */
+Zapatec.Widget.prototype.showHideContainer = function(effects, animSpeed, onFinish, show){
+	if(this.container == null){
+		return null;
+	}
+
+	if(typeof(Zapatec.Effects) == 'undefined'){
+		var self = this;
+
+		Zapatec.Transport.loadJS({
+			url: Zapatec.Widget.path + '../../zpeffects/src/effects.js',
+			onLoad: function() {
+				self.showHideContainer(effects, animSpeed, onFinish, show);
+			}
+		});
+
+		return false;
+	}
+
+	if(animSpeed == null && isNaN(parseInt(animSpeed))){
+		animSpeed = 5;
+	}
+
+	if(effects == null || effects.length == 0){
+		if(show){
+			this.container.style.display = this.originalContainerDisplay;
+			this.originalContainerDisplay = null;
+		} else {
+			this.originalContainerDisplay = this.container.style.display;
+			this.container.style.display = 'none';
+		}
+
+		if (onFinish) {
+			onFinish();
+		}
+	} else {
+		if(show){
+			Zapatec.Effects.show(this.container, animSpeed, effects, onFinish);
+		} else {
+			Zapatec.Effects.hide(this.container, animSpeed, effects, onFinish);
+		}
+	}
+
+	return true;
+}
+
+/**
+ * Loads data from the specified source.
+ *
+ * <pre>
+ * If source is URL, fires following events:
+ * <ul>
+ * <li><i>fetchSourceStart</i> when Zapatec.Transport#fetch is called</li>
+ * <li><i>fetchSourceEnd</i> when Zapatec.Transport#fetch returns result or
+ *  error</li>
+ * <li><i>fetchSourceError</i> when Zapatec.Transport#fetch returns error.
+ *  fetchSourceError event listener receives object returned by
+ *  Zapatec.Transport#fetch</li>
+ * </ul>
+ *
+ * Fires following events:
+ * <ul>
+ * <li><i>loadDataStart</i> when data parsing is started</li>
+ * <li><i>loadDataEnd</i> when data parsing is ended or error occured during
+ *  fetch</li>
+ * </ul>
+ * </pre>
+ *
+ * @param {object} objArgs Arguments object passed to callbackSource function
+ */
+Zapatec.Widget.prototype.loadData = function(objArgs) {
+  // Get source using callback function
+  if (typeof this.config.callbackSource == 'function') {
+    var objSource = this.config.callbackSource(objArgs);
+    if (objSource) {
+      if (typeof objSource.source != 'undefined') {
+        this.config.source = objSource.source;
+      }
+      if (typeof objSource.sourceType != 'undefined') {
+        this.config.sourceType = objSource.sourceType;
+      }
+    }
+  }
+  // Process source
+  if (this.config.source != null && this.config.sourceType != null) {
+    var strSourceType = this.config.sourceType.toLowerCase();
+    if (strSourceType == 'html') {
+      this.fireEvent('loadDataStart');
+      this.loadDataHtml(Zapatec.Widget.getElementById(this.config.source));
+      this.fireEvent('loadDataEnd');
+    } else if (strSourceType == 'html/text') {
+      this.fireEvent('loadDataStart');
+      this.loadDataHtmlText(this.config.source);
+      this.fireEvent('loadDataEnd');
+    } else if (strSourceType == 'html/url') {
+      this.fireEvent('fetchSourceStart');
+      // Fetch source
+      var objWidget = this;
+      Zapatec.Transport.fetch({
+        // URL of the source
+        url: this.config.source,
+        // Suspend script execution until source is loaded or error received
+        async: this.config.asyncSource,
+        // Onload event handler
+        onLoad: function(objRequest) {
+          objWidget.fireEvent('fetchSourceEnd');
+          objWidget.fireEvent('loadDataStart');
+          objWidget.loadDataHtmlText(objRequest.responseText);
+          objWidget.fireEvent('loadDataEnd');
+        },
+        // Onerror event handler
+        onError: function(objError) {
+          objWidget.fireEvent('fetchSourceEnd');
+          objWidget.fireEvent('loadDataEnd');
+          objWidget.fireEvent('fetchSourceError', objError);
+        }
+      });
+    } else if (strSourceType == 'json') {
+      this.fireEvent('loadDataStart');
+      if (typeof this.config.source == 'object') {
+        this.loadDataJson(this.config.source);
+      } else if (this.config.reliableSource) {
+        this.loadDataJson(eval(this.config.source));
+      } else {
+        this.loadDataJson(Zapatec.Transport.parseJson({
+          strJson: this.config.source
+        }));
+      }
+      this.fireEvent('loadDataEnd');
+    } else if (strSourceType == 'json/url') {
+      this.fireEvent('fetchSourceStart');
+      // Fetch source
+      var objWidget = this;
+      Zapatec.Transport.fetchJsonObj({
+        // URL of the source
+        url: this.config.source,
+        // Suspend script execution until source is loaded or error received
+        async: this.config.asyncSource,
+        // Skip JSON format verification
+        reliable: this.config.reliableSource,
+        // Onload event handler
+        onLoad: function(objResult) {
+          objWidget.fireEvent('fetchSourceEnd');
+          objWidget.fireEvent('loadDataStart');
+          objWidget.loadDataJson(objResult);
+          objWidget.fireEvent('loadDataEnd');
+        },
+        // Onerror event handler
+        onError: function(objError) {
+          objWidget.fireEvent('fetchSourceEnd');
+          objWidget.fireEvent('loadDataEnd');
+          objWidget.fireEvent('fetchSourceError', objError);
+        }
+      });
+    } else if (strSourceType == 'xml') {
+      this.fireEvent('loadDataStart');
+      if (typeof this.config.source == 'object') {
+        this.loadDataXml(this.config.source);
+      } else {
+        this.loadDataXml(Zapatec.Transport.parseXml({
+          strXml: this.config.source
+        }));
+      }
+      this.fireEvent('loadDataEnd');
+    } else if (strSourceType == 'xml/url') {
+      this.fireEvent('fetchSourceStart');
+      // Fetch source
+      var objWidget = this;
+      Zapatec.Transport.fetchXmlDoc({
+        // URL of the source
+        url: this.config.source,
+        // Suspend script execution until source is loaded or error received
+        async: this.config.asyncSource,
+        // Onload event handler
+        onLoad: function(objResult) {
+          objWidget.fireEvent('fetchSourceEnd');
+          objWidget.fireEvent('loadDataStart');
+          objWidget.loadDataXml(objResult);
+          objWidget.fireEvent('loadDataEnd');
+        },
+        // Onerror event handler
+        onError: function(objError) {
+          objWidget.fireEvent('fetchSourceEnd');
+          objWidget.fireEvent('loadDataEnd');
+          objWidget.fireEvent('fetchSourceError', objError);
+        }
+      });
+    }
+  } else {
+    this.fireEvent('loadDataStart');
+    this.loadDataHtml(Zapatec.Widget.getElementById(this.config.source));
+    this.fireEvent('loadDataEnd');
+  }
+};
+
+/**
+ * Loads data from the HTML source. Override this in child class.
+ *
+ * @param {object} objSource Source HTMLElement object
+ */
+Zapatec.Widget.prototype.loadDataHtml = function(objSource) {};
+
+/**
+ * Loads data from the HTML fragment source.
+ *
+ * @param {string} strSource Source HTML fragment
+ */
+Zapatec.Widget.prototype.loadDataHtmlText = function(strSource) {
+  // Parse HTML fragment
+  var objTempContainer = Zapatec.Transport.parseHtml(strSource);
+  // Load data
+  this.loadDataHtml(objTempContainer.firstChild);
+};
+
+/**
+ * Loads data from the JSON source. Override this in child class.
+ *
+ * @param {object} objSource Source JSON object
+ */
+Zapatec.Widget.prototype.loadDataJson = function(objSource) {};
+
+/**
+ * Loads data from the XML source. Override this in child class.
+ *
+ * @param {object} objSource Source XMLDocument object
+ */
+Zapatec.Widget.prototype.loadDataXml = function(objSource) {
+};
+
+/**
+ * Finds a widget by id and calls specified method with specified arguments and
+ * returns value from the method.
+ *
+ * @param {number} iWidgetId Widget id
+ * @param {string} strMethod Method name
+ * @param {any} any Any number of arguments
+ * @return Value returned from the method
+ * @type any
+ */
+Zapatec.Widget.callMethod = function(iWidgetId, strMethod) {
+  // Get Widget object
+  var objWidget = Zapatec.Widget.getWidgetById(iWidgetId);
+  if (objWidget && typeof objWidget[strMethod] == 'function') {
+    // Remove first two arguments
+    var arrArgs = [].slice.call(arguments, 2);
+    // Call method
+    return objWidget[strMethod].apply(objWidget, arrArgs);
+  }
+};
+
+/**
+ * Converts element id to reference.
+ *
+ * @param {string} element Element id
+ * @return Reference to element
+ * @type object
+ */
+Zapatec.Widget.getElementById = function(element) {
+  if (typeof element == 'string') {
+    return document.getElementById(element);
+  }
+  return element;
+};
+
+/**
+ * Returns style attribute of the specified element.
+ *
+ * @param {object} element Element
+ * @return Style attribute value
+ * @type string
+ */
+Zapatec.Widget.getStyle = function(element) {
+  var style = element.getAttribute('style') || '';
+  if (typeof style == 'string') {
+    return style;
+  }
+  return style.cssText;
+};
+
+/**
+ * Emulates "window.event" for certain events in Mozilla. To be able to access
+ * Event object when event handler is set using element attribute, e.g.
+ * &lt;a onclick="eventHandler()"&gt;.
+ *
+ * @param {object} arrEventNames array of event names where "window.event" is
+ * needed, e.g. ['click', 'dblclick'].
+ */
+Zapatec.Widget.emulateWindowEvent = function(arrEventNames) {
+  if (document.addEventListener) {
+    // Set up emulation for certain events
+    for (var iEvent = 0; iEvent < arrEventNames.length; iEvent++) {
+      document.addEventListener(arrEventNames[iEvent], function (objEvent) {
+        if (objEvent) {
+          window.event = objEvent;
+        }
+      }, true);
+    }
+  }
+};