先废话几句,这第23篇教程一直没有翻译出来,直到今天我看到待审评论里面有这么一条超长的评论,结果一看,居然是这篇教程的翻译稿。这位热心的Mootools爱好者是Fanhp,非常感谢你的辛勤劳动!同时,我感到非常羞愧,实在是有愧大家的期望!愧疚是要拿行动来补的,于是我赶紧对此篇翻译进行了一些整理,修改了其中部分词句,并整理了示例代码。

————————

原文地址:30 Days of Mootools 1.2 Tutorials – Day 23 – Fx.Slide

使用Fx.Slid显示元素

请尊重个人劳动,转载请注明出处:http://fdream.net,译者:Fanhp,整理:Fdream

如果你还没有准备好开始这一讲,请参考这一系列的教程,这里是《MooTools 1.2系列教程目录》

今天继续我们的Mootools 1.2教程的第23课,我们今天来讲一下Fx插件中的Fx.Slide。通过该插件,可以让你把内容以滑动的方式显示出来。它使用起来非常简单,是你UI工具箱中一个很好的工具。

基本用法

就像我们前面看过的所有类一样,我们在把这个类应用到一个元素上面时,我们要做的第一件事就是初始化一个新的Fx.Slide实例。

首先,让我们为滑动元素建立一个HTML文件。

<div id="slide_element" class="slide">这里是要滑动显示的内容。</div>

我们的CSS也不需要任何修饰。

.slide {
    margin: 20px 0;
    padding: 10px;
    width: 200px;
    background-color: #DAF7B4;
}

最后,我们来初始化一个新的Fx.Slide并给它传递我们的元素变量。

var slideElement = $('slide_element');
 
var slideVar = new Fx.Slide(slideElement, {
    // Fx.Slide选项
    mode: 'vertical', // 默认是'vertical'(垂直)
 
    // Fx选项
    transition: 'sine:in',
    duration: 300, 
 
    // Fx事件
    onStart: function(){
        $('start').highlight("#EBCC22");
    }
});

由于Fx.Slide是Fx的一个扩展,因此你可以使用Fx的任何选项和事件,不过Fx.Slide也有一些自己的选项。

Fx.Slide选项

Fx.Slide只有两个选项——“mode”和“wrapper”。坦白地说,我从来没有发现我自己使用过“wrapper”(我从来没有遇到过这种需求),不过“mode”决定了你是希望水平滑动还是垂直滑动。

mode(模式)

模式给了你两个选择——“垂直”或者“水平”。垂直是从顶部到底部的显示,水平是从左边到右边的显示。这里没有从底部到顶部或从右边到左边的选项。不过我知道修改类本身来实现这些功能是相对简单的。在我看来,我还是希望这能成为一个标准的选项,如果有人已经修改了这个类并允许这些选项,请给我们留言。

wrapper(包装器)

在缺省情况下,Fx.Slide会在你的滑动元素的外面添加一个包装器,并指定其“overflow”属性的值为“hidden”。wrapper允许你设置其他元素作为该元素的包装器。就像我上面所说的,我不清楚它在那里会被用到,我也有兴趣听到任何关于这个东西的想法。(感谢mooforum.net的horseweapon让我明白这个一点。)

Fx.Slide的方法

Fx.Slide也提供了许多方法来显示或者隐藏元素。

.slideIn()

正如名字所告诉你的,该方法讲触发start(开始)时间并显示你的元素。

.slideOut()

滑动元素到隐藏状态。

.toggle()

这个方法有可能显示或者隐藏元素,结果完全取决于这个元素的当前状态。用于点击事件时非常有用。

.hide()

这将隐藏元素,但不使用滑动效果。

.show()

这将显示元素,但不使用滑动效果。

通过方法重新设置模式选项

上面的每个方法均可以接受一个可选的mode参数,允许你覆盖之前设置的选项。

slideVar.slideIn('horizontal');

Fx.Slide快捷方式

Fx.Slide类还提供了一些非常方便的快捷方式来给元素添加滑动效果。

.set(‘slide’);

你可以不用初始化一个新类,而通过set方法来给元素添加一个slide对象来创建一个新的slide实例。

slideElement.set('slide');

设置选项

甚至你还可以通过快捷方式设置选项:

slideElement.set('slide', {duration: 1250});

.slide()

一旦用.set()方法设置了slide,你就可以用.slide()方法来初始化它。

slideElement.slide('in');

.slide方法可以接受以下参数:

  • ‘in’
  • ‘out’
  • ‘toggle’
  • ‘show’
  • ‘hide’

每一个参数均和上面的方法相对应。

代码示例

上面所讲的这些基本涵盖了全部基本用法。下面的示例将使用我们上面学到的大部分知识,显示一些不同的滑动元素,并提供一些div作为指示器,以便你可以清楚地看到这些事件。

首先,创建HTML文件。

<div id="start" class="ind">Start</div>
<div id="cancel" class="ind">Cancel</div>
<div id="complete" class="ind">Complete</div>
<br /><br />
 
<button id="openA">open A</button>
<button id="closeA">close A</button>
<div id="slideA" class="slide">Here is some content - A. Notice the delay before onComplete fires.  This is due to the transition effect, the onComplete will not fire until the slide element stops "elasticing." Also, notice that if you click back and forth, it will "cancel" the previous call and give the new one priority.</div>
 
<button id="openB">open B</button>
<button id="closeB">close B</button>
<div id="slideB" class="slide">Here is some content - B. Notice how if you click me multiple times quickly I "chain" the events.  This slide is set up with the option "link: 'chain'"</div>
 
<button id="openC">toggle C</button>
<div id="slideC" class="slide">Here is some content - C</div>
 
<button id="openD">toggle D</button>
<div id="slideD" class="slide">Here is some content - D. Notice how I am not hooked into any events.  This was done with the .slide shortcut.</div>
 
<button id="openE">toggle E</button>
 
<div id="slide_wrap">
<div id="slideE" class="slide">Here is some content - E</div>
</div>

接下来是CSS文件。我们让它尽量保持简单。

.ind {
    width: 200px;
    padding: 10px;
    background-color: #87AEE1;
    font-weight: bold;
    border-bottom: 1px solid white;
}
 
.slide {
    margin: 20px 0; 
    padding: 10px;
    width: 200px;
    background-color: #DAF7B4;
}
 
#slide_wrap {
    padding: 30px;
    background-color: #D47000;
}

最后,是我们的Mootools JavaScript代码:

window.addEvent('domready', function() {
    // 示例A
    var slideElement = $('slideA');
 
    var slideVar = new Fx.Slide(slideElement, {
        // Fx.Slide选项
        mode: 'horizontal', // 默认是'vertical'
        //wrapper: this.element, // 默认是this.element
 
        // Fx选项
        link: 'cancel',
        transition: 'elastic:out',
        duration: 'long', 
 
        // Fx事件
        onStart: function(){
            $('start').highlight("#EBCC22");
        },
 
        onCancel: function(){
            $('cancel').highlight("#EBCC22");
        },
 
        onComplete: function(){
            $('complete').highlight("#EBCC22");
        }
    }).hide().show().hide(); // 注意,.hide和.show方法并不触发事件
 
    $('openA').addEvent('click', function(){
        slideVar.slideIn();
    });
 
    $('closeA').addEvent('click', function(){
        slideVar.slideOut();
    });
 
  
    // 示例B
    var slideElementB = $('slideB');
 
    var slideVarB = new Fx.Slide(slideElementB, {
        // Fx.Slide选项
        mode: 'vertical', // 默认是'vertical'
 
        // Fx选项
        // 注意:链式效果可以让你多次点击,
        // 当鼠标离开后,
        // 每次点击的动画可以依次触发
        link: 'chain', 
 
        // Fx事件
        onStart: function(){
            $('start').highlight("#EBCC22");
        },
 
        onCancel: function(){
            $('cancel').highlight("#EBCC22");
        },
 
        onComplete: function(){
            $('complete').highlight("#EBCC22");
        }
    });
 
    $('openB').addEvent('click', function(){
        slideVarB.slideIn();
    });
 
    $('closeB').addEvent('click', function(){
        slideVarB.slideOut();
    });
 
    // 示例 C
    var slideElementC = $('slideC');
 
    var slideVarC = new Fx.Slide(slideElementC, {
        // Fx.Slide选项
        mode: 'vertical', // 默认是'vertical'
        //wrapper: this.element, // 默认是this.element
 
        // Fx选项
        //link: 'cancel',
        transition: 'sine:in',
        duration: 300, 
 
 
        // Fx事件
        onStart: function(){
            $('start').highlight("#EBCC22");
        },
 
        onCancel: function(){
            $('cancel').highlight("#EBCC22");
        },
 
        onComplete: function(){
            $('complete').highlight("#EBCC22");
        }
    }).hide();
 
    $('openC').addEvent('click', function(){
        slideVarC.toggle();
    });
 
 
    $('slideD').slide('hide');
 
    $('openD').addEvent('click', function(){
        $('slideD').slide('toggle');
    });
 
    // 示例C
    var slideElementE = $('slideE');
    var slideWrap = $('slide_wrap');
 
    var slideVarE = new Fx.Slide(slideElementE, {
        // Fx.Slide选项
        //mode: 'vertical', // 默认是'vertical'
        wrapper: slideWrap // 默认是this.element
    }).hide(); 
 
    $('openE').addEvent('click', function(){
        slideVarE.toggle();
    });
});

Start
Cancel
Complete


Here is some content – A. Notice the delay before onComplete fires. This is due to the transition effect, the onComplete will not fire until the slide element stops “elasticing.” Also, notice that if you click back and forth, it will “cancel” the previous call and give the new one priority.


Here is some content – B. Notice how if you click me multiple times quickly I “chain” the events. This slide is set up with the option “link: ‘chain’”

Here is some content – C

Here is some content – D. Notice how I am not hooked into any events. This was done with the .slide shortcut.

Here is some content – E

学习更多……

Fx.Slide是一个多功能,非常有用的插件。要学习更多,查看Fx.Slide文档Fx.MorphFx文档

另外,也一定要阅读一下我们关于Fx.Morph和Fx选项和事件的教程

2 Comments

  1. 你的教程写的很好啊,我很喜欢,可是似乎原文的Link都已经(02/16/2011)过期了。如果你有备份的话,还是希望你把它完成,支持你。

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.