jQuery.KinSlideshow.js 基于 jQuery 的幻灯片插件
jQuery.KinSlideshow.js 是一个实用功能性强的幻灯片插件,通过简单的 HTML 代码,自动生成幻灯片效果,并且插件拥有多个配置参数,能够自定义滑动的方向和渐变效果。
使用事项
焦点图显示的标题为 img 中 alt 属性中的文字当只有一张图片时不显示按钮,但也会有无缝切换效果
兼容 IE6/IE7/IE8/IE9、FireFox、Chrome、Opera 的 jQuery.KinSlideshow 幻灯片插件,功能很多,基本能满足你在网页上使用幻灯片/焦点图效果。
简单调用
使用之前请引入 jQuery 文件和 KinSlideshow 插件文件,然后在文档的底部初始化插件
$(function(){$(“#KinSlideshow”).KinSlideshow();})
需要满足一定结构的 HTML 代码,例如下面的示例,设置一个唯一的 Class 或者 ID 选择器。
所有参数列表
intervalTime:5
设置间隔时间为5秒,单位:秒,默认为5秒
moveSpeedTime:400
切换一张图片所需时间,单位:毫秒,默认为400毫秒
moveStyle:”left”
切换方向可选值: left right up down
left:向左切换right:向右切换up:向上切换down:向下切换,默认向左切换
mouseEvent:”mouseclick”
鼠标操作按钮事件,可选值:mouseclick mouseover
mouseclick:鼠标单击切换。mouseover:鼠标滑过切换。默认为鼠标点击按钮切换
isHasTitleBar:true
是否显示标题背景可选值: true false,默认为 true
titleBar:{titleBarheight:40,titleBarbgColor:”#000000″,titleBaralpha:0.5}
标题背景样式,isHasTitleBar = true 前提下启用。
titleBarheight :40- >标题背景高度。[默认:40]titleBarbgColor:”#000000″- >标题背景颜色。[默认:#000000]titleBaralpha:0.5->标题背景透明度,取值【0~1】。[默认:0.5]
isHasTitleFont:true
是否显示标题文字可选值: true false ,默认为true
titleFont:{TitleFontsize:12,TitleFontcolor:”#FFFFFF”,TitleFontfamily:”Verdana”,TitleFontweight:”bold”}
标题文字样式,isHasTitleFont = true 前提下启用。
TitleFontsize ->标题文字大小单位像素。[默认:12]TitleFontcolor:”#FFFFFF”- >标题文字颜色。[默认:#000000]TitleFontfamily:”Verdana”->标题文字字体。[默认:Verdana]TitleFontweight:”bold”->标题文字粗细。可选值: bold normal,默认:”bold”,normal 正常不加粗。
isHasBtn:true
是否显示按钮
btn:{btnbgColor:”#666666″,btnbgHoverColor:”#CC0000″,btnfontColor:”#CCCCCC”,btnfontHoverColor:”#000000″,btnfontFamily:”Verdana”,btnborderColor:”#999999″,btnborderHoverColor:”#FF0000″,btnborderWidth:1,btnbgAlpha:0.7}//按钮样式设置,(isHasBtn = true 前提下启用)
btnbgColor:”#666666″->按钮背景颜色[默认:”#666666″]。btnbgHoverColor:”#CC0000″->按钮滑过/点击背景颜色[默认:”#CC0000″]。btnfontColor:”#CCCCCC”->按钮文字颜色[默认:”#CCCCCC”]。btnfontHoverColor:”#000000″->按钮滑过/点击按钮文字颜色[默认:”#000000″]。btnfontFamily:”Verdana”,->按钮文字字体[默认:”Verdana”]。btnborderColor:”#999999″->按钮边框颜色[默认:”#999999″]。btnborderHoverColor:”#FF0000″->按钮滑过/点击按钮边框颜色[默认:”#FF0000″]。btnborderWidth:1->按钮边框宽度,单位像素不能超过3[默认:1]。btnbgAlpha:0.7->按钮透明度,取值0~1,[默认:0.7]。
参数调用说明
$(function(){$(“#KinSlideshow”).KinSlideshow({ titleFont:{TitleFontsize:14,TitleFontcolor:”#FF0000″}//设置标题文字大小为14px,颜色:#FF0000//titleFont 其他未设置的使用默认参数设置});})
使用提示
外层 DIV 建议加上一句 style=”visibility:hidden;”样式,不加此句在 IE 下页面刚加载的瞬间时候会看到所有图片原始样子,这是因为 KinSlideshow 要等页面加载完成才能解析页面中要设置成焦点图的 HTML,虽然只有不到0.01秒的瞬间但用户体验不太好,所以建议加上,不加对程序也没影响。想要兼容 Chrome 需要在 img 标签中写上图片的实际宽度和高度,其他浏览器不需要。