MooTools教程(15):滚动条(Slider)

到现在为止，初始化这些MooTools插件对象就会开始变得越来越熟悉。滚动条（Slider）没有任何不同，你要创建一个新的滚动条，定义滚动条和滑块相关的元素，然后设置你的选项，再创建一些回调事件的控制函数。尽管滚动条（Slider）遵循这个熟悉的模式，但是任然还有一点特殊的地方。

基本用法

创建一个新的滚动条（Slider）对象

我们首先从HTML和CSS开始。基本的想法是创建一个滚动条的div，因此是一个长的长方形（长度取决于我们用滚动条做什么），还有一个子元素作为滑块。

参考代码： [复制代码] [保存代码]

<div id="slider"><div id="knob"></div></div>

我们的CSS也可以这么简单。只需要设置宽、高，还有背景颜色。

参考代码： [复制代码] [保存代码]

#slider {
width: 200px
height: 20px
background-color: #0099FF
}
#knob {
width: 20px
height: 20px
background-color: #993333
}

现在，我们可以创建我们的新滚动条对象了。要初始化滚动条，首先要把你的相关元素赋值给一些变量，然后使用“new”来创建一个滚动条Slider对象，这和我们以前创建tween、morph和drag.move时一样：

参考代码： [复制代码] [保存代码]

// 把元素赋值给变量
var sliderObject = $('slider');
var knobObject = $('knob');
// 创建一个新的slider对象
// 首先定义slider元素
// 然后定义滑块元素
var SliderObject = new Slider(sliderObject , knobObject , {
// 这里是你的选项
// 稍后我们会仔细讲一下这些选项
range: [0, 10],
snap: true,
steps: 10,
offset: 0,
wheel: true,
mode: 'horizontal',
// 当step的值改变时将触发onchange事件
// 它会把当前的step作为参数传入
onChange: function(step){
// 在这里放置onchange时要执行的代码
// 你可以引用step
},
// 当用户拖动滑块时触发ontick事件
// 它会传递当前的位置（相对于父元素的位置）
onTick: function(pos){
// 这是必需的，用以调整滑块的位置
// 我们会在下面详细解释这个
this.knob.setStyle('left', pos);
},
// 当拖动停止时触发
onComplete: function(step){
// 当完成时要执行的代码
// 你可以引用step
}
});

Slider的选项

Snap：（默认为false），可以是一个true或者false值。这决定了滑块是不是以最小单元格移动

Offset：（默认是0），这是滑块相对于开始的位置。你可以对此做一个试验。

Range：（默认是false），这是一个非常有用的选项。你可以设置一个数字范围，会依照此数字和你的步数（step）触发onchange事件。例如：如果你设置的范围是[0, 200]，而且你设置的step值为10，那么每次onchange的step的值将是20。这个范围也是是负数，例如[-10,0]，这个数字在做反向的滚动条时会非常有用（下面有示例）。

Wheel：（默认是false），如果设置这个参数为true，这个滚动条将会识别鼠标滚轮事件。当使用鼠标滚轮时，你肯恩需要调整range参数，以保证鼠标滚轮事件的行为不是相反的（同样，后面会有例子）。

Steps：（默认是100），默认值为100非常有用，因为它可以很容易地作为百分比使用。当然，你也可以以你的理由设置任意多步（这是可以的）。

Mode：（默认是“horizontal”），这个参数定义了滚动条是水平滚动还是垂直滚动。当然了，要从水平滚动转化为垂直滚动还需要一些其它步骤。

回调事件

onChange：当step改变时，触发这个事件。同时传递参数“step”。可以从下面的例子中看到它是什么时候触发的。

onTick：当控制点的位置发生改变时触发这个事件。同时传递参数“position”。可以从下面的例子中看到它是什么时候触发的。

onComplete：当控制点释放时触发这个事件。捅死传递参数“step”。可以从下面的例子中看到它是什么时候触发的。

代码示例

让我们建立一个示例，以便看看它们的效果。

.set();方法：看一看按钮上的事件，看是怎么使用.set()方法的。它使用起来非常简单：调用slider对象，附加.set，然后是你想要滚动的步数（step）。

参考代码： [复制代码] [保存代码]

window.addEvent('domready', function() {
var SliderObject = new Slider('slider', 'knob', {
// 选项
range: [0, 10],
snap: false,
steps: 10,
offset: 0,
wheel: true,
mode: 'horizontal',
// 回调事件
onChange: function(step){
$('change').highlight('#F3F825');
$('steps_number').set('html', step);
},
onTick: function(pos){
$('tick').highlight('#F3F825');
$('knob_pos').set('html', pos);
// 这一行是必需的（水平滚动使用left）
this.knob.setStyle('left', pos);
},
onComplete: function(step){
$('complete').highlight('#F3F825')
$('steps_complete_number').set('html', step);
this.set(step);
}
});
var SliderObjectV = new Slider('sliderv', 'knobv', {
range: [-10, 0],
snap: true,
steps: 10,
offset: 0,
wheel: true,
mode: 'vertical',
onTick: function(pos){
// 这一行是必需的（垂直滚动使用top）
this.knob.setStyle('top', pos);
},
onChange: function(step){
$('stepsV_number').set('html', step*-1);
}
});
// 设置垂直滚动的从0开始
// 否则的话是从顶部开始
SliderObjectV.set(0);
// 设置滚动条从7开始
$('set_knob').addEvent('click', function(){ SliderObject.set(7)});
});

onChange

passes the step you are on:

onTick
passes the knob position:

onComplete
passes the current step:

注意在垂直滚动的例子中，我们不仅仅只是把“mode”改成了“vertical”，我们还改变了onTick事件中的.setStyle();方法中的“left”属性为“top”属性。另外，看一下我们是怎样设置“range”从-10开始，然后到0的。然后，我们在onChange事件中显示当前的数字，我们把这个值乘了-1，正好和位置相反。这完成了两件事情：一是让我们从10到0改变这个值，0在最底部。但是这个可能设置rang为从10到0，从而导致鼠标滚轮事件变得相反。这就是我们的第二个原因——鼠标滚轮读取值，而不是你要控制的方向，因此要让鼠标滚轮正确地读取滚动条并且从底部的0开始的值的唯一方式就是做这一点点改变。

注意：至于onTick事件中“top”和“left”的使用，我不确定这是不是MooTools中的“规则”。这只是我让它们正确运行的一种方法，我很有兴趣听到一些其他的清楚的说法。