Warning!
These are options for 1.3+, for versions 1.2+ look there
Documention for fancyBox2 is available at fancyapps.com
You can pass options as key/value object to fancybox() function or modify them at the bottom of FancyBox JS file.
Key | Default value | Description |
---|---|---|
padding | 10 | Space between FancyBox wrapper and content |
margin | 20 | Space between viewport and FancyBox wrapper |
opacity | false | When true, transparency of content is changed for elastic transitions |
modal | false | When true, 'overlayShow' is set to 'true' and 'hideOnOverlayClick', 'hideOnContentClick', 'enableEscapeButton', 'showCloseButton' are set to 'false' |
cyclic | false | When true, galleries will be cyclic, allowing you to keep pressing next/back. |
scrolling | 'auto' | Set the overflow CSS property to create or hide scrollbars. Can be set to 'auto', 'yes', or 'no' |
width | 560 | Width for content types 'iframe' and 'swf'. Also set for inline content if 'autoDimensions' is set to 'false' |
height | 340 | Height for content types 'iframe' and 'swf'. Also set for inline content if 'autoDimensions' is set to 'false' |
autoScale | true | If true, FancyBox is scaled to fit in viewport |
autoDimensions | true | For inline and ajax views, resizes the view to the element recieves. Make sure it has dimensions otherwise this will give unexpected results |
centerOnScroll | false | When true, FancyBox is centered while scrolling page |
ajax | { } | Ajax options Note: 'error' and 'success' will be overwritten by FancyBox |
swf | {wmode: 'transparent'} | Params to put on the swf object |
hideOnOverlayClick | true | Toggle if clicking the overlay should close FancyBox |
hideOnContentClick | false | Toggle if clicking the content should close FancyBox |
overlayShow | true | Toggle overlay |
overlayOpacity | 0.3 | Opacity of the overlay (from 0 to 1; default - 0.3) |
overlayColor | '#666' | Color of the overlay |
titleShow | true | Toggle title |
titlePosition | 'outside' | The position of title. Can be set to 'outside', 'inside' or 'over' |
titleFormat | null | Callback to customize title area. You can set any html - custom image counter or even custom navigation |
transitionIn, transitionOut | 'fade' | The transition type. Can be set to 'elastic', 'fade' or 'none' |
speedIn, speedOut | 300 | Speed of the fade and elastic transitions, in milliseconds |
changeSpeed | 300 | Speed of resizing when changing gallery items, in milliseconds |
changeFade | 'fast' | Speed of the content fading while changing gallery items |
easingIn, easingOut | 'swing' | Easing used for elastic animations |
showCloseButton | true | Toggle close button |
showNavArrows | true | Toggle navigation arrows |
enableEscapeButton | true | Toggle if pressing Esc button closes FancyBox |
onStart | null | Will be called right before attempting to load the content |
onCancel | null | Will be called after loading is canceled |
onComplete | null | Will be called once the content is displayed |
onCleanup | null | Will be called just before closing |
onClosed | null | Will be called once FancyBox is closed |
Key | Description |
---|---|
type | Forces content type. Can be set to 'image', 'ajax', 'iframe', 'swf' or 'inline' |
href | Forces content source |
title | Forces title |
content | Forces content (can be any html data) |
orig | Sets object whos position and dimensions will be used by 'elastic' transition |
index | Custom start index of manually created gallery (since 1.3.1) |
FancyBox provides some function to work with it
Method | Description |
---|---|
$.fancybox.showActivity | Shows loading animation |
$.fancybox.hideActivity | Hides loading animation |
$.fancybox.next | Displays the next gallery item |
$.fancybox.prev | Displays the previous gallery item |
$.fancybox.pos | Displays item by index from gallery |
$.fancybox.cancel | Cancels loading content |
$.fancybox.close | Hides FancyBox Within an iframe use - parent.$.fancybox.close(); |
$.fancybox.resize | Auto-resizes FancyBox height to match height of content |
$.fancybox.center | Centers FancyBox in viewport |