| .. | |||||
| index.html |
| Server IP : 104.21.46.92 / Your IP : 104.23.197.222 Web Server : Apache/2.4.51 (Unix) OpenSSL/1.1.1n System : Linux ip-172-26-8-243 4.19.0-27-cloud-amd64 #1 SMP Debian 4.19.316-1 (2024-06-25) x86_64 User : daemon ( 1) PHP Version : 7.4.24 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : ON Directory : /opt/bitnami/apache/htdocs/tackoman/public/oman/vendor/fancybox/docs/ |
Upload File : |
<!doctype html>
<html>
<head>
<title>fancyBox - touch enabled, responsive and fully customizable lightbox script</title>
<meta name="viewport" content="user-scalable=no, width=device-width, initial-scale=1.0, maximum-scale=1.0">
<meta content="text/html;charset=utf-8" http-equiv="Content-Type">
<link href="https://fonts.googleapis.com/css?family=Montserrat:400,700|Open+Sans:400,700" rel="stylesheet" />
<script src="//code.jquery.com/jquery-3.1.1.min.js"></script>
<style>
/* Reset */
html, body, div, span, applet, object, iframe, h1, h2, h3, h4, h5, h6, p, blockquote, pre, a, abbr, acronym, address, big, cite, code, del, dfn, em, img, ins, kbd, q, s, samp, small, strike, strong, sub, sup, tt, var, b, u, i, center, dl, dt, dd, ol, ul, li, fieldset, form, label, legend, table, caption, tbody, tfoot, thead, tr, th, td, article, aside, canvas, details, embed, figure, figcaption, footer, header, hgroup, menu, nav, output, ruby, section, summary, time, mark, audio, video {
margin: 0;
padding: 0;
border: 0;
font-size: 100%;
font: inherit;
vertical-align: baseline;
}
html {
box-sizing: border-box;
}
*, *:before, *:after {
box-sizing: inherit;
}
article, aside, details, figcaption, figure, footer, header, hgroup, menu, nav, section {
display: block;
}
table {
border-collapse: collapse;
border-spacing: 0;
}
/* Common styling */
body {
-webkit-text-size-adjust: none;
font-family: 'Open Sans', 'Helvetica Neue', Helvetica, Arial, sans-serif;
font-size: 16px;
line-height: 1.6;
color: #333;
}
h1, h2, h3 {
font-family: 'Montserrat', 'Helvetica Neue', Helvetica, Arial, sans-serif;
font-weight: 700;
color: #333;
}
a {
color: #FF6666;
text-decoration: none;
}
a:hover {
text-decoration: underline;
}
a.active {
font-weight: bold;
}
h1, h2, h3 {
font-family: 'Montserrat', sans-serif;
font-weight: 700;
color: #333;
}
h1 {
font-size: 2.5em;
font-weight: bold;
letter-spacing: -1px;
}
h1 a:hover {
text-decoration: none;
}
h2 {
margin: 3em 0 1em 0;
padding-bottom: 0.25em;
font-size: 2em;
border-bottom: 1px solid #eee;
}
h2:first-of-type {
margin-top: 0;
}
h3 {
margin-top: 2em;
font-size: 1.25em;
}
b {
font-weight: 700;
}
p {
margin: 0.5em 0 1.5em 0;
}
p:last-child {
margin-bottom: 0;
}
ul {
padding-left: 2em;
margin: 0.5em 0 1.5em 0;
}
pre, code, .demo {
font-family: Consolas,"Liberation Mono",Courier,monospace;
}
pre, code {
background: #F4F5F6;
color: #66676E;
}
pre {
padding: 1em;
margin-bottom: 1.5em;
overflow: auto;
max-height: calc(100vh - 150px);
-moz-tab-size: 4;
tab-size: 4;
}
code {
padding: 2px 5px;
}
pre code {
padding: 0;
}
.demo {
margin-top: -1em;
text-align: right;
}
/* Layout */
header {
position: relative;
padding: 6em 0 6em 0;
margin-bottom: 3em;
background: #FF6666;
color: #fff;
text-align: right;
}
header:before {
content: '';
position: absolute;
left: 0;
right: 0;
top: 100%;
height: 500px;
background: #fff;
-webkit-transform-origin: right;
-ms-transform-origin: right;
transform-origin: right;
-webkit-transform: skewY(2deg);
-ms-transform: skewY(2deg);
transform: skewY(2deg);
}
.content {
position: relative;
max-width: 1020px;
margin: 0 auto;
padding: 0 50px;
}
section .content {
padding-left: 240px;
}
footer .content {
padding: 6em 50px 3em 240px;
}
aside {
position: absolute;
top: 0;
left : 50px;
width: 200px;
}
/* Header */
header h1, header h1 a {
color: #fff;
}
header ul {
margin: 0;
padding: 0;
list-style: none;
}
header ul li {
display: inline-block;
margin-right: 0.5em;
}
header ul li a {
font-size: 1.125em;
color: #fff;
}
/* Sidebar */
aside ul {
position: relative;;
top: 0;
list-style: none;
padding: 1.5em 0;
margin: 0;
}
aside ul ul {
padding: 0 0 0.5em 1.5em;
font-size: 90%;
}
@media all and (max-width: 800px) {
aside {
position: relative;
left: 0;
}
.content {
padding: 0 25px;
}
section .content,
footer .content {
padding-left: 25px;
}
}
</style>
</head>
<body>
<header>
<div class="content">
<h1><a href="http://fancyapps.com/fancybox/3/">fancyBox3</a> Documentation</h1>
<ul>
<li><a href="http://fancyapps.com/fancybox/3/">Homepage</a></li>
<li><a href="http://fancyapps.com/fancybox/3/docs/">Documentation</a></li>
<li><a href="http://fancyapps.com/store/">Store</a></li>
<li><a href="https://github.com/fancyapps/fancybox">Github</a></li>
</ul>
</div>
</header>
<section>
<div class="content">
<aside>
<ul class="sticky">
<li><a href="#setup">Setup</a></li>
<li><a href="#usage">How to Use</a></li>
<li>
<a href="#media_types">Media types</a>
<ul>
<li><a href="#images">Images</a></li>
<li><a href="#inline">Inline</a></li>
<li><a href="#ajax">Ajax</a></li>
<li><a href="#iframe">Iframe</a></li>
</ul>
</li>
<li><a href="#embedding">Embedding</a></li>
<li><a href="#options">Options</a></li>
<li><a href="#api">Api</a></li>
<li><a href="#modules">Modules</a></li>
<li><a href="#faq">FAQ</a></li>
</ul>
</aside>
<!--
Setup
=====
-->
<h2 id="setup">Setup</h2>
<p>
You can install fancyBox by linking <code>.css</code> and <code>.js</code> to your html file.
Make sure you also load the jQuery library.
Below is a basic HTML template to use as an example:
</p>
<pre><!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>My page</title>
<!-- CSS -->
<link rel="stylesheet" type="text/css" href="jquery.fancybox.min.css">
</head>
<body>
<!-- Your HTML content goes here -->
<!-- JS -->
<script src="//code.jquery.com/jquery-3.1.1.min.js"></script>
<script src="jquery.fancybox.min.js"></script>
</body>
</html>
</pre>
<p><b>Tips</b>:</p>
<ul>
<li>Make sure you add the jQuery library first</li>
<li>If you already have jQuery on your page, you shouldn't include it second time</li>
<li>Do not include both fancybox.js and fancybox.min.js files</li>
</ul>
<h3>Downloading using Bower</h3>
<p>
You can install the latest version of fancyBox with the command:
</p>
<pre><code>bower install fancybox</code></pre>
<p>
This will install fancyBox to Bower's install directory, the default being <code>bower_components</code>. <br />
Within <code>bower_components/fancybox/dist/</code> you will find an uncompressed release and a compressed release.
</p>
<h3>Using jQuery with a CDN</h3>
<p>
CDNJS CDN also host compressed and uncompressed versions of fancyBox - <br />
<a href="https://cdnjs.com/libraries/fancybox/" target="_blank">https://cdnjs.com/libraries/fancybox/</a>
</p>
<!--
How To Use
==========
-->
<h2 id="usage">How to Use</h2>
<p>
There are a few ways you can use fancyBox.
</p>
<h3>Initialize with data attributes</h3>
<p>
The most basic way to use fancyBox is by adding the <code>data-fancybox</code> attribute to a link.
A caption can be added using the <code>data-caption</code> attribute. Example:
</p>
<pre><a href="image.jpg" data-fancybox data-caption="My caption">
<img src="thumbnail.jpg" alt="" />
</a></pre>
<p>
If you have a group of items, you can use the same attribute <code>data-fancybox</code> value for each of them to create a gallery.
Each group should have a unique value:
</p>
<pre><a href="image_1.jpg" data-fancybox="group" data-caption="Caption #1">
<img src="thumbnail_1.jpg" alt="" />
</a>
<a href="image_2.jpg" data-fancybox="group" data-caption="Caption #2">
<img src="thumbnail_2.jpg" alt="" />
</a>
</pre>
<p>
<b>Tip</b>:
fancyBox attempts to automatically detect the type of content based on the given url.
If it cannot be detected, the type can also be set manually using <code>data-type</code> attribute:
<pre><a href="images.php?id=123" data-type="image" data-caption="Caption">
Show image
</a></pre>
</p>
<h3>Initialize with JavaScript</h3>
<p>
To bind fancyBox events on any element, select with a jQuery selector and call the <code>fancybox</code> method:
</p>
<pre><code><script type="text/javascript">
$("[data-fancybox]").fancybox({
// Options will go here
});
</script></code></pre>
<h3>Manual calling of fancyBox</h3>
<p>
fancyBox can be activated at any point within Javascript and therefore does not necessarily need a trigger element.
Example of displaying a simple message:
</p>
<pre><code>$.fancybox.open('<div class="message"><h2>Hello!</h2><p>You are awesome!</p></div>');</code></pre>
<p>
See <a href="#api">API section</a> for more information.
</p>
<!--
Examples
=========
-->
<h2 id="media_types">Media types</h2>
<h3 id="images">Images</h3>
<p>
The standard way of using fancyBox is with a number of thumbnail images that link to larger images:
</p>
<pre><code><a href="image.jpg" data-fancybox="images" data-caption="My caption">
<img src="thumbnail.jpg" alt="" />
</a></code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/jyEGGG/?editors=1000" target="_blank">View demo on CodePen</a>
</p>
<p>
By default, fancyBox fully preloads an image before displaying it.
You can choose to display the image right away.
It will render and show the full size image while the data is being received.
To do so, some attributes are necessary:
</p>
<ul>
<li><code>data-width</code> - the real width of the image</li>
<li><code>data-height</code> - the real height of the image</li>
</ul>
<pre><code><a href="image.jpg" data-fancybox="images" data-width="2048" data-height="1365">
<img src="thumbnail.jpg" />
</a></code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/wgBrXd?editors=1000" target="_blank">View demo on CodePen</a>
</p>
<p>
fancyBox supports "scrset" so I can display different images based on viewport width. You can use this to improve download times for mobile users and over time save bandwidth.
Example:
</p>
<pre><code><a href="medium.jpg" data-fancybox="images" data-srcset="large.jpg 1600w, medium.jpg 1200w, small.jpg 640w">
<img src="thumbnail.jpg" />
</a></code></pre>
<p class="demo">
<a href="https://codepen.io/fancyapps/pen/bqbpbO?editors=1000" target="_blank">View demo on CodePen</a>
</p>
<p>
It is also possible to protect images from downloading by right-click.
While this does not protect from truly determined users, it should discourage the vast majority from ripping off your files.
</p>
<pre><code>$('[data-fancybox]').fancybox({
image : {
protect: true
}
});</code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/RKKqLx?editors=1010" target="_blank">View demo on CodePen</a>
</p>
<h3 id="inline">Inline</h3>
<p>
For your Inline HTML you have to place a DIV Container into the content of the page:
</p>
<pre><code><div style="display: none;" id="hidden-content">
<h2>Hello</h2>
<p>You are awesome.</p>
</div></code></pre>
<p>
And then simply create a link using <code>data-src</code> attribute that matches CSS id selector of the element you want to open (<code>#hidden-content</code> in this example):
</p>
<pre><code><a data-fancybox data-src="#hidden-content" href="javascript:;">
Hidden div
</a></code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/MJYOOd?editors=1000" target="_blank">View demo on CodePen</a>
</p>
<h3 id="ajax">Ajax</h3>
<p>
To load content via AJAX, you need to add a <code>data-type="ajax"</code> attribute to your link:
</p>
<pre><code><a data-fancybox data-type="ajax" data-src="my_page.com/path/to/ajax/" href="javascript:;">
AJAX content
</a></code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/JEoOvK?editors=1100" target="_blank">View demo on CodePen</a>
</p>
<p>
Additionally it is possible to define a selector with the <code>data-selector</code> attribute to show only a part of the response. The selector can be any string, that is a valid jQuery selector:
</p>
<pre><code><a data-fancybox data-type="ajax" data-src="my_page.com/path/to/ajax/" data-selector="#two" href="javascript:;">
AJAX content
</a>
</code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/MJwWKz?editors=1100" target="_blank">View demo on CodePen</a>
</p>
<h3 id="iframe">Iframe</h3>
<p>
If the content can be shown on a page, and placement in an iframe is not blocked by script or security configuration of that page,
it can be presented in a fancyBox:
</p>
<pre><code><a data-fancybox data-src="http://codepen.io/fancyapps/full/jyEGGG/" href="javascript:;">
Webpage
</a>
<a data-fancybox data-src="http://www.adobe.com/content/dam/Adobe/en/devnet/acrobat/pdfs/pdf_open_parameters.pdf" href="javascript:;">
Sample PDF
</a>
</code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/BpymvO?editors=1000" target="_blank">View demo on CodePen</a>
</p>
<p>
To access and control fancyBox in parent window from inside an iframe:
</p>
<pre><code>// Adjust iframe height according to the contents
parent.jQuery.fancybox.getInstance().update();
// Close current fancyBox instance
parent.jQuery.fancybox.getInstance().close();</code></pre>
<p>
Iframe dimensions can be controlled by CSS:
</p>
<pre><code>.fancybox-slide--iframe .fancybox-content {
width : 800px;
height : 600px;
max-width : 80%;
max-height : 80%;
margin: 0;
}</code></pre>
<p>
These CSS rules can be overridden by JS, if needed:
</p>
<pre><code>$("[data-fancybox]").fancybox({
iframe : {
css : {
width : '600px'
}
}
});</code></pre>
<p>
If you have not disabled iframe preloading (using an "preload" option), then the script will atempt to
calculate content dimensions and will adjust width/height of iframe to fit with content in it.
Keep in mind, that due to <a href="https://en.wikipedia.org/wiki/Same-origin_policy" target="_blank">same origin policy</a>,
there are some limitations.
</p>
<!--
Embedding
=======
-->
<h2 id="embedding">Embedding</h2>
<p>
Supported sites can be used with fancyBox by just providing the page URL:
</p>
<pre><code><a data-fancybox href="https://www.youtube.com/watch?v=_sI_Ps7JSEk">
YouTube video
</a>
<a data-fancybox href="https://vimeo.com/191947042">
Vimeo video
</a>
<a data-fancybox href="https://www.google.com/maps/place/Googleplex/@37.4220041,-122.0833494,17z/data=!4m5!3m4!1s0x0:0x6c296c66619367e0!8m2!3d37.4219998!4d-122.0840572">
Google Map
</a>
<a data-fancybox href="https://www.instagram.com/p/BNXYW8-goPI/?taken-by=jamesrelfdyer" data-caption="<span title=&quot;Edited&quot;>balloon rides at dawn ✨🎈<br>was such a magical experience floating over napa valley as the golden light hit the hills.<br><a href=&quot;https://www.instagram.com/jamesrelfdyer/&quot;>@jamesrelfdyer</a></span>">
Instagram photo
</a></code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/LxEOwL?editors=1000" target="_blank">View demo on CodePen</a>
</p>
<h3>Video dimensions</h3>
<p>
Resize video display with the following CSS:
</p>
<pre><code>.fancybox-slide--video .fancybox-content {
width : 800px;
height : 600px;
max-width : 80%;
max-height : 80%;
}</code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/PWZrzw?editors=1100" target="_blank">View demo on CodePen</a>
</p>
<p>
Obviously, you can choose any size you like, any combination with <code>min</code>/<code>max</code> values.
<br />
Aspect ratio lock for videos is not implemented yet, but if you wish, <a href="http://codepen.io/fancyapps/pen/dNzaQq?editors=1010" target="_blank">you can use this snippet</a>.
</p>
<h3>Video parameters</h3>
<p>
Controlling a video via URL parameters:
</p>
<pre><code><a data-fancybox href="https://www.youtube.com/watch?v=_sI_Ps7JSEk&amp;autoplay=1&amp;rel=0&amp;controls=0&amp;showinfo=0">
YouTube video - hide controls and info
</a>
<a data-fancybox href="https://vimeo.com/191947042?color=f00">
Vimeo video - custom color
</a></code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/mRVNyO?editors=1000" target="_blank">View demo on CodePen</a>
</p>
<p>
Via JavaScript:
</p>
<pre><code>$('[data-fancybox]').fancybox({
youtube : {
controls : 0,
showinfo : 0
},
vimeo : {
color : 'f00'
}
});</code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/Qdyeyr?editors=1010" target="_blank">View demo on CodePen</a>
</p>
<!--
Options
=======
-->
<h2 id="options">Options</h2>
<p>
Available options listed below.
</p>
<pre>defaults = {
// Animation duration in ms
speed : 330,
// Enable infinite gallery navigation
loop : true,
// Should zoom animation change opacity, too
// If opacity is 'auto', then fade-out if image and thumbnail have different aspect ratios
opacity : 'auto',
// Space around image, ignored if zoomed-in or viewport smaller than 800px
margin : [44, 0],
// Horizontal space between slides
gutter : 30,
// Should display toolbars
infobar : true,
buttons : true,
// What buttons should appear in the toolbar
slideShow : true,
fullScreen : true,
thumbs : true,
closeBtn : true,
// Should apply small close button at top right corner of the content
// If 'auto' - will be set for content having type 'html', 'inline' or 'ajax'
smallBtn : 'auto',
image : {
// Wait for images to load before displaying
// Requires predefined image dimensions
// If 'auto' - will zoom in thumbnail if 'width' and 'height' attributes are found
preload : "auto",
// Protect an image from downloading by right-click
protect : false
},
ajax : {
// Object containing settings for ajax request
settings : {
// This helps to indicate that request comes from the modal
// Feel free to change naming
data : {
fancybox : true
}
}
},
iframe : {
// Iframe template
tpl : '<iframe id="fancybox-frame{rnd}" name="fancybox-frame{rnd}" class="fancybox-iframe" frameborder="0" vspace="0" hspace="0" webkitAllowFullScreen mozallowfullscreen allowFullScreen allowtransparency="true" src=""></iframe>',
// Preload iframe before displaying it
// This allows to calculate iframe content width and height
// (note: Due to "Same Origin Policy", you can't get cross domain data).
preload : true,
// Scrolling attribute for iframe tag
scrolling : 'no',
// Custom CSS styling for iframe wrapping element
css : {}
},
// Custom CSS class for layout
baseClass : '',
// Custom CSS class for slide element
slideClass : '',
// Base template for layout
baseTpl : '<div class="fancybox-container" role="dialog" tabindex="-1">' +
'<div class="fancybox-bg"></div>' +
'<div class="fancybox-controls">' +
'<div class="fancybox-infobar">' +
'<button data-fancybox-previous class="fancybox-button fancybox-button--left" title="Previous"></button>' +
'<div class="fancybox-infobar__body">' +
'<span class="js-fancybox-index"></span>&nbsp;/&nbsp;<span class="js-fancybox-count"></span>' +
'</div>' +
'<button data-fancybox-next class="fancybox-button fancybox-button--right" title="Next"></button>' +
'</div>' +
'<div class="fancybox-buttons">' +
'<button data-fancybox-close class="fancybox-button fancybox-button--close" title="Close (Esc)"></button>' +
'</div>' +
'</div>' +
'<div class="fancybox-slider-wrap">' +
'<div class="fancybox-slider"></div>' +
'</div>' +
'<div class="fancybox-caption-wrap"><div class="fancybox-caption"></div></div>' +
'</div>',
// Loading indicator template
spinnerTpl : '<div class="fancybox-loading"></div>',
// Error message template
errorTpl : '<div class="fancybox-error"><p>The requested content cannot be loaded. <br /> Please try again later.<p></div>',
// This will be appended to html content, if "smallBtn" option is not set to false
closeTpl : '<button data-fancybox-close class="fancybox-close-small"></button>',
// Container is injected into this element
parentEl : 'body',
// Enable gestures (tap, zoom, pan and pinch)
touch : true,
// Enable keyboard navigation
keyboard : true,
// Try to focus on first focusable element after opening
focus : true,
// Close when clicked outside of the content
closeClickOutside : true,
// Callbacks; See Documentation/API/Events for description and samples
beforeLoad : $.noop,
afterLoad : $.noop,
beforeMove : $.noop,
afterMove : $.noop,
onComplete : $.noop,
onInit : $.noop,
beforeClose : $.noop,
afterClose : $.noop,
onActivate : $.noop,
onDeactivate : $.noop
}
</pre>
<p>
Set instance options by passing a valid object to <code>fancybox()</code> method:
</p>
<pre><code>$("[data-fancybox]").fancybox({
image : {
protect : true
}
});</code></pre>
<p>
Plugin options / defaults are exposed in <code>$.fancybox.defaults</code> namespace so you can easily adjust them globally:
</p>
<pre><code>$.fancybox.defaults.speed = 600;</code></pre>
<p>
Custom options for each element individually can be set by adding a <code>data-options</code>
attribute to the element.
This attribute should contain the properly formatted JSON object:
</p>
<pre><code><a data-fancybox data-options='{"caption" : "My caption", "src : "iframe.html"}' href="javascript:;">
Open external page using iframe
</a></code></pre>
<!--
API
===
-->
<h2 id="api">API</h2>
<p>
The fancyBox API offers a couple of methods to control fancyBox.
This gives you the ability to extend the plugin and to integrate it with other web application components.
</p>
<h3 id="core_methods">Core methods</h3>
<p>
Core methods are methods which affect/handle instances:
</p>
<pre><code>// Close only the currently active or all fancyBox instances
$.fancybox.close( all );
// Open the fancyBox right away
$.fancybox.open( items, opts, index );
</code></pre>
<p>
When calling fancyBox manually, each group item should follow this pattern:
</p>
<pre><code>{
src : '' // Source of the content
type : '' // Content type: image|inline|ajax|iframe|html (optional)
opts : {} // Object containing item options (optional)
}
</code></pre>
<p>
Example of opening image gallery:
</p>
<pre><code>$.fancybox.open([
{
src : '1_b.jpg',
opts : {
caption : 'First caption'
}
},
{
src : '2_b.jpg',
opts : {
caption : 'Second caption'
}
}
], {
loop : false
});</code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/wgZXzz?editors=1010" target="_blank">View demo on CodePen</a>
</p>
<p>
It is also possible to pass only one object. Example of opening inline content:
</p>
<pre><code>$.fancybox.open({
src : '#hidden-content',
type : 'inline',
opts : {
onComplete : function() {
console.info('done!');
}
}
});
</code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/JEVLgN?editors=1010" target="_blank">View demo on CodePen</a>
</p>
<p>
If you wish to display some html content (for example, a message), then you can use a simpler syntax.
It is advised to use a wrapper around your content.
</p>
<pre><code>$.fancybox.open('<div class="message"><h2>Hello!</h2><p>You are awesome!</p></div>');</code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/VPNBaK" target="_blank">View demo on CodePen</a>
</p>
<h3 id="instance_methods">Instance methods</h3>
<p>
In order to use these methods, you need an instance of the plugin's object:
</p>
<pre><code>var $instance = $.fancybox.getInstance();</code></pre>
<p>
Or you can can just use fancyBox constructor:
</p>
<pre><code>var $instance = $("[data-fancybox]").fancybox();</code></pre>
<p>
Once you have a reference to fancyBox instance the following methods are available:
</p>
<pre><code>// Go to next gallery item
$instance.next( duration );
// Go to previous gallery item
$instance.previous( duration );
// Switch to the other gallery item; accepts integer argument (an index of the desired item)
$instance.jumpTo( index, duration );
// Check if current image dimensions are smaller than actual
$instance.isScaledDown();
// Scale image to the actual size of the image
$instance.scaleToActual( x, y, duration );
// Check if image dimensions exceed parent element
$instance.canPan();
// Scale image to fit inside parent element
$instance.scaleToFit( duration );
// Move slider to current position
// Update all slides (and their content) if needed
$instance.update( andSlides, andContent, duration );
// Update slide position and make content fit in slide if needed
$instance.updateSlide( slide, andContent );
// Update infobar values, navigation button states and reveal caption
$instance.updateControls( force );
// Load custom content into the slide
$instance.setContent( slide, content );
// Try to find and focus on the first focusable element
$instance.focus();
// Activates current instance, brings it to the front
$instance.activate();
// Close instance
$instance.close();
</code></pre>
<p>
You can also do something like this:
</p>
<pre><code>$.fancybox.getInstance().jumpTo(1);</code></pre>
<p>
or simply:
</p>
<pre><code>$.fancybox.getInstance('jumpTo', 1);</code></pre>
<h3 id="events">Events</h3>
<p>
fancyBox fires several events.
</p>
<pre><code>beforeLoad : Before the content of a slide is being loaded
afterLoad : When the content of a slide is done loading
beforeMove : Before slide change transition starts
afterMove : After slide change transition is complete
onComplete : When slide change is complete and content has been loaded
onInit : When instance has been initialized
beforeClose : Before instance is closed
afterClose : After instance has been closed
onActivate : When instance is brought to front
onDeactivate : When other instance has been activated
</code></pre>
<p>
Event callbacks can be set as function properties of the options object passed to fancyBox initialization function:
</p>
<pre><code><script type="text/javascript">
$("[data-fancybox]").fancybox({
onComplete: function( instance, slide ) {
// Tip: Each event passes useful information within the event object:
// Object containing references to interface elements
// (background, buttons, caption, etc)
// console.info( instance.$refs );
// Current slide options
// console.info( slide.opts );
// Clicked element
// console.info( slide.opts.$orig );
// Reference to DOM element of the slide
// console.info( slide.$slide );
}
});
</script></code></pre>
<p>
Each callback receives two parameters - current fancyBox instance and current gallery object, if exists.
</p>
<p>
It is also possible to attach event handler for all instances.
To prevent interfering with other scripts, these events have been namespaced to <code>.fb</code>.
These handlers receive 3 parameters - event, current fancyBox instance and current gallery object.
</p>
<p>
Here is an example of binding to the <code>onComplete</code> event:
</p>
<pre><code>$(document).on('onComplete.fb', function( e, instance, slide ) {
// Your code goes here
});</code></pre>
<p>
If you wish to prevent closing of the modal, for example, if form is not validating, you can use <code>beforeClose</code>
callback. Simply return <code>false</code>:
</p>
<pre><code>beforeClose : function( instance, current, e ) {
if ( $('#my-field').val() == '' ) {
return false;
}
}
</code></pre>
<h2 id="modules">Modules</h2>
<p>
fancyBox code is split into several files (modules) that extend core functionality.
You can build your own fancyBox version by excluding unnecessary modules, if needed.
Each one has their own <code>js</code> and/or <code>css</code> files.
</p>
<p>
Some modules can be customized and controlled programmatically.
List of all possible options:
</p>
<pre><code>slideShow : {
speed : 3000 // Slideshow speed in ms
},
touch : {
vertical : true // Allow vertical swipe
},
thumbs : {
showOnStart : false, // Display thumbnails on opening
hideOnClosing : true // Hide thumbnail grid when closing animation starts
},
fullScreen : {
requestOnStart : false // Request fullscreen mode on opening
},
hash : false // Hash value</code></pre>
<p>
Example (show thumbnails on start):
</p>
<pre><code>$('[data-fancybox="images"]').fancybox({
thumbs : {
showOnStart : true
}
})</code></pre>
<p class="demo">
<a href="https://codepen.io/fancyapps/pen/RKKVVa?editors=1010" target="_blank">View demo on CodePen</a>
</p>
<p>
If you would inspect fancyBox instance object, you would find keys that names ar captialized - these are references for each module object.
Also, you would notice that fancyBox uses common naming convention to prefix jQuery objects with <code>$</code>.
</p>
<p>
This is how you, for example, can access thumbnail grid element:
</p>
<pre><code>$.fancybox.getInstance().Thumbs.$grid</code></pre>
<p>
This example shows how to call method that toggles thumbnails:
</p>
<pre><code>$.fancybox.getInstance().Thumbs.toggle();</code></pre>
<p>
List of available methods:
</p>
<pre><code>Thumbs.focus()
Thumbs.close();
Thumbs.update();
Thumbs.hide();
Thumbs.show();
Thumbs.toggle();
FullScreen.request( elem );
FullScreen.exit();
FullScreen.toggle( elem );
FullScreen.isFullscreen();
FullScreen.enabled();
SlideShow.start();
SlideShow.stop();
SlideShow.toggle();
</code></pre>
<p>
If you wish to disable hash module, use this snippet (after including JS file):
</p>
<pre><code>$.fancybox.defaults.hash = false;</code></pre>
<!--
FAQ
===
-->
<h2 id="faq">FAQ</h2>
<h3>Opening/closing causes fixed element to jump</h3>
<p>
Simply add <code>compensate-for-scrollbar</code> CSS class to your fixed positioned elements.
Example of using Bootstrap navbar component:
</p>
<pre><code><nav class="navbar navbar-inverse navbar-fixed-top compensate-for-scrollbar">
<div class="container">
..
</div>
</nav></code></pre>
<p>
The script measures width of the scrollbar and creates <code>compensate-for-scrollbar</code> CSS class
that uses this value for <code>margin-right</code> property.
Therefore, if your element has <code>width:100%</code>, you should positon it using <code>left</code> and <code>right</code> properties instead. Example:
</p>
<pre><code>.navbar {
position: fixed;
top: 0;
left: 0;
right: 0;
}</code></pre>
<h3>How to customize caption</h3>
<p>
You can use <code>caption</code> option that accepts a function and is called for each group element. Example of appending image download link:
</p>
<pre><code>$( '[data-fancybox]' ).fancybox({
caption : function( instance, item ) {
var caption, link;
if ( item.type === 'image' ) {
caption = $(this).data('caption');
link = '<a href="' + item.src + '">Download image</a>';
return (caption ? caption + '<br />' : '') + link;
}
}
});</code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/ygeYGx?editors=1010" target="_blank">View demo on CodePen</a>
</p>
<p>
Inside <code>caption</code> method, <code>this</code> refers to the clicked element. Example of using different source for caption:
</p>
<pre><code>$( '[data-fancybox]' ).fancybox({
caption : function( instance, item ) {
return $(this).find('figcaption').html();
}
});</code></pre>
<p class="demo">
<a href="https://codepen.io/fancyapps/pen/bgEQXo?editors=1010" target="_blank">View demo on CodePen</a>
</p>
<h3>How to create custom button in the toolbar</h3>
<p>
Example of using callback to access toolbar element and append custom button:
</p>
<pre><code>$( '[data-fancybox]' ).fancybox({
onInit : function( instance ) {
instance.$refs.downloadButton = $('<a class="fancybox-button fancybox-download"></a>')
.appendTo( instance.$refs.buttons );
},
beforeMove: function( instance, current ) {
instance.$refs.downloadButton.attr('href', current.src);
}
});
</code></pre>
<p class="demo">
<a href="http://codepen.io/fancyapps/pen/dNGapJ" target="_blank">View demo on CodePen</a>
</p>
<h3>How to reposition thumbnail grid</h3>
<p>
There is currenty no JS option to change thumbnail grid position.
But fancyBox is designed so that you can use CSS to change position or dimension for each block
(e.g., content area, caption or thumbnail grid).
This gives you freedom to completely change the look and feel of the modal window, if needed.
<a href="http://codepen.io/fancyapps/pen/vgRajd" target="_blank">View demo on CodePen</a>
</p>
</div>
</div>
</section>
<footer>
<div class="content">
<p>
<a href="javascript:;" onClick="javascript:$('html, body').animate({ scrollTop: 0 }, 0);return false;">Back to Top</a>
</p>
</div>
</footer>
<script>
/* Sticky nvigation */
var sticky = {
$sticky : $( '.sticky' ),
offsets : [],
targets : [],
stickyTop : null,
set : function() {
var self = this;
self.offsets = [];
self.targets = [];
// Get current top position of sticky element
self.stickyTop = self.$sticky.css( 'position', 'relative' ).offset().top;
// Cache all targets and their top positions
self.$sticky.find( 'a' ).map(function () {
var $el = $( this ),
href = $el.data('target') || $el.attr( 'href' ),
$href = /^#./.test(href) && $( href );
return $href && $href.length && $href.is( ':visible' ) ? [ [ Math.floor( $href.offset().top - parseInt( $href.css('margin-top') ) ), href ] ] : null;
})
.sort(function (a, b) { return a[0] - b[0] })
.each(function () {
self.offsets.push( this[ 0 ] );
self.targets.push( this[ 1 ] );
});
},
update : function() {
var self = this;
var windowTop = Math.floor( $(window).scrollTop() );
var $stickyLinks = self.$sticky.find( 'a' ).removeClass( 'active' );
var stickyPosition = 'fixed';
var currentIndex = 0;
// Toggle fixed position depending on visibility
if ( $(window).width() < 800 || self.stickyTop > windowTop ) {
stickyPosition = 'relative';
} else {
for ( var i = self.offsets.length; i--; ) {
if ( windowTop >= self.offsets[ i ] && ( self.offsets[ i + 1 ] === undefined || windowTop <= self.offsets[ i + 1 ]) ) {
currentIndex = i;
break;
}
}
}
self.$sticky.css( 'position', stickyPosition );
$stickyLinks.eq( currentIndex ).addClass( 'active' );
},
init : function() {
var self = this;
$(window).on('resize', function() {
self.set();
self.update();
});
$(window).on('scroll', function() {
self.update();
});
self.set();
self.update();
}
}
sticky.init();
</script>
</body>
</html>
| .. | |||||
| index.html |