JQuery插件FancyBox魔幻灯箱介绍

13年前
采用Mac系统的样式。网传主要有以下功能：
■弹出的窗口有很漂亮的阴影效果。
■关联的对象（就是rel标签的值一样）会成组显示，上面还有导航的按钮（上一项，下一项）。
■可以显示图片、内联、ajax和iframe内容。
■可以通过设置参数和CSS定制效果。
■通过easing插件可以实现fancy transitions效果（就是一些动画效果）。

1.可以支持图片、html文本、flash动画、iframe以及ajax的支持
2.可以自定义播放器的CSS样式
3.可以以组的形式进行播放
4.如果将鼠标滚动插件（mouse wheel plugin）包含进来的话Fancybox还能支持鼠标滚轮滚动来翻阅图片
5.Fancybox播放器支持投影，更有立体的感觉

到官网http://fancybox.net/可以看到更多的效果，我迫不及待地下载了代码研究并翻译下。使用还挺方便，背景遮罩，收缩，淡入淡出等效果，特别是右上角那个可爱的关闭按钮，我很喜欢。弹出的内容不一定是一个图片，也可以是文本，FLASH，一个FRAME，或服务器端某个文件。

代码如下：

[html] view plaincopy
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">  
  2. <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">  
  3. <head>  
  4.     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />  
  5.     <meta http-equiv="imagetoolbar" content="no" />  
  6.     <title>魔幻灯箱 1.3.4版 | 示例</title>  
  7.     <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.4/jquery.min.js"></script>  
  8.     <script>  
  9.         !window.jQuery && document.write('<script src="jquery-1.4.3.min.js"><\/script>');  
  10.     </script>  
  11.     <!--调用可用鼠标控制的库-->  
  12.     <script type="text/javascript" src="./fancybox/jquery.mousewheel-3.0.4.pack.js"></script>  
  13.     <script type="text/javascript" src="./fancybox/jquery.fancybox-1.3.4.pack.js"></script>  
  14.     <link rel="stylesheet" type="text/css" href="./fancybox/jquery.fancybox-1.3.4.css" media="screen" />  
  15.     <link rel="stylesheet" href="style.css" />  
  16.     <script type="text/javascript">  
  17.         $(document).ready(function() {  
  18.               
  19.             //显示单个图片例子  
  20.             $("a#example1").fancybox();  
  21.   
  22.             $("a#example2").fancybox({  
  23.                 'overlayShow'   : false,        //不显示遮罩层，即背景不变暗  
  24.                 'transitionIn'  : 'elastic',    //设置显示图片的动画效果为收缩  
  25.                 'transitionOut' : 'elastic'     //设置关闭图片的动画效果为收缩  
  26.             });  
  27.   
  28.             $("a#example3").fancybox({  
  29.                 'transitionIn'  : 'none',       //不设置动画效果，  
  30.                 'transitionOut' : 'none'        //动画效果有三种形式：elastic（收缩），fade（淡入淡出），none（无）  
  31.             });  
  32.   
  33.             $("a#example4").fancybox({  
  34.                 'opacity'       : true,  
  35.                 'overlayShow'   : false,  
  36.                 'transitionIn'  : 'elastic',  
  37.                 'transitionOut' : 'none'  
  38.             });  
  39.   
  40.             $("a#example5").fancybox();  
  41.   
  42.             $("a#example6").fancybox({  
  43.                 'titlePosition'     : 'outside',//标题在弹出对话框的外侧  
  44.                 'overlayColor'      : '#000',   //遮罩层的背景颜色  
  45.                 'overlayOpacity'    : 0.9       //遮罩层(背景)的透明度，0则背景无变化，1则背景为黑色  
  46.             });  
  47.   
  48.             $("a#example7").fancybox({  
  49.                 'titlePosition': 'inside'      //标题在弹出对话框的内侧，显示图片的下面  
  50.             });  
  51.   
  52.             $("a#example8").fancybox({  
  53.                 'titlePosition': 'over'        //标题浮动在图片上  
  54.             });  
  55.   
  56.             //显示一组图片例子，鼠标在图片上时可以显示上一张下一张导航箭头  
  57.             $("a[rel=example_group]").fancybox({  
  58.                 'transitionIn'      : 'none',  
  59.                 'transitionOut'     : 'none',  
  60.                 'titlePosition'     : 'over',  
  61.                 'titleFormat': function(title, currentArray, currentIndex, currentOpts) {  
  62.   
  63.                     //以【Image 1/4 图片标题内容】形式显示，如果图片没设置title则不显示图片标题内容  
  64.                     return '<span id="fancybox-title-over">Image ' + (currentIndex + 1) + ' / '   
  65.                     + currentArray.length + (title.length ? '   ' + title : '') + '</span>';  
  66.                 }  
  67.             });  
  68.   
  69.             //其他各种应用例子  
  70.             $("#various1").fancybox({  
  71.                 'titlePosition'     : 'inside',  
  72.                 'transitionIn'      : 'none',  
  73.                 'transitionOut'     : 'none'  
  74.             });  
  75.   
  76.             $("#various2").fancybox();  
  77.   
  78.             $("#various3").fancybox({  
  79.                 'width'             : '75%',  
  80.                 'height'            : '75%',  
  81.                 'autoScale'         : false,  
  82.                 'transitionIn'      : 'none',  
  83.                 'transitionOut'     : 'none',  
  84.                 'type'              : 'iframe'  
  85.             });  
  86.   
  87.             $("#various4").fancybox({  
  88.                 'padding'           : 0,  
  89.                 'autoScale'         : false,  
  90.                 'transitionIn'      : 'none',  
  91.                 'transitionOut'     : 'none'  
  92.             });  
  93.         });  
  94.     </script>  
  95. </head>  
  96. <body>  
  97. <div id="content">  
  98.     <h1>魔幻灯箱<span>1.3.4版示例 <a href="http://fancybox.net">官方主页</a></span></h1>  
  99.     <p>  
  100.         不同的动画效果<br />  
  101.         <a id="example1" href="./example/1_b.jpg"><img alt="example1" src="./example/1_s.jpg" /></a>  
  102.         <a id="example2" href="./example/2_b.jpg"><img alt="example2" src="./example/2_s.jpg" /></a>  
  103.         <a id="example3" href="./example/3_b.jpg"><img alt="example3" src="./example/3_s.jpg" /></a>  
  104.         <a id="example4" href="./example/4_b.jpg"><img class="last" alt="example4" src="./example/4_s.jpg" /></a>  
  105.     </p>  
  106.     <p>  
  107.         不同的标题位置<br />  
  108.         <a id="example5" href="./example/5_b.jpg" title="Lorem ipsum dolor sit amet, consectetur adipiscing elit."><img alt="example4" src="./example/5_s.jpg" /></a>  
  109.         <a id="example6" href="./example/6_b.jpg" title="Etiam quis mi eu elit tempor facilisis id et neque. Nulla sit amet sem sapien. Vestibulum imperdiet porta ante ac ornare. Vivamus fringilla congue laoreet."><img alt="example5" src="./example/6_s.jpg" /></a>  
  110.         <a id="example7" href="./example/7_b.jpg" title="Cras neque mi, semper at interdum id, dapibus in leo. Suspendisse nunc leo, eleifend sit amet iaculis et, cursus sed turpis."><img alt="example6" src="./example/7_s.jpg" /></a>  
  111.         <a id="example8" href="./example/8_b.jpg" title="Sed vel sapien vel sem tempus placerat eu ut tortor. Nulla facilisi. Sed adipiscing, turpis ut cursus molestie, sem eros viverra mauris, quis sollicitudin sapien enim nec est. ras pulvinar placerat diam eu consectetur."><img class="last" alt="example7" src="./example/8_s.jpg" /></a>  
  112.     </p>  
  113.     <p>  
  114.         图片浏览(可以用鼠标或鼠标滚轮来切换图片)<br />  
  115.         <a rel="example_group" href="./example/9_b.jpg" title="Lorem ipsum dolor sit amet"><img alt="" src="./example/9_s.jpg" /></a>  
  116.         <a rel="example_group" href="./example/10_b.jpg" title=""><img alt="" src="./example/10_s.jpg" /></a>  
  117.         <a rel="example_group" href="./example/11_b.jpg" title=""><img alt="" src="./example/11_s.jpg" /></a>  
  118.         <a rel="example_group" href="./example/12_b.jpg" title=""><img class="last" alt="" src="./example/12_s.jpg" /></a>  
  119.     </p>  
  120.     <p>  
  121.         其他各种应用示例  
  122.     </p>  
  123.     <ul>  
  124.         <li><a id="various1" href="#inline1" title="Lorem ipsum dolor sit amet">显示一个隐藏的DIV</a></li>  
  125.         <li><a id="various2" href="ajax.txt">用Ajax显示ajax.txt里的内容</a></li>  
  126.         <li><a id="various3" href="http://baidu.com">在Iframe框架里显示内容</a></li>  
  127.         <li><a id="various4" href="http://www.adobe.com/jp/events/cs3_web_edition_tour/swfs/perform.swf">显示FLASH动画</a></li>  
  128.     </ul>  
  129.     <div style="display: none;">  
  130.         <div id="inline1" style="width:400px;height:200px;overflow:auto;">  
  131.             Lorem ipsum dolor sit amet, consectetur adipiscing elit. Etiam quis mi eu elit tempor facilisis id et neque. Nulla sit amet sem sapien. Vestibulum imperdiet porta ante ac ornare. Nulla et lorem eu nibh adipiscing ultricies nec at lacus. Cras laoreet ultricies sem, at blandit mi eleifend aliquam. Nunc enim ipsum, vehicula non pretium varius, cursus ac tortor. Vivamus fringilla congue laoreet. Quisque ultrices sodales orci, quis rhoncus justo auctor in. Phasellus dui eros, bibendum eu feugiat ornare, faucibus eu mi. Nunc aliquet tempus sem, id aliquam diam varius ac. Maecenas nisl nunc, molestie vitae eleifend vel, iaculis sed magna. Aenean tempus lacus vitae orci posuere porttitor eget non felis. Donec lectus elit, aliquam nec eleifend sit amet, vestibulum sed nunc.  
  132.         </div>  
  133.     </div>  
  134.     Ajax例子需要运行到WEB服务器才能看到效果<br />  
  135.     Photo Credit: <a href="http://www.flickr.com/people/kharied/">Katie Harris</a>  
  136. </div>  
  137. </body>  
  138. </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后触发