Fancybox是一款用于网页的灯箱插件，支持多种内容展示形式，如图片、HTML文本、Flash动画等，并可自定义播放器的CSS样式及动画效果。本文详细介绍了Fancybox的使用方法及API配置选项。
Fancybox的特点如下：
- 可以支持图片、html文本、flash动画、iframe以及ajax的支持
- 可以自定义播放器的CSS样式
- 可以以组的形式进行播放
- 如果将鼠标滚动插件（mouse wheel plugin）包含进来的话Fancybox还能支持鼠标滚轮滚动来翻阅图片
- Fancybox播放器支持投影，更有立体的感觉
使用方法：
1、引入jquery核心库和Fancybox插件库
|
1
2
|
<script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>
<script type="text/javascript" src="/fancybox/jquery.fancybox-1.3.4.pack.js"></script>
|
可选 - 如果需要用到fancy transition（一些动画效果）你还需要引入以下脚本
|
1
|
<script type="text/javascript" src="/fancybox/jquery.easing-1.4.pack.js"></script>
|
可选 - 如果需要支持鼠标滚轮滚动效果你还需要引入以下脚本
|
1
|
<script type="text/javascript" src="/fancybox/jquery.mousewheel-3.0.4.pack.js"></script>
|
2、添加样式表文件
|
1
|
<link rel="stylesheet" href="/fancybox/jquery.fancybox-1.3.4.css" type="text/css" media="screen" />
|
以下是一个实现小图缩放效果的例子：
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta http-equiv="imagetoolbar" content="no"/>
<title>FancyBox 1.3.1 | Demonstration</title>
<script type="text/javascript" src="js/jquery-1.4.min.js"></script> <!--调用jquery核心库----->
<script type="text/javascript" src="js/jquery.mousewheel-3.0.2.pack.js"></script><!--调用可用鼠标控制的库-->
<script type="text/javascript" src="js/jquery.fancybox-1.3.1.js"></script>
<script type="text/javascript" src="js/pngobject.js"></script> <!--correctly handle PNG transparency in Win IE 5.5 & 6.-->
<link rel="stylesheet" href="style/style.css" type="text/css"/>
<link rel="stylesheet" href="style/jquery.fancybox-1.3.1.css" type="text/css"/>
<script type="text/javascript">
$(document).ready(function() {
/**
运行的代码
*/
$("a[rel=example_group]").fancybox({
'transitionIn' : 'fade', //设置动画效果. 可以设置为 'elastic', 'fade' 或 'none'
'transitionOut' : 'fade', //同上
'titlePosition' : 'over', //设置标题显示的位置.可以设置成 'outside', 'inside' 或 'over'
'titleFormat' : function(title, currentArray, currentIndex, currentOpts) { //可以自定义标题的格式
return '<span id="fancybox-title-over">Image ' + (currentIndex + 1) + ' / ' + currentArray.length + (title.length ? ' ' + title : '') + '</span>';
}
});
<!-------------------------------------以下属于测试代码，不在此例子效果实现的代码内------------------------------------>
/*
* 单独设置每个图片或文件的效果
*/
$("a#example1").fancybox({
'titleShow' : true //是否显示标题
});
$("a#example2").fancybox({
'titleShow' : true,
'transitionIn' : 'elastic',
'transitionOut' : 'elastic'
});
$("a#example3").fancybox({
'titleShow' : true,
'transitionIn' : 'none',
'transitionOut' : 'none'
});
$("a#example4").fancybox();
$("a#example5").fancybox({
'titlePosition' : 'outside'
});
$("a#example6").fancybox({
'titlePosition' : 'outside'
});
/*
* 设置id号为various效果
*/
$("#various1").fancybox({
'titlePosition' : 'over',//标题显示的位置
'transitionIn' : 'none',
'transitionOut' : 'none'
});
$("#various2").fancybox();
$("#various3").fancybox({
'width' : '75%',
'height' : '75%',
'autoScale' : false,
'transitionIn' : 'fade',
'transitionOut' : 'fade',
'type' : 'iframe'
});
$("#various4").fancybox({
'padding' : 0,
'autoScale' : false, //如果为true，fancybox可以自适应浏览器窗口大小
'transitionIn' : 'none',
'transitionOut' : 'none'
});
});
</script>
</head>
<body>
<div id="content">
<h4>jQuery FancyBox 实现点击小图显示大图</h4>
<p>
<a rel="example_group" href="example/4_b.jpg" title="Lorem ipsum dolor sit amet"><img alt="" src="example/4_s.jpg"/></a>
<a rel="example_group" href="example/5_b.jpg" title=""><img alt="" src="example/5_s.jpg"/></a>
<a rel="example_group" href="example/6_b.jpg" title=""><img alt="" src="example/6_s.jpg"/></a>
</p>
<p>
<a rel="example_group" href="example/7_b.jpg" title="Lorem ipsum dolor sit amet"><img alt="" src="example/7_s.jpg"/></a>
<a rel="example_group" href="example/8_b.jpg" title=""><img alt="" src="example/8_s.jpg"/></a>
<a rel="example_group" href="example/9_b.jpg" title=""><img alt="" src="example/9_s.jpg"/></a>
</p>
</div>
<div><p> </p></div>
</body>
</html>
Fancybox的API和配置选项说明
| 属性名 | 默认值 | 简要说明 |
|---|---|---|
| padding | 10 | 浏览框内边距，和css中的padding一个意思 |
| margin | 20 | 浏览框外边距，和css中的margin一个意思 |
| opacity | false | 如果为true，则fancybox在动画改变的时候透明度可以跟着改变 |
| modal | false | 如果为true，则'overlayShow' 会被设成 'true' ， 'hideOnOverlayClick', 'hideOnContentClick', 'enableEscapeButton', 'showCloseButton' 会被设成 'false' |
| cyclic | false | 如果为true，相册会循环播放 |
| scrolling | 'auto' | 设置overflow的值来创建或隐藏滚动条，可以设置成 'auto', 'yes', or 'no' |
| width | 560 | 设置iframe和swf的宽度，如果 'autoDimensions'为 'false'，这也可以设置普通文本的宽度 |
| height | 340 | 设置iframe和swf的高度，如果 'autoDimensions'为 'false'，这也可以设置普通文本的高度 |
| autoScale | true | 如果为true，fancybox可以自适应浏览器窗口大小 |
| autoDimensions | true | 在内联文本和ajax中，设置是否动态调整元素的尺寸，如果为true，请确保你已经为元素设置了尺寸大小 |
| centerOnScroll | false | 如果为true，当你滚动滚动条时，fancybox将会一直停留在浏览器中心 |
| ajax | { } | 和jquery的ajax调用选项一样 注意: 'error' and 'success' 这两个回调事件会被fancybox重写 |
| swf | {wmode: 'transparent'} | swf的设置选项 |
| hideOnOverlayClick | true | 如果为true则点击遮罩层关闭fancybox |
| hideOnContentClick | false | 如果为true则点击播放内容关闭fancybox |
| overlayShow | true | 如果为true，则显示遮罩层 |
| overlayOpacity | 0.3 | 遮罩层的透明度（范围0-1） |
| overlayColor | '#666' | 遮罩层的背景颜色 |
| titleShow | true | 如果为true，则显示标题 |
| titlePosition | 'outside' | 设置标题显示的位置.可以设置成 'outside', 'inside' 或 'over' |
| titleFormat | null | 可以自定义标题的格式 |
| transitionIn, transitionOut | 'fade' | 设置动画效果. 可以设置为 'elastic', 'fade' 或 'none' |
| speedIn, speedOut | 300 | fade 和 elastic 动画切换的时间间隔, 以毫秒为单位 |
| changeSpeed | 300 | 切换时fancybox尺寸的变化时间间隔（即变化的速度），以毫秒为单位 |
| changeFade | 'fast' | 切换时内容淡入淡出的时间间隔（即变化的速度） |
| easingIn, easingOut | 'swing' | 为 elastic 动画使用 Easing |
| showCloseButton | true | 如果为true，则显示关闭按钮 |
| showNavArrows | true | 如果为true，则显示上一张下一张导航箭头 |
| enableEscapeButton | true | 如果为true，则启用ESC来关闭fancybox |
| onStart | null | 回调函数，加载内容是触发 |
| onCancel | null | 回调函数，取消加载内容后触发 |
| onComplete | null | 回调函数，加载内容完成后触发 |
| onCleanup | null | 回调函数，关闭fancybox前触发 |
| onClosed | null | 回调函数，关闭fancybox后触发 |
扫一扫
402
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
