Nivo Slider (滑动)简要使用文档.

来源：互联网发布：关爱八卦成长协会知乎编辑：程序博客网时间：2024/04/29 23:39

转自：http://www.2cto.com/kf/201202/119195.html
源码：http://download.csdn.net/download/chelen_jak/7310887
教程：http://designmodo.com/image-slider-jquery-css3/

Nivo Slider是一款出色的jQuery幻灯片插件,支持多种切换效果,可定制性强.

这个是官方网站:http://nivo.dev7studios.com/

但找了一下,却没发现什么相应的文档介绍.

于是,干脆自己简单的整理了一下.

[javascript]
$.fn.nivoSlider.defaults = {
    effect: 'random', // 过渡效果
    slices: 15, //effect为切片效果时的数量
    boxCols: 8, //effect为格子效果时的列
    boxRows: 4, //effect为格子效果时的行
    animSpeed: 500, //动画速度
    pauseTime: 3000, //图片切换速度
    startSlide: 0, //从第几张开始
    directionNav: true, //是否显示图片切换按钮(上/下页)
    directionNavHide: true, //是否鼠标经过才显示
    controlNav: true, // 显示序列导航
    controlNavThumbs: false, // 显示图片导航
    controlNavThumbsFromRel: false, // 使用img的rel属性作为缩略图地址
    controlNavThumbsSearch: '.jpg', // 查找特定字符串(controlNavThumbs必须为true)
    controlNavThumbsReplace: '_thumb.jpg', // 替换成这个字符(controlNavThumbs必须为true)
    keyboardNav: true, // 键盘控制（左右箭头）PS:建议把代码中的keypress换成keydown,因为在Chrome下有兼容问题.
    pauseOnHover: true, // 鼠标经过时暂停播放
    manualAdvance: false, // 是否手动播放(false为自动播放幻灯片)
    captionOpacity: 0.1, // 字幕透明度
    prevText: 'Prev',
    nextText: 'Next',
    randomStart: false, //是否随机图片开始
    beforeChange: function(){}, //动画开始前触发
    afterChange: function(){}, //动画结束后触发
    slideshowEnd: function(){}, // 本轮循环结束触发
    lastSlide: function(){}, // 最后一张图片播放结束触发
    afterLoad: function(){} // 加载完毕时触发
};
$.fn.nivoSlider.defaults = {
effect: 'random', // 过渡效果
slices: 15, //effect为切片效果时的数量
boxCols: 8, //effect为格子效果时的列
boxRows: 4, //effect为格子效果时的行
animSpeed: 500, //动画速度
pauseTime: 3000, //图片切换速度
startSlide: 0, //从第几张开始
directionNav: true, //是否显示图片切换按钮(上/下页)
directionNavHide: true, //是否鼠标经过才显示
controlNav: true, // 显示序列导航
controlNavThumbs: false, // 显示图片导航
controlNavThumbsFromRel: false, // 使用img的rel属性作为缩略图地址
controlNavThumbsSearch: '.jpg', // 查找特定字符串(controlNavThumbs必须为true)
controlNavThumbsReplace: '_thumb.jpg', // 替换成这个字符(controlNavThumbs必须为true)
keyboardNav: true, // 键盘控制（左右箭头）PS:建议把代码中的keypress换成keydown,因为在Chrome下有兼容问题.
pauseOnHover: true, // 鼠标经过时暂停播放
manualAdvance: false, // 是否手动播放(false为自动播放幻灯片)
captionOpacity: 0.1, // 字幕透明度
prevText: 'Prev',
nextText: 'Next',
randomStart: false, //是否随机图片开始
beforeChange: function(){}, //动画开始前触发
afterChange: function(){}, //动画结束后触发
slideshowEnd: function(){}, // 本轮循环结束触发
lastSlide: function(){}, // 最后一张图片播放结束触发
afterLoad: function(){} // 加载完毕时触发
};
上面的 $.fn.nivoSlider.defaults 是一个默认的设置对象,已经加上了相应的注释.

其中 effect 属性是用来设置动画效果的,分别有以下效果:

random
fold
fade
slideInLeft
slideInRight
sliceDown
sliceDownRight
sliceDownLeft
sliceUp
sliceUpRight
sliceUpLeft
sliceUpDown
sliceUpDownLeft
sliceUpDownRight
boxRandom
boxRain
boxRainReverse
boxRainGrow
boxRainGrowReverse

[javascript]
//Keyboard Navigation
        if(settings.keyboardNav){
            $(window).keypress(function(event){
                //Left
                if(event.keyCode == '37'){
                    if(vars.running) return false;
                    clearInterval(timer);
                    timer = '';
                    vars.currentSlide-=2;
                    nivoRun(slider, kids, settings, 'prev');
                }
                //Right
                if(event.keyCode == '39'){
                    if(vars.running) return false;
                    clearInterval(timer);
                    timer = '';
                    nivoRun(slider, kids, settings, 'next');
                }
            });
        }
//Keyboard Navigation
        if(settings.keyboardNav){
            $(window).keypress(function(event){
                //Left
                if(event.keyCode == '37'){
                    if(vars.running) return false;
                    clearInterval(timer);
                    timer = '';
                    vars.currentSlide-=2;
                    nivoRun(slider, kids, settings, 'prev');
                }
                //Right
                if(event.keyCode == '39'){
                    if(vars.running) return false;
                    clearInterval(timer);
                    timer = '';
                    nivoRun(slider, kids, settings, 'next');
                }
            });
        }

另外,把代码中的keypress换成keydown.

因为在Chrome下有兼容问题,部分按键(包括方向键)无法返回keycode.

下载的代码中,一共有3个主题包.

只要直接修改div的class就可以了.

[html]
<span style="white-space:pre"></span><div class="slider-wrapper theme-default">
    <div class="ribbon"></div>
    <div id="slider" class="nivoSlider">
        <img src="images/toystory.jpg" alt="" />
        <a href="http://dev7studios.com"><img src="images/up.jpg" alt="" title="This is an example of a caption" /></a>
        <img src="images/walle.jpg" alt="" />
        <img src="images/nemo.jpg" alt="" title="#htmlcaption" />
    </div>
    <div id="htmlcaption" class="nivo-html-caption">
        <strong>This</strong> is an example of a <em>HTML</em> caption with <a href="#">a link</a>.
    </div>
</div>
<span style="white-space:pre"></span><div class="slider-wrapper theme-default">
    <div class="ribbon"></div>
    <div id="slider" class="nivoSlider">
        <img src="images/toystory.jpg" alt="" />
        <a href="http://dev7studios.com"><img src="images/up.jpg" alt="" title="This is an example of a caption" /></a>
        <img src="images/walle.jpg" alt="" />
        <img src="images/nemo.jpg" alt="" title="#htmlcaption" />
    </div>
    <div id="htmlcaption" class="nivo-html-caption">
        <strong>This</strong> is an example of a <em>HTML</em> caption with <a href="#">a link</a>.
    </div>
</div>把第一行的div中的类名"theme-default"进行修改,把"default"改为对应的CSS文件名称.(当然,前提是对应的CSS文件已插入页面)

另外,如果像对应的图片附带标题出现,有两种办法.

第一种就是:

[html]
<a href="http://dev7studios.com"><img src="images/up.jpg" alt="" title="This is an example of a caption" /></a>
<a href="http://dev7studios.com"><img src="images/up.jpg" alt="" title="This is an example of a caption" /></a>在img标签中加入title属性.

另一种是:

[html]
<img src="images/nemo.jpg" alt="" title="#htmlcaption" />
<img src="images/nemo.jpg" alt="" title="#htmlcaption" />在title属性中填入对应的ID或者类名,获取下面对应div中的内容.

[html]
<div id="htmlcaption" class="nivo-html-caption">
<span style="white-space:pre"> </span><strong>This</strong> is an example of a <em>HTML</em> caption with <a href="#">a link</a>.
</div>
<div id="htmlcaption" class="nivo-html-caption">
<span style="white-space:pre"> </span><strong>This</strong> is an example of a <em>HTML</em> caption with <a href="#">a link</a>.
</div>

如果要对单独一张图片以特定的效果展示,www.2cto.com

可以在<img>标签中加上data-transition属性,例如:data-transition="slideInLeft"

摘自简生的代码备忘录

0 0