Turn any element into a lightbox or popover link for Youtube and Vimeo videos.
Some things have changed, though the only real non-backward compatible change is a couple updated defaults. Everything else (such as renamed options and updated params) has shims in place to maintain compatibility.
You can see a comprehensive list of all the changes below in the changes section.
Also of pretty significant note Video Lightning is no longer jQuery dependent though it still retains it's jQuery friendly API. See below for more info on the new non-jQuery API usage.
Lots of reasons. The main one, and the reason we built it, is for quick video explainers in the appropriate places. This little plugin bootstraps getting those helpful little videos in place.
Simple. Add the js your project, initialize with target and options and enjoy your video lightbox enhanced element!
- Simple access to all embed API options for both providers
- Lots of options to customize and beautify your lightboxes
- Intelligent popover auto positioning gravitates to page center
- Preview videos on hover, pin if you want them to stick around
- Lazy loading of videos prevents slow page load due to video embeds
- Rick Roll with ease (don't pass video id, add rick_roll option to prevent closing)
Check the GH Project Page for demos.
i. Add script where you desire (bottom of body is recommended)
<script src="javascripts/jquery-video-lightning.js"></script>
ii. Initialize it on the desired elements with any options you please (options can also be passed as data attributes)
<script>
videoLightning({
elements: [
{
".video-link": {
id: "y-PKffm2uI4dk",
autoplay: true,
color: "white"
}
}
]
});
</script>
<script>
$(function() {
$(".video-link").jqueryVideoLightning({
id: "y-PKffm2uI4dk",
autoplay: true,
color: "white"
});
});
</script>
Alternatively, for a simple setup you could initialize on a class, set your options globally, and add video id to each el.
<div class="video-link" data-video-id="y-PKffm2uI4dk"></div>
<div class="video-link" data-video-id="y-z-D1PJ1cMXs></div>
<script>
videoLightning({settings: {autoplay: true, color: "white"}, element: ".video-link"});
</script>
Options can be passed in any of three ways. They can be passed as attributes off the element object:
videoLightning({
elements: [
{
".video-link": {
id: "y-PKffm2uI4dk",
width: 1280,
height: 720
}
}
]
});
They can be passed as attributes of the setting
object (doesn't apply to jQuery style init):
videoLightning({
settings: {
autoplay: true,
width: 1280,
height: 720
},
elements: [
{
".video-link": {
id: "y-PKffm2uI4dk"
}
}
]
});
Or they can be passed as data attributes: (Note that data attributes are all prefixed with data-video
and camel cased options should be dashed instead in data attributes. So startTime
becomes data-video-start-time
)
<div class="video-link" data-video-id="y-PKffm2uI4dk" data-video-width="1280" data-video-height="720" data-video-autoplay="true"></div>
Video Lightning exposes all available basic API options for both Youtube and Vimeo. There are also a number of effect, style, and behavior options that are available. The following is the current list of available options.
-
id (String - default="y-dQw4w9WgXcQ")
Vendor prefixed video id [if Youtube then prefix with y-xxxxx, if Vimeo then v-xxxxx] -
width (Integer - default=640)
Video width in px -
height (Integer - default=390)
Video height in px -
autoplay (Boolean - default=true)
Start playback immediately (true,false) -
autoclose (Boolean - default=true)
Autoclose lightbox / popover once video is complete (true,false) -
popover (Boolean - default=false)
Open in popover instead of lightbox (true,false) -
peek (Boolean - default=false)
Preview video on hover, user can click^
to pin (true,false) -
bdColor (String [hex] - default="#ddd")
Color of page overlay -
bdOpacity (Decimal [0 to 1] - default=0.6)
Opacity of page overlay -
glow (Integer - default=20)
Glow around video frame -
glowColor (String [hex] - default="#000")
Glow color around video frame -
xBgColor (String [hex] - default="#000") Close icon background color
-
xColor (String [hex] - default="#fff") Close icon
ร
color -
fadeIn (Integer [ms] - default=300)
Time in ms of lightbox fade in -
fadeOut (Integer [ms] - default=0, 1000)
Time in ms of lightbox fade out [default is 0 if closed manually, 1000 if autoclosed] -
zIndex (Integer - default=2100)
Z-index of page overlay -
rickRoll (Boolean - default=false)
Make video un-closable (true,false) -
cover (Boolean - default=false)
Display cover image (true,false) -
unload (Boolean - default=true)
Unload video iframe X seconds after it is closed -
unloadAfter (Integer [s] - default=45)
Time in seconds to wait after closing before unloading -
fluidity (Integer - default=30)
Number of steps popover should move in on resize events. Lower is smoother, higher is faster -
throttle (Integer [ms] - default=null)
Rate limit resize events. Reduces redraws on resizing, lowers accuracy / smoothness of repositioning
Some of Youtube's options are not listed below, but everything on their params page (as of 3/15/15) is available. Youtube Params Reference
-
autohide (default=2)
Y: auto hide controls after video load (0,1,2) -
controls (default=1)
Y: display controls (0,1,2) -
ivLoadPolicy (default=1)
Y: display annotations (1,3) -
ccLoadPolicy (default=null)
Y: display closed captions by default (null,1) -
loop (default=0)
Y&V: loop video playback (0,1) -
modestbranding (default=0)
Y: hide large Youtube logo (0,1) -
playlist (default="")
Y: comma-separated list of video IDs to play (ex. "WkgWvaFrJv8,VZPxHUpdAGw") -
related (default=0)
Y: show related videos when playback is finished (0,1) -
showinfo (default=1)
Y: display title, uploader (0,1) V: display title (0,1) -
startTime (default=0)
Y: playback start position in seconds (ex. "132" starts at 2mins, 12secs) -
endTime (default=0)
Y: playback end position in seconds (ex. "132" ends at 2mins, 12secs) -
theme (default="dark")
Y: player theme ("dark","light") -
color (default="")
Y: player controls color ("red","white") V: player controls color (hex code default is "#00adef") -
byline (default=1)
V: display byline (0,1) -
portrait (default=1)
V: display user's portrait (0,1)
3.0:
- complete re-write removing the dependency on jQuery while still supporting jQuery initialization
- using full iframe API's for Youtube and Vimeo for event handling and interaction
- adds option to
autoclose
on video end - adds
peek
option to preview video on hover with ability to pin popover - enhanced gravity function improves popover positioning performance and smoothness
- peek
- autoclose
- unload
- unloadAfter
- fluidity
- throttle
- xBgColor
- xColor
- bdColor: '#000' => '#ddd'
- bdOpacity: 1.0 => 0.6
- glow: 0 => 20
- glowColor: '#fff' => '#000'
- width: (pixel string w/ px suffix) => (pixel integer)
- height: (pixel string w/ px suffix) => (pixel integer)
- autoplay: (1,0) => (true,false)
- popover: (1,0) => (true,false)
- rickRoll: (1,0) => (true,false)
- cover: (1,0) => (true,false)
- backdrop_color => bdColor
- backdrop_opacity => bdOpacity
- ease_in => fadeIn
- ease_out => fadeOut
- glow_color => glowColor
- start_time => startTime
- z_index => zIndex
- rick_roll => rickRoll
- iv_load_policy => ivLoadPolicy
- popover_x
- popover_y
2.0.1 minified (latest jQuery only build) (8.514 kb)
2.0.1 Docs
1.1.0 minified (pre-popover, lightbox only) (4.646 kb)
1.1.0 Docs
- Fork it
- Create your feature branch (git checkout -b my-new-feature)
- Commit your changes (git commit -am 'Added some feature')
- Push to the branch (git push origin my-new-feature)
- Create new Pull Request
author: Andrew Carpenter, on behalf of the musocrat team