jquery-ui/ui/jquery.ui.spinner.js
2010-10-26 12:44:32 +02:00

397 lines
9.9 KiB
JavaScript

/*
* jQuery UI Spinner @VERSION
*
* Copyright (c) 2010 AUTHORS.txt (http://jqueryui.com/about)
* Dual licensed under the MIT (MIT-LICENSE.txt)
* and GPL (GPL-LICENSE.txt) licenses.
*
* http://docs.jquery.com/UI/Spinner
*
* Depends:
* jquery.ui.core.js
* jquery.ui.widget.js
*/
(function($) {
// shortcut constants
var pageModifier = 10;
$.widget('ui.spinner', {
options: {
incremental: true,
max: Number.MAX_VALUE,
min: -Number.MAX_VALUE,
numberformat: null,
step: 1,
value: null
},
_create: function() {
// html5 attributes initalization
// TODO refactor
var min = this.element.attr("min");
if (typeof min == "string" && min.length > 0) {
this.options.min = this._parse(min);
}
var max = this.element.attr("max");
if (typeof max == "string" && max.length > 0) {
this.options.max = this._parse(max);
}
var step = this.element.attr("step");
if (typeof step == "string" && step.length > 0) {
this.options.step = this._parse(step);
}
this.value(this.options.value !== null ? this.options.value : this.element.val() || 0);
this._draw();
this._mousewheel();
this._aria();
},
_draw: function() {
var self = this,
options = self.options;
var uiSpinner = this.uiSpinner = self.element
.addClass('ui-spinner-input')
.attr('autocomplete', 'off')
.wrap(self._uiSpinnerHtml())
.parent()
// add buttons
.append(self._buttonHtml())
// add behaviours
.hover(function() {
if (!options.disabled) {
$(this).addClass('ui-state-hover');
}
self.hovered = true;
}, function() {
$(this).removeClass('ui-state-hover');
self.hovered = false;
});
// TODO: need a better way to exclude IE8 without resorting to $.browser.version
// fix inline-block issues for IE. Since IE8 supports inline-block we need to exclude it.
if (!$.support.opacity && uiSpinner.css('display') == 'inline-block' && $.browser.version < 8) {
uiSpinner.css('display', 'inline');
}
this.element
.bind('keydown.spinner', function(event) {
if (self.options.disabled) {
return;
}
if (self._start(event)) {
return self._keydown(event);
}
return true;
})
.bind('keyup.spinner', function(event) {
if (self.options.disabled) {
return;
}
if (self.spinning) {
self._stop(event);
self._change(event);
}
})
.bind('focus.spinner', function() {
uiSpinner.addClass('ui-state-active');
self.focused = true;
})
.bind('blur.spinner', function(event) {
self.value(self.element.val());
if (!self.hovered) {
uiSpinner.removeClass('ui-state-active');
}
self.focused = false;
});
// button bindings
this.buttons = uiSpinner.find('.ui-spinner-button')
.attr("tabIndex", -1)
.button()
.first()
.removeClass("ui-corner-all")
.end()
.last()
.removeClass("ui-corner-all")
.end()
.bind('mousedown', function(event) {
if (self.options.disabled) {
return;
}
if (self._start(event) === false) {
return false;
}
self._repeat(null, $(this).hasClass('ui-spinner-up') ? 1 : -1, event);
})
.bind('mouseup', function(event) {
if (self.options.disabled) {
return;
}
if (self.counter == 1) {
self._spin(($(this).hasClass('ui-spinner-up') ? 1 : -1) * self.options.step, event);
}
if (self.spinning) {
self._stop(event);
self._change(event);
}
})
.bind("mouseenter", function() {
if (self.options.disabled) {
return;
}
// button will add ui-state-active if mouse was down while mouseleave and kept down
if ($(this).hasClass("ui-state-active")) {
if (self._start(event) === false) {
return false;
}
self._repeat(null, $(this).hasClass('ui-spinner-up') ? 1 : -1, event);
}
})
.bind("mouseleave", function() {
if (self.timer && self.spinning) {
self._stop(event);
self._change(event);
}
});
// disable spinner if element was already disabled
if (options.disabled) {
this.disable();
}
},
_keydown: function(event) {
var o = this.options,
KEYS = $.ui.keyCode;
switch (event.keyCode) {
case KEYS.UP:
this._repeat(null, 1, event);
return false;
case KEYS.DOWN:
this._repeat(null, -1, event);
return false;
case KEYS.PAGE_UP:
this._repeat(null, pageModifier, event);
return false;
case KEYS.PAGE_DOWN:
this._repeat(null, -pageModifier, event);
return false;
case KEYS.ENTER:
this.value(this.element.val());
}
return true;
},
_mousewheel: function() {
var self = this;
this.element.bind("mousewheel.spinner", function(event, delta) {
if (self.options.disabled) {
return;
}
if (!self._start(event)) {
return false;
}
self._spin((delta > 0 ? 1 : -1) * self.options.step, event);
if (self.timeout) {
window.clearTimeout(self.timeout);
}
// TODO can we implement that without a timeout?
self.timeout = window.setTimeout(function() {
if (self.spinning) {
self._stop(event);
self._change(event);
}
}, 13);
event.preventDefault();
});
},
_uiSpinnerHtml: function() {
return '<div role="spinbutton" class="ui-spinner ui-state-default ui-widget ui-widget-content ui-corner-all"></div>';
},
_buttonHtml: function() {
return '<a class="ui-spinner-button ui-spinner-up ui-corner-tr"><span class="ui-icon ui-icon-triangle-1-n">&#9650;</span></a>' +
'<a class="ui-spinner-button ui-spinner-down ui-corner-br"><span class="ui-icon ui-icon-triangle-1-s">&#9660;</span></a>';
},
_start: function(event) {
if (!this.spinning && this._trigger('start', event, { value: this.options.value}) !== false) {
if (!this.counter) {
this.counter = 1;
}
this.spinning = true;
return true;
}
return false;
},
// TODO tune repeat behaviour, see http://jsbin.com/aruki4/2 for reference
_repeat: function(i, steps, event) {
var self = this;
i = i || 100;
if (this.timer) {
window.clearTimeout(this.timer);
}
this.timer = window.setTimeout(function() {
self._repeat(self.options.incremental && self.counter > 20 ? 20 : i, steps, event);
}, i);
self._spin(steps*self.options.step, event);
},
_spin: function(step, event) {
if (!this.counter) {
this.counter = 1;
}
var newVal = this.options.value + step * (this.options.incremental && this.counter > 100
? this.counter > 200
? 100
: 10
: 1);
// cancelable
if (this._trigger('spin', event, { value: newVal }) !== false) {
this.value(newVal);
this.counter++;
}
},
_stop: function(event) {
this.counter = 0;
if (this.timer) {
window.clearTimeout(this.timer);
}
this.element[0].focus();
this.spinning = false;
this._trigger('stop', event);
},
_change: function(event) {
this._trigger('change', event);
},
_setOption: function(key, value) {
if (key == 'value') {
value = this._parse(value);
if (value < this.options.min) {
value = this.options.min;
}
if (value > this.options.max) {
value = this.options.max;
}
}
$.Widget.prototype._setOption.call( this, key, value );
this._afterSetData(key, value);
},
_afterSetData: function(key, value) {
switch(key) {
case 'value':
this._format(this.options.value);
case 'max':
case 'min':
case 'step':
this._aria();
}
},
_aria: function() {
// TODO remove check, as soon as this method doesn't get called anymore before uiSpinner is initalized
this.uiSpinner && this.uiSpinner
.attr('aria-valuemin', this.options.min)
.attr('aria-valuemax', this.options.max)
.attr('aria-valuenow', this.options.value);
},
_parse: function(val) {
var input = val;
if (typeof val == 'string') {
// special case for currency formatting until Globalization handles currencies
if (this.options.numberformat == "C" && window.Globalization) {
// parseFloat should accept number format, including currency
var culture = Globalization.culture || Globalization.cultures['default'];
val = val.replace(culture.numberFormat.currency.symbol, "");
}
val = window.Globalization && this.options.numberformat ? Globalization.parseFloat(val) : +val;
}
return isNaN(val) ? null : val;
},
_format: function(num) {
this.element.val( window.Globalization && this.options.numberformat ? Globalization.format(num, this.options.numberformat) : num );
},
destroy: function() {
if ($.fn.mousewheel) {
this.element.unmousewheel();
}
this.element
.removeClass('ui-spinner-input')
.removeAttr('disabled')
.removeAttr('autocomplete')
.removeData('spinner')
.unbind(".spinner");
this.uiSpinner.replaceWith(this.element);
},
enable: function() {
this.element
.removeAttr('disabled')
.parent()
.removeClass('ui-spinner-disabled ui-state-disabled');
this.options.disabled = false;
this.buttons.button("enable");
},
disable: function() {
this.element
.attr('disabled', true)
.parent()
.addClass('ui-spinner-disabled ui-state-disabled');
this.options.disabled = true;
this.buttons.button("disable");
},
stepUp: function(steps) {
this._spin((steps || 1) * this.options.step, null);
return this;
},
stepDown: function(steps) {
this._spin((steps || 1) * -this.options.step, null);
return this;
},
pageUp: function(pages) {
return this.stepUp((pages || 1) * pageModifier);
},
pageDown: function(pages) {
return this.stepDown((pages || 1) * pageModifier);
},
value: function(newVal) {
if (!arguments.length) {
return this.options.value;
}
this._setOption('value', newVal);
},
widget: function() {
return this.uiSpinner;
}
});
})(jQuery);