jQuery Poptrox Adds popup galleries to jQuery. Heavily customizable, easy to use, and built to support images, YouTube videos, Vimeo videos, Soundcloud tracks, IFRAMEs, and AJAX content.
1. INCLUDE JS FILES
2. HTML
3. Javascript
4. OPTIONS
foo.poptrox({
preload: false, // If true, preload fullsize images in
// the background
baseZIndex: 1000, // Base Z-Index
fadeSpeed: 300, // Global fade speed
overlayColor: ‘#000000‘, // Overlay color
overlayOpacity: 0.6, // Overlay opacity
windowMargin: 50, // Window margin size (in pixels; only comes into
// play when an image is larger than the viewport)
windowHeightPad: 0, // Window height pad
selector: ‘a‘, // Anchor tag selector
popupSpeed: 300, // Popup (resize) speed
popupWidth: 200, // Popup width
popupHeight: 100, // Popup height
popupIsFixed: false, // If true, popup won‘t resize to fit images
useBodyOverflow: true, // If true, the BODY tag is set to overflow: hidden
// when the popup is visible
usePopupEasyClose: true, // If true, popup can be closed by clicking on
// it anywhere
usePopupLoader: true, // If true, show the popup loader
usePopupCloser: true, // If true, show the popup closer button/link
usePopupCaption: false, // If true, show the popup image caption
usePopupNav: false, // If true, show (and use) popup navigation
usePopupDefaultStyling: true, // If true, default popup styling will be applied
// (background color, text color, etc)
popupBackgroundColor: ‘#FFFFFF‘, // (Default Style) Popup background color (when
// usePopupStyling = true)
popupTextColor: ‘#000000‘, // (Default Style) Popup text color (when
// usePopupStyling = true)
popupLoaderTextSize: ‘2em‘, // (Default Style) Popup loader text size
popupCloserBackgroundColor: ‘#000000‘, // (Default Style) Popup closer background color
// (when usePopupStyling = true)
popupCloserTextColor: ‘#FFFFFF‘, // (Default Style) Popup closer text color (when
// usePopupStyling = true)
popupCloserTextSize: ‘20px‘, // (Default Style) Popup closer text size
popupPadding: 10, // (Default Style) Popup padding (when
// usePopupStyling = true)
popupCaptionHeight: 60, // (Default Style) Popup height of caption area
popupCaptionTextSize: null, // (Default Style) Popup caption text size
popupBlankCaptionText: ‘(untitled)‘, // Applied to images that don‘t have captions
// (when captions are enabled)
popupCloserText: ‘ב, // Popup closer text
popupLoaderText: ‘••‘, // Popup loader text
popupClass: ‘poptrox-popup‘,// Popup class
popupSelector: null, // (Advanced) Popup selector (use this if you
// want to replace the built-in popup)
popupLoaderSelector: ‘.loader‘, // (Advanced) Popup Loader selector
popupCloserSelector: ‘.closer‘, // (Advanced) Popup Closer selector
popupCaptionSelector: ‘.caption‘, // (Advanced) Popup Caption selector
popupNavPreviousSelector: ‘.nav-previous‘,// (Advanced) Popup Nav Previous selector
popupNavNextSelector: ‘.nav-next‘, // (Advanced) Popup Nav Next selector
onPopupClose: null, // Called when popup closes
onPopupOpen: null // Called when popup opens
});
5. SUPPORTED TYPES
In addition to images, popups can also show other stuff (like YouTube videos). To do this, point your thumbnail’s anchor to the appropriate URL (see below for specifics) and give it a data-poptrox attribute like so:
The data-poptrox attribute breaks down like this:
- type: The type (eg. youtube)
- (width)x(height): An optional width and height for the popup (eg. 800×400)
YouTube Videos
- Link format: http://youtu.be/xxxxxxxxxxx (found via the “Share” link)
- Type: youtube
- Example:
Vimeo Videos
- Link format: http://vimeo.com/xxxxxxxx (found via the “Share” button under “Embed”)
- Type: vimeo
- Example:
Soundcloud Tracks
- Link format: https://api.soundcloud.com/tracks/xxxxxxxx (found via the “Share” button under “Widget Code” or “WordPress Code”)
- Type: soundcloud
- Example:
IFRAMEs
- Link format: Anything.
- Type: iframe
- Example:
AJAX Content
- Link format: Anything (as long as it’s on the same domain)
- Type: ajax
- Example:
Ignore
This “special” (unspecial?) type just tells Poptrox to treat whatever’s in href as if it were a normal link.
- Link format: Anything.
- Type: ignore
- Example: