JQuery弹出窗口小插件ColorBox

　　今天在博客园看到一篇《ASP.NET MVC+Colorbox做的一个Demo(一)》的文章。看了效果，给人很舒服的感觉。立马我也照着他的示例做了。但做了很久没有成功。后来我到官方下载了ColorBox，里面附带了示例。看了一会儿，就自己模仿着示例做了一个基本的ColorBox弹出页面的效果。

　　说道ColorBox,还是先来介绍一下它吧。

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

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

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

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

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

　　　　支持 照片，照片组，幻灯片，ajax，内联 和 iframe 框架。

　　　　通过CSS 控制外观，使用用户可以很容易重新定制外观。

　　　　不需要更改 ColorBox 的 javascript 文件就可以重新设定其行为。

　　　　可以依靠 callback & event-hooks 进行拓展，不需要修改源代码。

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

　　现在我来说说我使用ColorBox的步骤吧：其实使用ColorBox很简单

　　1.当然，创建项目。这里就不多说了。

　　2.在需要使用ColorBox的地方引用ColorBox的JS文件和css样式文件。

　　ps:从官方下载ColorBox解压后得到colorbox文件夹，colorbox文件夹下包含了colorbox、content、demos、example1至example5等文件夹和文件。这里需要把colorbox文　　　　　　　　　　　　      件夹下的两个JS文件拷贝到项目中，example1至example5这几个文件夹中是ColorBox的皮肤文件，比如你喜欢example1文件夹下的皮肤，就将文件夹下的images文件和  colorbox.css样式表拷贝到项目中。在需要使用ColorBox的地方引用jquery.colorbox.js、colorbox.css；当然不能忘了JQuery的JS文件jquery.min.js（注意：jquery.min.js需放在jquery.colorbox.js的前面）。到此，我们的准备工作就做好了。

　　3. 添加<script>逻辑。

　　ps:<script type="text/javascript">
        　　function goColorBox() {
            　　$("#goOne").colorbox({ width: "50%", height:"50%", close: "关闭", overlayClose: false}); <!--调用colorbox，大括号里面是指定该colorbox的属性。。在文章结尾会列出ColorBox的常用属性-->
        　　}
    　　</script>

 

代码如下：

 

<%@ Page Language="C#" MasterPageFile="~/Views/Shared/Site.Master" Inherits="System.Web.Mvc.ViewPage" %>



<asp:Content ID="Content1" ContentPlaceHolderID="TitleContent" runat="server">
    主页
</asp:Content>
<asp:Content ID="Content3" ContentPlaceHolderID="HeadContent" runat="server">
    <link href="http://www.cnblogs.com/ColorBox/skin4/colorbox.css" rel="stylesheet" type="text/css" />
    <script src="http://www.cnblogs.com/ColorBox/js/jquery.min.js" type="text/javascript"></script>
    <script src="http://www.cnblogs.com/ColorBox/js/jquery.colorbox.js" type="text/javascript"></script>
    
    <!--<script src="http://www.cnblogs.com/Scripts/jquery-1.4.1.min.js" type="text/javascript"></script>-->
    <script type="text/javascript">
        function goColorBox() {
              $("#goOne").colorbox({ width: "50%", height:"50%", close: "关闭", overlayClose: false});
        }
    </script>
</asp:Content>

<asp:Content ID="Content2" ContentPlaceHolderID="MainContent" runat="server">

    <h2><%: ViewData["Message"] %></h2>
    <p>
        若要了解有关 ASP.NET MVC 的更多信息，请访问 <a href="http://asp.net/mvc" title="ASP.NET MVC 网站">http://asp.net/mvc</a>。
        <a href="ColorBox/NewView/Index" onclick="goColorBox()" id="goOne" class="goOne" style="font-size:32px">ColorBox</a>

    </p>
</asp:Content>

 

 

 

ColorBox常用属性：

 

 

 

设置的值	默认值	介绍
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:' Hello '}); 这个是直接让你显示HTML代码，例
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 1.3 的轻量级，自定义灯箱插件，功能非常强大，支持图片，图片组，ajax，inline和iframed内容，灯箱样式完全由用户控制，可自定义CSS样 式，不需要改写ColorBox库文件就能重写展示效果设置，支持加载预处理提示等等，效果图如下：

在线演示：http://runjs.cn/detail/hjor2zox

使用说明
1，jQuery 1.3库文件
2，colorbox 库文件
3，灯箱效果CSS样式文件

使用实例如下：
一，使用ColorBox灯箱显示一张图片和图片组
(1)js部分
$.fn.colorbox.settings.transition = "fade";
$.fn.colorbox.settings.bgOpacity = "0.9";
$.fn.colorbox.settings.contentCurrent = "image {current} of {total}";
$(".cpModal").colorbox();

transition设置ColorBox灯箱的过渡效果，如上：fade
bgOpacity设置ColorBox灯箱的背景透明度，如上：0.9
contentCurrent设置ColorBox灯箱的当前图片，如上：image {current} of {total}

(2)HTML部分
<p><a class="cpModal" href="marylou.jpg" >单张图片</a></p>
<p><a class="cpModal" href="biuuu1.jpg" >图片组1</a></p>
<p><a class="cpModal" href="biuuu2.jpg" >图片组2</a></p>
<p><a class="cpModal" href="biuuu3.jpg" >图片组3</a></p>

二，使用ColorBox灯箱显示ajax加载HTML页面
(1)js部分
$("#ajax").colorbox({contentWidth:"300px", contentHeight:"195px"});

contentWidth设置ColorBox灯箱的内容宽度，如上：300px
contentHeight设置ColorBox灯箱的内容高度，如上：195px

(2)HTML部分
<p><a id="ajax" href="ajax.html">Ajax HTML</a></p>
ajax.html表示加载的html页面，

三，使用ColorBox灯箱显示flash页面效果
(1)js部分
$("#flash").colorbox({contentAjax:"flash.html"});

(2)HTML部分

<p><a id="flash" href="http://www.youtube.com/watch?v=lBvaHZIrt0">Flash / Video</a></p>
四，使用ColorBox灯箱显示Inline HTML效果
(1)js部分
$("#inline").colorbox({contentWidth:"500px", contentInline:"#inline-content"});
contentInline设置ColorBox灯箱的inline内容

(2)HTML部分
<p><a id="inline" href="#">Inline HTML</a></p>
<div style="display:none">
<div id="inline-content">
<div style="padding:10px">
<p>必优博客</p>
<p>www.biuuu.com</p>
</div>
</div>
</div>
五，使用ColorBox灯箱显示Iframed框架内容效果
(1)js部分
$("#google").colorbox({contentWidth:"750px", contentHeight:"450px", contentIframe:true});

contentIframe设置ColorBox灯箱的内容是否为框架

(2)HTML部分
<p><a id="google" href="http://www.google.com">Iframed内容</a></p>

ColorBox灯箱配置如下：
transition 'elastic' 表示灯箱过渡效果，可选"elastic" or "fade"
transitionSpeed    350 表示灯箱过渡效果展示的速度
initialWidth    300 表示灯箱初始化宽度
initialHeight    100 表示灯箱初始化高度
contentWidth    false 表示是否设置一个固定的宽度
contentHeight    false 表示是否设置一个固定的高度
contentAjax    false 表示是否是一个ajax加载
contentInline    false 表示是否是一个inline
contentIframe    false 表示是否是一个iframe
bgOpacity 0.85 表示灯箱的背景透明度
preloading    true 表示是否预加载
contentCurrent    '{current} of {total}' 表示灯箱展示的当前图片和总数
contentPrevious    'previous' 表示上一个锚，类似于rel属性
contentNext    'next'    表示下一个锚，类似于rel属性
modalClose    'close' 锚文本关闭链接，可选Esc或close

jQuery插件ColorBox彩盒使用非常简单，可实现功能非常多，如弹出新窗口，弹出图片，弹出框架等等，值得推荐。