Tutorials Point


  Learn script.aculo.us
  script.aculo.us Resources
  Selected Reading

Copyright © 2014 by tutorialspoint



  Home     References     Discussion Forums     About TP  

script.aculo.us Sliders


previous next AddThis Social Bookmark Button


Advertisements

The sliders are thin tracks with one or more handles on them that the user can drag along the track.

The goal of a slider is to provide an alternative input method for defining a numerical value; the slider represents a range, and sliding a handle along the track defines a value within this range.

The sliders can be in either a horizontal or vertical orientation. When horizontal, the left end of the track usually represents the lowest value, while in a vertical orientation, the bottom of the slide is usually the lowest values.

To use script.aculo.us's slider capabilities, you'll need to load the slider.js module along with prototype.js module. So your minimum loading for script.aculo.us will look like this:

<script type="text/javascript" 
   src="/javascript/prototype.js">
</script>
<script type="text/javascript" 
   src="/javascript/scriptaculous.js?load=slider">
</script>

Creating a Slider Control:

Creating a slider is, as usual, a matter of constructing a custom object over a few existing elements in your page.s DOM. You'll need two elements here: one for the handle and one for the track as follows:

new Control.Slider(handle, track [ , options ] );

The track element is usually a <div>, and the handle element is a <div> or <span> within the track element. Both can be passed either by their id= or by direct DOM references, as usual.

Sliders Options:

You can use or more of the following options while creating your Slider object.

OptionDescription
AxisDefines the orientation of the control as one of horizontal or vertical. The default orientation is horizontal.
RangeDefines the range of the slider values as an instance of a Prototype ObjectRange instance. Defaults to 0 through 1.
ValuesDefines the discrete set of values that the slider can acquire. If omitted, all values within the range can be set.
sliderValueSets the initial value of the slider. If omitted, the value represented by the leftmost (or top-most) edge of the slider is the initial value.
DisabledIf true, creates a slide that is initially disabled. Obviously defaults to false.
setValueWill update the slider's value and thus move the slider handle to the appropriate position.
setDisabledWill set the slider to the disabled state (disabled = true).
setEnabledWill set the slider to the enabled state (disabled = false).

You can provide the following callbacks in the options parameter:

OptionDescription
onSlideCalled whenever the Slider is moved by dragging. The called function gets the slider value as its parameter.
onChangeCalled whenever the Slider has finished moving or has had its value changed via the setSlider Value? function. The called function gets the slider value as its parameter.

Sliders Example:

<html>
<head>
<title>Sliders Example</title>
<script type="text/javascript" 
        src="/javascript/prototype.js"></script>
<script type="text/javascript"  
        src="/javascript/scriptaculous.js?load=slider"></script>
<script type="text/javascript">
   window.onload = function() {
       new Control.Slider('handle1' , 'track1',
      {
           range: $R(1,100),
           values: [1,25,50,75,100],
           sliderValue: 1,
           onChange: function(v){
               $('changed').innerHTML = 'Changed Value : '+v;
           },
           onSlide: function(v) {
               $('sliding').innerHTML = 'Sliding Value: '+v;
          }
       } );
      new Control.Slider('handle2' , 'track2',
      {
           range: $R(1,100),
           axis:'vertical',
           sliderValue: 1,
           onChange: function(v){
                 $('changed').innerHTML = 'Changed Value : '+v;
           },
           onSlide: function(v) {
                 $('sliding').innerHTML = 'Sliding Value: '+v;
          }
       } );

}
</script>
<style type="text/css">
h1{ font-size: 1.5em; }
.track {
   background-color: #aaa;
   position: relative;
   height: 0.5em; width: 10em;
   cursor: pointer; z-index: 0;
}
.handle {
   background-color: red;
   position: absolute;
   height: 1em; width: 0.25em; top: -0.25em;
   cursor: move; z-index: 2;
}
.track.vertical { 
   width: 0.5em; height: 10em; 
}
.track.vertical .handle {
   width: 1em; height: 0.25em; top: 0; left: -0.25em; 
 }
</style>
</head>
<body>

<h1>Simple sliders</h1>

<div id="track1" class="track" style="width: 20em;" >
   <div id="handle1" class="handle" style="width: 0.5em;" ></div>
</div>

<p id="sliding" ></p>
<p id="changed" ></p>

<div id="track2" class="track vertical" 
style="position: absolute; left: 25em; top: 3em;" >
   <div id="handle2" class="handle" style="height: 0.5em;" ></div>
</div>

</body>
</html>

There are following points to note:

  • You can change slider image of any slider using CSS. Use CSS properties background-image: url(track.gif) and background-repeat: no-repeat to set slider image.

  • The range value can be specified using $R(minValue, MaxValue). For example $R(1, 100).

  • The range value can be specified in terms of specific values. For example values: [1,25,50,75,100]. In this case, the slider would only achieve the discrete values listed as the handle was moved.

  • At any time, the value of the slider can be set under program control by calling the setValue() method of the slider instance, as in: sliderInstance.setValue(50);

To understand it in better way you can Try it yourself with different options discussed in above table.



previous next Printer Friendly

Advertisements


  

Advertisements