X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/6e39d509471fe9b4e2660e0d1631b350d0c66f40..7a654f8d43fdb43d78b63d90528bed6e86b608cc:/docs/source/Single.html diff --git a/docs/source/Single.html b/docs/source/Single.html new file mode 100644 index 00000000..5c332d46 --- /dev/null +++ b/docs/source/Single.html @@ -0,0 +1,62 @@ +
\ No newline at end of file/** + * @class Ext.slider.Single + * @extends Ext.slider.Multi + * Slider which supports vertical or horizontal orientation, keyboard adjustments, + * configurable snapping, axis clicking and animation. Can be added as an item to + * any container. + * {@img Ext.slider.Single/Ext.slider.Single.png Ext.slider.Single component} + * Example usage: +<pre><code> + Ext.create('Ext.slider.Single', { + width: 200, + value: 50, + increment: 10, + minValue: 0, + maxValue: 100, + renderTo: Ext.getBody() + }); +</code></pre> + * The class Ext.slider.Single is aliased to Ext.Slider for backwards compatibility. + * @xtype slider + */ +Ext.define('Ext.slider.Single', { + extend: 'Ext.slider.Multi', + alias: ['widget.slider', 'widget.sliderfield'], + alternateClassName: ['Ext.Slider', 'Ext.form.SliderField', 'Ext.slider.SingleSlider', 'Ext.slider.Slider'], + + /** + * Returns the current value of the slider + * @return {Number} The current value of the slider + */ + getValue: function() { + //just returns the value of the first thumb, which should be the only one in a single slider + return this.callParent([0]); + }, + + /** + * Programmatically sets the value of the Slider. Ensures that the value is constrained within + * the minValue and maxValue. + * @param {Number} value The value to set the slider to. (This will be constrained within minValue and maxValue) + * @param {Boolean} animate Turn on or off animation, defaults to true + */ + setValue: function(value, animate) { + var args = Ext.toArray(arguments), + len = args.length; + + //this is to maintain backwards compatiblity for sliders with only one thunb. Usually you must pass the thumb + //index to setValue, but if we only have one thumb we inject the index here first if given the multi-slider + //signature without the required index. The index will always be 0 for a single slider + if (len == 1 || (len <= 3 && typeof arguments[1] != 'number')) { + args.unshift(0); + } + + return this.callParent(args); + }, + + // private + getNearest : function(){ + // Since there's only 1 thumb, it's always the nearest + return this.thumbs[0]; + } +}); +