Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 319 lines (248 sloc) 22.274 kb
f857434 version 1.3.19
Jack Moore authored
1 ## About ColorBox:
2 A customizable lightbox plugin for jQuery. See the [project page](http://jacklmoore.com/colorbox/) for documentation and a demonstration, and the [FAQ](http://jacklmoore.com/colorbox/faq/) for solutions and examples to common issues. Released under the [MIT license](http://www.opensource.org/licenses/mit-license.php).
d854876 fixed keydown event for webkit
Jack Moore authored
3
f857434 version 1.3.19
Jack Moore authored
4 ## Changelog:
5
6 ### Version 1.3.19 - December 08 2011
7 Files Changed:jquery.colorbox.js/jquery.colorbox-min.js, colorbox.css (all)
8
9 * Fixed bug related to using the 'fixed' property.
10 * Optimized the setup procedure to be more efficient.
11 * Removed $.colorbox.init() as it will no longer be needed (will self-init when called).
12 * Removed use of $.browser.
13
14 ### Version 1.3.18 - October 07 2011
15 Files Changed:jquery.colorbox.js/jquery.colorbox-min.js, colorbox.css (all) and example 1's controls.png
16
17 * Fixed a regression where Flash content displayed in ColorBox would be reloaded if the browser window was resized.
18 * Added safety check to make sure that ColorBox's markup is only added to the DOM a single time, even if $.colorbox.init() is called multiple times. This will allow site owners to manually initialize ColorBox if they need it before the DOM has finished loading.
19 * Updated the example index.html files to be HTML5 compliant.
20 * Changed the slideshow behavior so that it immediately moves to the next slide when the slideshow is started.
21 * Minor regex bugfix to allow automatic detection of image URLs that include fragments.
22
23 ### Version 1.3.17 - May 11 2011
24 Files Changed:jquery.colorbox.js/jquery.colorbox-min.js
25
26 * Added properties "top", "bottom", "left" and "right" to specify a position relative to the viewport, rather than using the default centering.
27 * Added property "data" to specify GET or POST data when using Ajax. ColorBox's ajax functionality is handled by jQuery's .load() method, so the data property works the same way as it does with .load().
28 * Added property "fixed" which can provide fixed positioning for ColorBox, rather than absolute positioning. This will allow ColorBox to remain in a fixed position within the visitors viewport, despite scrolling. IE6 support for this was not added, it will continue to use the default absolute positioning.
29 * Fixed ClearType problem with IE7.
30 * Minor fixes.
31
32 ### Version 1.3.16 - March 01 2011
33 Files Changed:jquery.colorbox.js/jquery.colorbox-min.js, colorbox.css (all) and example 4 background png files
34
35 * Better IE related transparency workarounds. IE7 and up now uses the same background image sprite as other browsers.
36 * Added error handling for broken image links. A message will be displayed telling the user that the image could not be loaded.
37 * Added new property: 'fastIframe' and set it to true by default. Setting to fastIframe:false will delay the loading graphic removal and onComplete event until iframe has completely loaded.
38 * Ability to redefine $.colorbox.close (or prev, or next) at any time.
39
40 ### Version 1.3.15 - October 27 2010
41 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
42
43 * Minor fixes for specific cases.
44
45 ### Version 1.3.14 - October 27 2010
46 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
47
48 * In IE6, closing an iframe when using HTTPS no longer generates a security warning.
49
50 ### Version 1.3.13 - October 22 2010
51 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
52
53 * Changed the index.html example files to use YouTube's new embedded link format.
54 * By default, ColorBox returns focus to the element it was launched from once it closes. This can now be disabled by setting the 'returnFocus' property to false. Focus was causing problems for some users who had their anchor elements inside animated containers.
55 * Minor bug fix involved in using a combination of slideshow and non-slideshow content.
56
57 ### Version 1.3.12 - October 20 2010
58 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
59
60 * Minor bug fix involved in preloading images when using a function as a value for the href property.
61
62 ### Version 1.3.11 - October 19 2010
63 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
64
65 * Fixed the slideshow functionality that broke with 1.3.10
66 * The slideshow now respects the loop property.
67
68 ### Version 1.3.10 - October 16 2010
69 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
70
71 * Fixed compatibility with jQuery 1.4.3
72 * The 'open' property now accepts a function as a value, like all of the other properties.
73 * Preloading now loads the correct href for images when using a dynamic (function) value for the href property.
74 * Fixed bug in Safari 3 for Win where ColorBox centered on the document, rather than the visitor's viewport.
75 * May have fixed an issue in Opera 10.6+ where ColorBox would rarely/randomly freeze up while switching between photos in a group.
76 * Some functionality better encapsulated & minor performance improvements.
77
78 ### Version 1.3.9 - July 7 2010
79 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js/ all colorbox.css (the core styles)
80
81 * Fixed a problem where iframed youtube videos would cause a security alert in IE.
82 * More code is event driven now, making the source easier to grasp.
83 * Removed some unnecessary style from the core CSS.
84
85 ### Version 1.3.8 - June 21 2010
86 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
87
88 * Fixed a bug in Chrome where it would sometimes render photos at 0 by 0 width and height (behavior introduced in recent update to Chrome).
89 * Fixed a bug where the onClosed callback would fire twice (only affected 1.3.7).
90 * Fixed a bug in IE7 that existed with some iframed websites that use JS to reposition the viewport caused ColorBox to move out of position.
91 * Abstracted the identifiers (HTML ids & classes, and JS plugin name, method, and events) so that the plugin can be easily rebranded.
92 * Small changes to improve either code readability or compression.
93
94 ### Version 1.3.7 - June 13 2010
95 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js/index.html
96
97 * $.colorbox can now be used for direct calls and accessing public methods. Example: $.colorbox.close();
98 * Resize now accepts 'width', 'innerWidth', 'height' and 'innerHeight'. Example: $.colorbox.resize({width:"100%"})
99 * Added option (loop:false) to disable looping in a group.
100 * Added options (escKey:false, arrowKey:false) to disable esc-key and arrow-key bindings.
101 * Added method for removing ColorBox from a document: $.colorbox.remove();
102 * Fixed a bug where iframed URLs would be truncated if they contained an unencoded apostrophe.
103 * Now uses the exact href specified on an anchor, rather than the version returned by 'this.href'. This was causing "#example" to be normalized to "http://domain/#example" which interfered with how some users were setting up links to inline content.
104 * Changed example documents over to HTML5.
105
106 ### Version 1.3.6 - Jan 13 2010
107 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
108
109 * Small change to make ColorBox compatible with jQuery 1.4
110
111 ### Version 1.3.5 - December 15 2009
112 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
113
114 * Fixed a bug introduced in 1.3.4 with IE7's display of example 2 and 3, and auto-width in Opera.
115 * Fixed a bug introduced in 1.3.4 where colorbox could not be launched by triggering an element's click event through JavaScript.
116 * Minor refinements.
117
118 ### Version 1.3.4 - December 5 2009
119 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
120
121 * Event delegation is now used for elements that ColorBox is assigned to, rather than individual click events.
122 * Additional callbacks have been added to represent other stages of ColorBox's lifecycle. Available callbacks, in order of their execution: onOpen, onLoad, onComplete, onCleanup, onClosed These take place at the same time as the event hooks, but will be better suited than the hooks for targeting specific instances of ColorBox.
123 * Ajax content is now immediately added to the DOM to be more compatible if that content contains script tags.
124 * Focus is now returned to the calling element on closing.
125 * Fixed a bug where maxHeight and maxWidth did not work for non-photo content.
126 * Direct calls no longer need 'open:true', it is assumed. Example: `$.fn.colorbox({html:'<p>Hi</p>'});`
127
128 ### Version 1.3.3 - November 7 2009
129 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
130
131 * Changed $.fn.colorbox.element() to return a jQuery object rather the DOM element.
132 * jQuery.colorbox-min.js is compressed with Google's Closure Compiler rather than YUI Compressor.
133
134 ### Version 1.3.2 - October 27 2009
135 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
136
137 * Added 'innerWidth' and 'innerHeight' options to allow people to easily set the size dimensions for ColorBox, without having to anticipate the size of the borders and buttons.
138 * Renamed 'scrollbars' option to 'scrolling' to be in keeping with the existing HTML attribute. The option now also applies to iframes.
139 * Bug fix: In Safari, positioning occassionally incorrect when using '100%' dimensions.
140 * Bug fix: In IE6, the background overlay is briefly not full size when first viewing.
141 * Bug fix: In Firefox, opening ColorBox causes a split second shift with a small minority of webpage layouts.
142 * Simplified code in a few areas.
143
144 ### Version 1.3.1 - September 16 2009
145 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js/colorbox.css/colorbox-ie.css(removed)
146
147 * Removed the IE-only stylesheets and conditional comments for example styles 1 & 4. All CSS is handled by a single CSS file for all examples.
148 * Removed user-agent sniffing from the js and replaced it with feature detection. This will allow correct rendering for visitors masking their agent type.
149
150 ### Version 1.3.0 - September 15 2009
151 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js/colorbox.css
152
153 * Added $.fn.colorbox.resize() method to allow ColorBox to resize it's height if it's contents change.
154 * Added 'scrollbars' option to allow users to turn off scrollbars when using the resize() method.
155 * Renamed the 'resize' option to be less ambiguous. It's now 'scalePhotos'.
156 * Renamed the 'cbox_close' event to be less ambiguous. It's now 'cbox_cleanup'. It is the first thing to happen in the close method while the 'cbox_closed' event is the last to happen.
157 * Fixed a bug with the slideshow mouseover graphics that appeared after ColorBox is opened a 2nd time.
158 * Fixed a bug where ClearType may not work in IE6&7 if using the fade transition.
159 * Minor code optimizations to increase compression.
160
161 ### Version 1.2.9 - August 7 2009
162 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
163
164 * Minor change to enable use with $.getScript();
165 * Minor change to the timing of the 'cbox_load' event so that it is more useful.
166 * Added a direct link to a YouTube video to the examples.
167
168 ### Version 1.2.8 - August 5 2009
169 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
170
171 * Fixed a bug with the overlay in IE6
172 * Fixed a bug where left & right keypress events might be prematurely unbound.
173
174 ### Version 1.2.7 - July 31 2009
175 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js, example stylesheets and background images (core styles have not changed and the updates will not affect existing user themes / old example themes)
176
177 * Code cleanup and reduction, better organization and documentation in the full source.
178 * Added ability to use functions in place of static values for ColorBox's options (thanks Ken!).
179 * Added an option for straight HTML. Example: `$.fn.colorbox({html:'<p>Howdy</p>', open:true})`
180 * Added an event for the beginning of the closing process. This is in addition to the event that already existed for when ColorBox had completely closed. 'cbox_close' and 'cbox_closed' respectively.
181 * Fixed a minor bug in IE6 that would cause a brief content shift in the parent document when opening ColorBox.
182 * Fixed a minor bug in IE6 that would reveal select elements that had a hidden visibility after closing ColorBox.
183 * The 'esc' key is unbound now when ColorBox is not open, to avoid any potential conflicts.
184 * Used background sprites for examples 1 & 4. Put IE-only (non-sprite) background images in a separate folder.
185 * Example themes 1, 3, & 4 received slight visual tweaks.
186 * Optimized pngs for smaller file size.
187 * Added slices, grid, and correct sizing to the Adobe Illustrator file, all theme files are now export ready!
188
189 ### Version 1.2.6 - July 15 2009
190 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
191
192 * Fixed a bug with fixed width/height images in Opera 9.64.
193 * Fixed a bug with trying to set a value for rel during a direct call to ColorBox. Example: `$.fn.colorbox({rel:'foo', open:true});`
194 * Changed how href/rel/title settings are determined to avoid users having to manually update ColorBox settings if they use JavaScript to update any of those attributes, after ColorBox has been defined.
195 * Fixed a FF3 bug where the back button was disabled after closing an iframe.
196
197 ### Version 1.2.5 - June 23 2009
198 Files Changed: jquery.colorbox.js/jquery.colorbox-min.js
199
200 * Changed the point at which iframe srcs are set (to eliminate the need to refresh the iframe once it has been added to the DOM).
201 * Removed unnecessary return values for a very slight code reduction.
202
203 ### Version 1.2.4 - June 9 2009
204 Files Changed: jquery.colorbox.js, jquery.colorbox-min.js
205
206 * Fixed an issue where ColorBox may not close completely if it is closed during a transition animation.
207 * Minor code reduction.
208
209 ### Version 1.2.3 - June 4 2009
210 * Fixed a png transparency stacking issue in IE.
211 * More accurate Ajax auto-sizing if the user was depending on the #cboxLoadedContent ID for CSS styling.
212 * Added a public function for returning the current html element that ColorBox is associated with. Example use: var that = $.fn.colorbox.element();
213 * Added bicubic scaling for resized images in the original IE7.
214 * Removed the IE6 stylesheet and png files from Example 3. It now uses the same png file for the controls that the rest of the browsers use (an alpha transparency PNG8). This example now only has 2 graphics files and 1 stylesheet.
215
216 ### Version 1.2.2 - May 28 2009
217 * Fixed an issue with the 'resize' option.
218
219 ### Version 1.2.1 - May 28 2009
220 * Note: If you are upgrading, update your jquery.colorbox.js and colorbox.css files.
221 * Added photo resizing.
222 * Added a maximum width and maximum height. Example: {height:800, maxHeight:'100%'}, would allow the box to be a maximum potential height of 800px, instead of a fixed height of 800px. With maxHeight of 100% the height of ColorBox cannot exceed the height of the browser window.
223 * Added 'rel' setting to add the ability to set an alternative rel for any ColorBox call. This allows the user to group any combination of elements together for a gallery, or to override an existing rel. attribute so those element are not grouped together, without having to alter their rel in the HTML.
224 * Added a 'photo' setting to force ColorBox to display a link as a photo. Use this when automatic photo detection fails (such as using a url like 'photo.php' instead of 'photo.jpg', 'photo.jpg#1', or 'photo.jpg?pic=1')
225 * Removed the need to ever create disposable elements to call colorbox on. ColorBox can now be called directly, without being associated with any existing element, by using the following format:
226 `$.fn.colorbox({open:true, href:'yourLink.xxx'});`
227 * ColorBox settings are now persistent and unique for each element. This allows for extremely flexible options for individual elements. You could use this to create a gallery in which each page in the gallery has different settings. One could be a photo with a fade transition, next could be an inline element with an elastic transition with a set width and height, etc.
228 * For user callbacks, 'this' now refers to the element colorbox was opened from.
229 * Fixed a minor grouping issue with IE6, when transition type is set to 'none'.
230 * Added an Adobe Illustrator file that contains the borders and buttons used in the various examples.
231
232 ### Version 1.2 - May 13 2009
233 * Added a slideshow feature.
234 * Added re-positioning on browser resize. If the browser is resized, ColorBox will recenter itself onscreen.
235 * Added hooks for key events: cbox_open, cbox_load, cbox_complete, cbox_closed.
236 * Fixed an IE transparency-stacking problem, where transparent PNGs would show through to the background overlay.
237 * Fixed an IE iframe issue where the ifame might shift up and to the left under certain circumstances.
238 * Fixed an IE6 bug where the loading overlay was not at full height.
239 * Removed the delay in switching between same-sized gallery content when using transitions.
240 * Changed how iframes are loaded to make it more compatible with iframed pages that use DOM dependent JavaScript.
241 * Changed how the JS is structured to be better organized and increase compression. Increased documentation.
242 * Changed CSS :hover states to a .hover class. This sidesteps a minor IE8 bug with css hover states and allows easier access to hover state user styles from the JavaScript.
243 * Changed: elements added to the DOM have new ID's. The naming is more consistent and less likely to cause conflicts with existing website stylesheets. All stylesheets have been updated.
244 * Changed the behavior for prev/next links so that ColorBox does not get hung up on broken links. A visitor can now skip through broken or long-loading links by clicking prev/next buttons.
245 * Changed the naming of variables in the parameter map to be more concise and intuitive.
246 * Removed colorbox.css. Combined the colorbox.css styles with jquery.colorbox.js: the css file was not large enough to warrant being a separate file.
247
248 ### Version 1.1.6 - April 28 2009
249 * Prevented the default action of the next & previous anchors and the left and right keys for gallery mode.
250 * Fixed a bug where the title element was being added back to the DOM when closing ColorBox while using inline content.
251 * Fixed a bug where IE7 would crash for example 2.
252 * Smaller filesize: removed a small amount of unused code and rewrote the HTML injection with less syntax.
253 * Added a public method for closing ColorBox: $.fn.colorbox.close(). This will allow iframe users to add an event to close ColorBox without having to create an additional function.
254
255 ### Version 1.1.5 - April 11 2009
256 * Fixed minor issues with exiting ColorBox.
257
258 ### Version 1.1.4 - April 08 2009
259 * Fixed a bug in the fade transition where ColorBox not close completely if instructed to close during the fade-in portion of the transition.
260
261 ### Version 1.1.3 - April 06 2009
262 * Fixed an IE6&7 issue with using ColorBox to display animated GIFs.
263
264 ### Version 1.1.2 - April 05 2009
265 * Added ability to change content when ColorBox is already open.
266 * Added vertical photo centering now works for all browsers (this feature previously excluded IE6&7).
267 * Added namespacing to the esc-key keydown event for people who want to disable it: "keydown.colorClose"
268 * Added 'title' setting to add the ability to set an alternative title for any ColorBox call.
269 * Fixed rollover navigation issue with IE8. (Added JS-based rollover state due to a browser-bug.)
270 * Fixed an overflow issue for when the fixed width/height is smaller than the size of a photo.
271 * Fixed a bug in the fade transition where the border would still come up if ColorBox was closed mid-transition.
272 * Switch from JSMin to Yui Compressor for minification. Minified code now under 7KB.
273
274 ### Version 1.1.1 - March 31 2009
275 * More robust image detection regex. Now detects image file types with url fragments and/or query strings.
276 * Added 'nofollow' exception to rel grouping.
277 * Changed how images are loaded into the DOM to prevent premature size calculation by ColorBox.
278 * Added timestamp to iframe name to prevent caching - this was a problem in some browsers if the user had multiple iframes and the visitor left the page and came back, or if they refreshed the page.
279
280 ### Version 1.1.0 - March 21 2009
281 * Animation is now much smoother and less resource intensive.
282 * Added support for % sizing.
283 * Callback option added.
284 * Inline content now preserves JavaScript events, and changes made while ColorBox is open are also preserved.
285 * Added 'href' setting to add the ability to set an alternative href for any anchor, or to assign the ColorBox event to non-anchors.
286 Example: $('button').colorbox({'href':'process.php'})
287 Example: $('a[href='http://msn.com']).colorbox({'href':'http://google.com', iframe:true});
288 * Photos are now horizontally centered if they are smaller than the lightbox size. Also vertically centered for browsers newer than IE7.
289 * Buttons in the examples are now included in the 'protected zone'. The lightbox will never expand it's borders or buttons beyond an accessible area of the screen.
290 * Keypress events don't queue up by holding down the arrow keys.
291 * Added option to close ColorBox by clicking on the background overlay.
292 * Added 'none' transition setting.
293 * Changed 'contentIframe' and 'contentInline' to 'inline' and 'iframe'. Removed 'contentAjax' because it is automatically assumed for non-image file types.
294 * Changed 'contentWidth' and 'contentHeight' to 'fixedWidth' and 'fixedHeight'. These sizes now reflect the total size of the lightbox, not just the inner content. This is so users can accurately anticipate % sizes without fear of creating scrollbars.
295 * Clicking on a photo will now switch to the next photo in a set.
296 * Loading.gif is more stable in it's position.
297 * Added a minified version.
298 * Code passes JSLint.
299
300 ### Version 1.0.5 - March 11 2009
301 * Redo: Fixed a bug where IE would cut off the bottom portion of a photo, if the photo was larger than the document dimensions.
302
303 ### Version 1.0.4 - March 10 2009
304 * Added an option to allow users to automatically open the lightbox. Example usage: $(".colorbox").colorbox({open:true});
305 * Fixed a bug where IE would cut off the bottom portion of a photo, if the photo was larger than the document dimensions.
306
307 ### Version 1.0.3 - March 09 2009
308 * Fixed vertical centering for Safari 3.0.x.
309
310 ### Version 1.0.2 - March 06 2009
311 * Corrected a typo.
312 * Changed the content-type check so that it does not assume all links to photos should actually display photos. This allows for Ajax/inline/and iframe calls on anchors linking to picture file types.
313
314 ### Version 1.0.1 - March 05 2009
315 * Fixed keydown events (esc, left arrow, right arrow) for Webkit browsers.
316
317 ### Version 1.0 - March 03 2009
318 * First release
Something went wrong with that request. Please try again.