jquery-ui/ui/ui.progressbar.js

/*
 * jQuery UI Progressbar @VERSION
 *
 * Copyright (c) 2008 Eduardo Lundgren
 * Dual licensed under the MIT (MIT-LICENSE.txt)
 * and GPL (GPL-LICENSE.txt) licenses.
 *
 * http://docs.jquery.com/UI/Progressbar
 *
 * Depends:
 *   ui.core.js
 */
(function($) {

$.widget("ui.progressbar", {
	_init: function() {
		
		this._interval = this.options.interval;
		
		var self = this,
			options = this.options,
			id = ((new Date()).getTime() + Math.random()),
			text = options.text || '0%';
		
		this.element
			.addClass("ui-progressbar")
			.width(options.width)
			.ariaRole("progressbar")
			.ariaState("valuemin","0")
			.ariaState("valuemax","100")
			.ariaState("valuenow","0");
			
		$.extend(this, {
			active: false,
			pixelState: 0,
			percentState: 0,
			identifier: id,
			bar: $('<div class="ui-progressbar-bar ui-hidden"></div>').css({
				width: '0px', overflow: 'hidden', zIndex: 100
			}),
			textElement: $('<div class="ui-progressbar-text"></div>').html(text).css({
				width: '0px', overflow: 'hidden'
			}),
			textBg: $('<div class="ui-progressbar-text ui-progressbar-text-back"></div>').html(text).css({
					width: this.element.width()
			}),
			wrapper: $('<div class="ui-progressbar-wrap"></div>')
		});
		
		this.wrapper
			.append(this.bar.append(this.textElement.addClass(options.textClass)), this.textBg)
			.appendTo(this.element);
	},

	_animate: function() {
		var self = this,
			options = this.options,
			interval = options.interval;
		
		this.bar.animate(
			{
				width: options.width
			},
			{
				duration: interval,
				easing: options.equation || this.identifier,
				step: function(step, b) {
					var timestamp = new Date().getTime(), elapsedTime  = (timestamp - b.startTime);
					self.progress( (step/options.width) * 100 );
					options.interval = interval - elapsedTime;
				},
				complete: function() {
					if (self.active) {
						options.interval = self._interval;
						self.bar.width(0);
						self.textElement.width(0);
						self._animate();
					}
					else {
						delete jQuery.easing[self.identifier];
					}
				}
			}
		);
	},
	
	_propagate: function(n,e) {
		$.ui.plugin.call(this, n, [e, this.ui()]);
		this.element.triggerHandler(n == "progressbar" ? n : ["progressbar", n].join(""), [e, this.ui()], this.options[n]);
	},
	
	destroy: function() {
		this.stop();
		
		this.element
			.removeClass("ui-progressbar ui-progressbar-disabled")
			.removeData("progressbar").unbind(".progressbar")
			.find('.ui-progressbar-wrap').remove();
		
		delete jQuery.easing[this.identifier];
	},

	disable: function() {
		this.element.addClass("ui-progressbar-disabled");
		this.disabled = true;
		this.element.ariaState("disabled", true);
	},
	
	enable: function() {
		this.element.removeClass("ui-progressbar-disabled");
		this.disabled = false;
		this.element.ariaState("disabled", false);
	},
	
	pause: function() {
		if (this.disabled) return;
		this.bar.stop();
		this._propagate('pause', this.ui());
	},
	
	progress: function(percentState) {
		if (this.bar.is('.ui-hidden')) {
			this.bar.removeClass('ui-hidden');
		}
		
		this.percentState = percentState > 100 ? 100 : percentState;
		this.pixelState = (this.percentState/100) * this.options.width;
		this.bar.width(this.pixelState);
		this.textElement.width(this.pixelState);
		
		var percent = Math.round(this.percentState);
		if (this.options.range && !this.options.text) {
			this.textElement.html(percent + '%');
		}
		this.element.ariaState("valuenow", percent);
		this._propagate('progress', this.ui());
	},
	
	start: function() {
		var self = this, options = this.options;
		
		if (this.disabled) {
			return;
		}
		
		jQuery.easing[this.identifier] = function (x, t, b, c, d) {
			var inc = options.increment,
				width = options.width,
				step = ((inc > width ? width : inc)/width),
				state = Math.round(x/step)*step;
			return state > 1 ? 1 : state;
		};
		
		self.active = true;
		
		if (options.duration < options.interval) {
			options.duration = options.interval;
		}
		
		setTimeout(
			function() {
				self.active = false;
			},
			options.duration
		);
		
		this._animate();
		
		this._propagate('start', this.ui());
		return false;
	},
	
	stop: function() {
		this.bar.stop();
		this.bar.width(0);
		this.textElement.width(0);
		this.bar.addClass('ui-hidden');
		this.options.interval = this._interval;
		this._propagate('stop', this.ui());
	},
	
	text: function(text){
		this.textElement.html(text);
		this.textBg.html(text);
	},
	
	ui: function(e) {
		return {
			identifier: this.identifier,
			options: this.options,
			element: this.bar,
			textElement: this.textElement,
			pixelState: this.pixelState,
			percentState: this.percentState
		};
	},
	
	plugins: {}
});

$.ui.progressbar.version = "@VERSION";
$.ui.progressbar.defaults = {
	width: 300,
	duration: 1000,
	interval: 1000,
	increment: 1,
	range: true,
	text: '',
	addClass: '',
	textClass: ''
};

})(jQuery);