jQuery插件ColorBox的参数设置 p

官方网站：http://colorpowered.com/colorbox/

支持照片，照片组，幻灯片，ajax，内联和 iframe 框架。
通过CSS 控制外观，使用用户可以很容易重新定制外观。
不需要更改 ColorBox 的 javascript 文件就可以重新设定其行为。
可以依靠 callback & event-hooks 进行拓展，不需要修改源代码。

非常友好，不需要修改现有的 HTML，所有的选项都通过 JS 设置。

介绍

colorbox()函数使用一堆key/value对象和一个可选的callback函数

格式：$('selector').colorbox({key:value}, callback);

例子： $('a.gallery').colorbox({transition:'fade', speed:500});

还是例子：$('button').colorbox({href:"thankyou.html"});

设置的值	默认值	介绍
transition	"elastic"	过渡效果，可以是"elastic", "fade", or "none".
speed	350	设置过渡效果的持续时间，毫秒
href	false	Example:$('h1').colorbox({href:"welcome.html"}) 这个用来设置一个锚标记的值或者一个不是锚的元素，例如图像或者表单的按钮，例如：
title	false	这可以为Colorbox设置一个标题
rel	false	Example:$('#example a').colorbox({rel:'group1'}) 这个可以根据元素的rel属性设置要显示的元素集合，也可以覆盖一个存在的rel属性
width	false	Example: "100%", "500px", or 500 设置宽度，包括边框和按钮
height	false	Example: "100%", "500px", or 500 设置高度，包括边框和按钮
innerWidth	false	Example: "50%", "500px", or 500 这个可以设定一个固定的内大小，包括边框和按钮
innerHeight	false	Example: "50%", "500px", or 500 这个可以设定一个固定的内高度，包括边框和按钮
initialWidth	300	设置初始化宽度
initialHeight	100	设置初始化高度
maxWidth	false	Example: "100%", 500, "500px" 设置内容的最大宽度
maxHeight	false	Example: "100%", 500, "500px" 设置内容的最大高度
scalePhotos	true	如果是true且maxWidth, maxHeight, innerWidth, innerHeight, width, 或者 height 被设置， Colorbox会缩放图片以使用边框
scrolling	true	如果是false,Colorbox不会为了溢出元素设置滚动条
iframe	false	如果是true，元素会在Iframe中显示
inline	false	Example: $("#inline").colorbox({inline:true, href:"#myForm"}); 如果是true,jQuery选择器可以用来选择要显示的元素。例如：
html	false	Example: $.fn.colorbox({html:' 这个是直接让你显示HTML代码，例 Hello '});
photo	false	如果为true，ColorBox只会把元素按照图片显示，防止类似photo.php?pic=1这样的连接被误认为是网页
opacity	0.85	遮罩层不透明度从0-1之间取值
open	false	如果为true,ColorBox会自动开启
preloading	true	如果为True,ColorBox会自动预载要显示图片
overlayClose	true	为true单击遮罩层就可以把ColorBox关闭
slideshow	false	为True，会自动滚动图片
slideshowSpeed	2500	设置时间，毫秒
slideshowAuto	true	为tuue，滑动会自动开始
slideshowStart	"start slideshow"	开始自动滑动按钮的文本
slideshowStop	"stop slideshow"	停止自动滑动按钮的文本
current	"{current} of {total}"	文本内容：现在正在显示的元素序号
previous	"previous"	“上一个”按钮的文本
next	"next"	“下一个”按钮的文本
close	"close"	“关闭”按钮的文本

一. Colorbox插件介绍

jQuery Colorbox是一款非常好的内容播放插件。它集弹出层、幻灯片播放功能于一身，不仅于此，它还支持其它的内容格式：例如html, flash, iframe等，这些内容的显示方式都是Ajax的。更难能可贵的是，在压缩后它只有10K的大小，使用这款插件不会给你的网页带来过多的负担，而且还能实现很棒的视觉效果，为用户体验增色不少。

本文已经同步至我的个人博客站点：积累吧 | jQuery Colorbox插件

Colorbox项目的主页地址是：http://www.jacklmoore.com/colorbox
项目主页中提供了5种不同样式的Example：

Example 1：http://www.jacklmoore.com/colorbox/example1/
Example 2：http://www.jacklmoore.com/colorbox/example2/
Example 3：http://www.jacklmoore.com/colorbox/example3/
Example 4：http://www.jacklmoore.com/colorbox/example4/
Example 5：http://www.jacklmoore.com/colorbox/example5/

每一个Example中都提供了以下效果：

Elastic Transition（弹性动画）
Fade Transition（淡入淡出动画）
No transition + fixed width and height 75% of screen size (无动画，宽高以屏幕的75%自适应)
Slideshow（幻灯片播放）
Other Content Types （其它类型：外部html, flash和视频，iframe的flash和视频，iframe的外部html，内部html）

二. Colorbox插件使用

在使用colorbox之前，先看看基本的效果图吧。（本博客已经使用了colorbox插件的最新版本，您也可以直接点击图片看到效果哦。）

易于使用也是Colorbox的众多优点之一，它的代码调用非常之简洁。

1. 引入jquery和colorbox的js文件

<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script src="colorbox/jquery.colorbox.js"></script>

2. 引入colorbox的css文件

<link media="screen" rel="stylesheet" href="colorbox\colorbox.css" />

3. html代码

<body>
        <h1>ColorBox演示</h1>
        
        <h2>弹性效果</h2>
        <p><a class="group1" data-rel='hi' href="../content/ohoopee1.jpg" title="Me and my grandfather on the Ohoopee.">Grouped Photo 1</a></p>
        <p><a class="group1" href="../content/ohoopee2.jpg" title="On the Ohoopee as a child">Grouped Photo 2</a></p>
        <p><a class="group1" href="../content/ohoopee3.jpg" title="On the Ohoopee as an adult">Grouped Photo 3</a></p>
    </body>

4. 调用colorbox的代码

<script>
    $(document).ready(function(){
        //元素调用Colorbox的示例
        $(".group1").colorbox({ rel: 'group1' });
    });
</script>

5. 最简单示例的完整代码

以上是如何使用的每一个步骤，这里是对上面4个步骤的整合后的完整示例。

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
    <head>
        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
        <title>ColorBox 示例</title>
        <link rel="stylesheet" href="colorbox/colorbox.css" />
        <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
        <script src="colorbox/jquery.colorbox.js"></script>
<script>
    $(document).ready(function(){
        //元素调用Colorbox的示例
        $(".group1").colorbox({ rel: 'group1' });
    });
</script>
    </head>
    <body>
        <h1>ColorBox演示</h1>
        
        <h2>弹性效果</h2>
        <p><a class="group1" data-rel='hi' href="../content/ohoopee1.jpg" title="Me and my grandfather on the Ohoopee.">Grouped Photo 1</a></p>
        <p><a class="group1" href="../content/ohoopee2.jpg" title="On the Ohoopee as a child">Grouped Photo 2</a></p>
        <p><a class="group1" href="../content/ohoopee3.jpg" title="On the Ohoopee as an adult">Grouped Photo 3</a></p>
    </body>
</html>

三、将它整合到Wordpress中

众多使用wordpress的朋友可能比较关心如何将colorbox插件整合到wordpress中去，而不需要到wordpress官方网站上搜索这类插件去安装。

1. 目录结构变更

在colorbox项目主页中下载完插件后，打开它，可以看到它的目录结构如下两幅图

这样的目录结构直接放到wordpress下明显不够合理，在当前目录结构下创建一个文件夹colorbox

然后将images文件夹、colorbox.css、jquery.colorbox.js、jquery.colorbox-min.js文件放到colorbox文件夹中

2. 将colorbox文件夹放到主题文件夹下

3. 修改header.php文件

在<head></head>之间添加下面的代码：

<link rel="stylesheet" href="http://www.jileiba.com/wp-content/themes/h/colorbox/colorbox.css" type="text/css" media="screen" />
<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script>
<script type="text/javascript" src="<?php bloginfo('stylesheet_directory');?>/colorbox/jquery.colorbox-min.js"></script>
<script type="text/javascript">
    jQuery(function ($) {
        $("a[rel=ignition]").colorbox({ rel: 'ignition' });
    });
</script>

转自：http://www.cnblogs.com/keepfool/archive/2012/05/26/2519365.html