您的位置:首页 > Web前端 > JQuery

Nivo Slider 简要使用文档(jQuery幻灯片插件)

2014-09-28 10:03 573 查看
转自:http://www.2cto.com/kf/201202/119195.html
源码:http://download.csdn.net/download/chelen_jak/7310887
教程:http://designmodo.com/image-slider-jquery-css3/ 

演示: http://demo.dev7studios.com/nivo-slider/demo-1/

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"

 摘自 简生的代码备忘录
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: