1 // Copyright (c) 2005 Marty Haught, Thomas Fuchs
3 // See http://script.aculo.us for more info
5 // Permission is hereby granted, free of charge, to any person obtaining
6 // a copy of this software and associated documentation files (the
7 // "Software"), to deal in the Software without restriction, including
8 // without limitation the rights to use, copy, modify, merge, publish,
9 // distribute, sublicense, and/or sell copies of the Software, and to
10 // permit persons to whom the Software is furnished to do so, subject to
11 // the following conditions:
13 // The above copyright notice and this permission notice shall be
14 // included in all copies or substantial portions of the Software.
16 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
17 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
18 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
19 // NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
20 // LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
21 // OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
22 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24 if(!Control) var Control = {};
25 Control.Slider = Class.create();
28 // axis: 'vertical', or 'horizontal' (default)
33 Control.Slider.prototype = {
34 initialize: function(handle, track, options) {
37 if(handle instanceof Array) {
38 this.handles = handle.collect( function(e) { return $PR(e) });
40 this.handles = [$PR(handle)];
43 this.track = $PR(track);
44 this.options = options || {};
46 this.axis = this.options.axis || 'horizontal';
47 this.increment = this.options.increment || 1;
48 this.step = parseInt(this.options.step || '1');
49 this.range = this.options.range || $R(0,1);
51 this.value = 0; // assure backwards compat
52 this.values = this.handles.map( function() { return 0 });
53 this.spans = this.options.spans ? this.options.spans.map(function(s){ return $PR(s) }) : false;
54 this.options.startSpan = $PR(this.options.startSpan || null);
55 this.options.endSpan = $PR(this.options.endSpan || null);
57 this.restricted = this.options.restricted || false;
59 this.maximum = this.options.maximum || this.range.end;
60 this.minimum = this.options.minimum || this.range.start;
62 // Will be used to align the handle onto the track, if necessary
63 this.alignX = parseInt(this.options.alignX || '0');
64 this.alignY = parseInt(this.options.alignY || '0');
66 this.trackLength = this.maximumOffset() - this.minimumOffset();
67 this.handleLength = this.isVertical() ? this.handles[0].offsetHeight : this.handles[0].offsetWidth;
70 this.dragging = false;
71 this.disabled = false;
73 if(this.options.disabled) this.setDisabled();
75 // Allowed values array
76 this.allowedValues = this.options.values ? this.options.values.sortBy(Prototype.K) : false;
77 if(this.allowedValues) {
78 this.minimum = this.allowedValues.min();
79 this.maximum = this.allowedValues.max();
82 this.eventMouseDown = this.startDrag.bindAsEventListener(this);
83 this.eventMouseUp = this.endDrag.bindAsEventListener(this);
84 this.eventMouseMove = this.update.bindAsEventListener(this);
86 // Initialize handles in reverse (make sure first handle is active)
87 this.handles.each( function(h,i) {
88 i = slider.handles.length-1-i;
89 slider.setValue(parseFloat(
90 (slider.options.sliderValue instanceof Array ?
91 slider.options.sliderValue[i] : slider.options.sliderValue) ||
92 slider.range.start), i);
93 Element.makePositioned(h); // fix IE
94 Event.observe(h, "mousedown", slider.eventMouseDown);
97 Event.observe(this.track, "mousedown", this.eventMouseDown);
98 Event.observe(document, "mouseup", this.eventMouseUp);
99 Event.observe(document, "mousemove", this.eventMouseMove);
101 this.initialized = true;
103 dispose: function() {
105 Event.stopObserving(this.track, "mousedown", this.eventMouseDown);
106 Event.stopObserving(document, "mouseup", this.eventMouseUp);
107 Event.stopObserving(document, "mousemove", this.eventMouseMove);
108 this.handles.each( function(h) {
109 Event.stopObserving(h, "mousedown", slider.eventMouseDown);
112 setDisabled: function(){
113 this.disabled = true;
115 setEnabled: function(){
116 this.disabled = false;
118 getNearestValue: function(value){
119 if(this.allowedValues){
120 if(value >= this.allowedValues.max()) return(this.allowedValues.max());
121 if(value <= this.allowedValues.min()) return(this.allowedValues.min());
123 var offset = Math.abs(this.allowedValues[0] - value);
124 var newValue = this.allowedValues[0];
125 this.allowedValues.each( function(v) {
126 var currentOffset = Math.abs(v - value);
127 if(currentOffset <= offset){
129 offset = currentOffset;
134 if(value > this.range.end) return this.range.end;
135 if(value < this.range.start) return this.range.start;
138 setValue: function(sliderValue, handleIdx){
140 this.activeHandle = this.handles[handleIdx];
141 this.activeHandleIdx = handleIdx;
144 handleIdx = handleIdx || this.activeHandleIdx || 0;
145 if(this.initialized && this.restricted) {
146 if((handleIdx>0) && (sliderValue<this.values[handleIdx-1]))
147 sliderValue = this.values[handleIdx-1];
148 if((handleIdx < (this.handles.length-1)) && (sliderValue>this.values[handleIdx+1]))
149 sliderValue = this.values[handleIdx+1];
151 sliderValue = this.getNearestValue(sliderValue);
152 this.values[handleIdx] = sliderValue;
153 this.value = this.values[0]; // assure backwards compat
155 this.handles[handleIdx].style[this.isVertical() ? 'top' : 'left'] =
156 this.translateToPx(sliderValue);
159 if(!this.dragging || !this.event) this.updateFinished();
161 setValueBy: function(delta, handleIdx) {
162 this.setValue(this.values[handleIdx || this.activeHandleIdx || 0] + delta,
163 handleIdx || this.activeHandleIdx || 0);
165 translateToPx: function(value) {
167 ((this.trackLength-this.handleLength)/(this.range.end-this.range.start)) *
168 (value - this.range.start)) + "px";
170 translateToValue: function(offset) {
171 return ((offset/(this.trackLength-this.handleLength) *
172 (this.range.end-this.range.start)) + this.range.start);
174 getRange: function(range) {
175 var v = this.values.sortBy(Prototype.K);
177 return $R(v[range],v[range+1]);
179 minimumOffset: function(){
180 return(this.isVertical() ? this.alignY : this.alignX);
182 maximumOffset: function(){
183 return(this.isVertical() ?
184 this.track.offsetHeight - this.alignY : this.track.offsetWidth - this.alignX);
186 isVertical: function(){
187 return (this.axis == 'vertical');
189 drawSpans: function() {
192 $R(0, this.spans.length-1).each(function(r) { slider.setSpan(slider.spans[r], slider.getRange(r)) });
193 if(this.options.startSpan)
194 this.setSpan(this.options.startSpan,
195 $R(0, this.values.length>1 ? this.getRange(0).min() : this.value ));
196 if(this.options.endSpan)
197 this.setSpan(this.options.endSpan,
198 $R(this.values.length>1 ? this.getRange(this.spans.length-1).max() : this.value, this.maximum));
200 setSpan: function(span, range) {
201 if(this.isVertical()) {
202 span.style.top = this.translateToPx(range.start);
203 span.style.height = this.translateToPx(range.end - range.start + this.range.start);
205 span.style.left = this.translateToPx(range.start);
206 span.style.width = this.translateToPx(range.end - range.start + this.range.start);
209 updateStyles: function() {
210 this.handles.each( function(h){ Element.removeClassName(h, 'selected') });
211 Element.addClassName(this.activeHandle, 'selected');
213 startDrag: function(event) {
214 if(Event.isLeftClick(event)) {
218 var handle = Event.element(event);
219 var pointer = [Event.pointerX(event), Event.pointerY(event)];
220 if(handle==this.track) {
221 var offsets = Position.cumulativeOffset(this.track);
223 this.setValue(this.translateToValue(
224 (this.isVertical() ? pointer[1]-offsets[1] : pointer[0]-offsets[0])-(this.handleLength/2)
226 var offsets = Position.cumulativeOffset(this.activeHandle);
227 this.offsetX = (pointer[0] - offsets[0]);
228 this.offsetY = (pointer[1] - offsets[1]);
230 // find the handle (prevents issues with Safari)
231 while((this.handles.indexOf(handle) == -1) && handle.parentNode)
232 handle = handle.parentNode;
234 this.activeHandle = handle;
235 this.activeHandleIdx = this.handles.indexOf(this.activeHandle);
238 var offsets = Position.cumulativeOffset(this.activeHandle);
239 this.offsetX = (pointer[0] - offsets[0]);
240 this.offsetY = (pointer[1] - offsets[1]);
246 update: function(event) {
248 if(!this.dragging) this.dragging = true;
250 // fix AppleWebKit rendering
251 if(navigator.appVersion.indexOf('AppleWebKit')>0) window.scrollBy(0,0);
255 draw: function(event) {
256 var pointer = [Event.pointerX(event), Event.pointerY(event)];
257 var offsets = Position.cumulativeOffset(this.track);
258 pointer[0] -= this.offsetX + offsets[0];
259 pointer[1] -= this.offsetY + offsets[1];
261 this.setValue(this.translateToValue( this.isVertical() ? pointer[1] : pointer[0] ));
262 if(this.initialized && this.options.onSlide)
263 this.options.onSlide(this.values.length>1 ? this.values : this.value, this);
265 endDrag: function(event) {
266 if(this.active && this.dragging) {
267 this.finishDrag(event, true);
271 this.dragging = false;
273 finishDrag: function(event, success) {
275 this.dragging = false;
276 this.updateFinished();
278 updateFinished: function() {
279 if(this.initialized && this.options.onChange)
280 this.options.onChange(this.values.length>1 ? this.values : this.value, this);