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

2008-11-08 02:39:06  来源:http://ooboy.net,译者:Fdream 

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

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

基本用法

创建一个新的滚动条(Slider)对象

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

参考代码: [复制代码] [保存代码]
  1. <div id="slider"><div id="knob"></div></div>

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

参考代码: [复制代码] [保存代码]
  1. #slider {
  2.     width200px
  3.     height20px
  4.     background-color: #0099FF
  5. }
  6.  
  7. #knob {
  8.     width20px
  9.     height20px
  10.     background-color: #993333
  11. }

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

参考代码: [复制代码] [保存代码]
  1. // 把元素赋值给变量
  2. var sliderObject = $('slider');
  3. var knobObject = $('knob');
  4.  
  5. // 创建一个新的slider对象
  6. // 首先定义slider元素
  7. // 然后定义滑块元素
  8. var SliderObject = new Slider(sliderObject , knobObject , {
  9.     // 这里是你的选项
  10.     // 稍后我们会仔细讲一下这些选项
  11.     range: [010],
  12.     snap: true,
  13.     steps: 10,
  14.     offset: 0,
  15.     wheel: true,
  16.     mode: 'horizontal',
  17.     // 当step的值改变时将触发onchange事件
  18.     // 它会把当前的step作为参数传入
  19.     onChange: function(step){
  20.         // 在这里放置onchange时要执行的代码
  21.         // 你可以引用step
  22.     },
  23.     // 当用户拖动滑块时触发ontick事件
  24.     // 它会传递当前的位置(相对于父元素的位置)
  25.     onTick: function(pos){
  26.     // 这是必需的,用以调整滑块的位置
  27.     // 我们会在下面详细解释这个
  28.     this.knob.setStyle('left', pos);
  29.     },
  30.     // 当拖动停止时触发
  31.     onComplete: function(step){
  32.         // 当完成时要执行的代码
  33.         // 你可以引用step
  34.     }
  35. });

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)。

参考代码: [复制代码] [保存代码]
  1. window.addEvent('domready'function() {
  2. var SliderObject = new Slider('slider''knob', {
  3.     // 选项
  4.     range: [010],
  5.     snap: false,
  6.     steps: 10,
  7.     offset: 0,
  8.     wheel: true,
  9.     mode: 'horizontal',
  10.  
  11.     // 回调事件
  12.     onChange: function(step){
  13.         $('change').highlight('#F3F825');
  14.         $('steps_number').set('html', step);
  15.     },
  16.     onTick: function(pos){
  17.         $('tick').highlight('#F3F825');
  18.         $('knob_pos').set('html', pos);
  19.         // 这一行是必需的(水平滚动使用left)
  20.         this.knob.setStyle('left', pos);
  21.  
  22.     },
  23.     onComplete: function(step){
  24.         $('complete').highlight('#F3F825')
  25.         $('steps_complete_number').set('html', step);
  26.         this.set(step);
  27.     }
  28. });
  29.  
  30. var SliderObjectV = new Slider('sliderv''knobv', {
  31.     range: [-100],
  32.     snap: true,
  33.     steps: 10,
  34.     offset: 0,
  35.     wheel: true,
  36.     mode: 'vertical',
  37.     onTick: function(pos){
  38.         // 这一行是必需的(垂直滚动使用top)
  39.         this.knob.setStyle('top', pos);
  40.     },
  41.     onChange: function(step){
  42.         $('stepsV_number').set('html', step*-1);
  43.     }
  44. });
  45.  
  46. // 设置垂直滚动的从0开始
  47. // 否则的话是从顶部开始
  48. SliderObjectV.set(0);
  49.  
  50. // 设置滚动条从7开始
  51. $('set_knob').addEvent('click'function(){ SliderObject.set(7)});
  52.  
  53. });

onChange

passes the step you are on:  
onTick
passes the knob position:  
onComplete
passes the current step:  
 

 
0

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

 

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

更多学习

和以前一样,请参考文档中的sliders一节

下载一个包含你开始所需要的所有东西的zip包

包括MooTools 1.2的核心库和扩展库,还有一个外部的JavaScript文件,一个简单的HTML页面和一个CSS文件和上面的示例。

更多