Video/Iframe/Gallery/Inline Content Lightbox Library – Tobii

Category: Javascript , Modal & Popup , Recommended | January 17, 2023
Views Total:1,177 views
Official Page:Go to website
Last Update:January 17, 2023


Video/Iframe/Gallery/Inline Content Lightbox Library – Tobii


Tobii is a feature-rich, responsive, accessible, mobile-friendly lightbox library that makes it possible to display any content type (HTML5/Youtube video, iframe content, inline HTML, and even image gallery) in a modal popup.

More Features:

  • Image captions.
  • Smart navigation controls.
  • Item counter.
  • Keyboard interactions.
  • Image loading indicator.
  • Swipe & click outside to close.
  • Auto play videos.

Install & Download:

$ npm i @midzer/tobii

How to use it:

1. To get started, include the Tobii library’s files on the page.

<link href="dist/css/tobii.css" rel="stylesheet" />
<script src="dist/js/tobii.js"></script>
// OR as a module
import Tobii from './dist/tobii.modern.js';

2. Initialize the Tobii library and we’re ready to go.

const tobii = new Tobii();

3. Make an element to toggle a basic lightbox that loads content from an inline HTML element. Full HTML data attributes:

  • data-type: html, iframe, or youtube.
  • data-id: Youtube media id.
  • data-target: Target for “iframe” and “html” types.
  • data-group: Custom group.
  • data-width: Container width for iframe or youtube types.
  • data-height: Container height for iframe or youtube types.
  • data-controls: Whether the video player controls are displayed: 0 do not display and 1 display controls in the player.
  • data-allow: Allows to set allow attribute on iframes.
  • data-srcset: Allows to have Responsive image or retina images.
  • data-zoom: Allows to enable or disable zoom icon. Values: “true” or “false”
<button type="button" data-type="html" data-target="#modal" class="lightbox">
<div id="modal" class="modal">
  <div class="modal__inner">
    Modal Content Here

4. Embed an iframe into the lightbox.

<button type="button" data-type="iframe" data-height="600" data-width="400" data-target="https://example.jpg" class="lightbox">

5. Embed a Youtube video into the lightbox.

<button type="button" data-type="youtube" data-id="VIDEO ID HERE" data-height="600" data-controls="1" class="lightbox">
  Play Youtube Video

6. Group your images using the data-group attribute and display them as an inline slider in the lightbox.

<a href="1.jpg" class="lightbox" data-group="gallery">
  <img src="1.jpg" alt="Alt" width="200">
<a href="2.jpg" class="lightbox" data-group="gallery">
  <img src="2.jpg" alt="Alt" width="200">
<a href="3.jpg" class="lightbox" data-group="gallery">
  <img src="3.jpg" alt="Alt" width="200">

7. Config the lightbox with the following options.

var tobii = new Tobii({
    // default selector
    selector: '.lightbox',
    // shows image captions
    captions: true,
    captionsSelector: 'img',
    captionAttribute: 'alt',
    captionText: null, // returns the caption text for the current element
    captionHTML: false, // allows HTML captions.
    // 'auto' = auto hides navigation controls on mobile devices
    nav: 'auto',
    // custom navigation controls
    navText: [
      '<svg xmlns="" width="24" height="24" viewbox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M14 18l-6-6 6-6"/></svg>',
      '<svg xmlns="" width="24" height="24" viewbox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M10 6l6 6-6 6"/></svg>'
    navLabel: [
      'Previous image',
      'Next image'
    // shows close button
    close: true,
    closeText: '<svg xmlns="" width="24" height="24" viewbox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M6 6l12 12M6 18L18 6"/></svg>',
    closeLabel: 'Close lightbox',
    // image loading indicator
    loadingIndicatorLabel: 'Image loading',
    // shows image counter
    counter: true,
    // enables keyboard interactions
    keyboard: true,
    // shows a zoom image on the images
    zoom: true,
    zoomText: '<svg xmlns="" width="24" height="24" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M21 16v5h-5"/><path d="M8 21H3v-5"/><path d="M16 3h5v5"/><path d="M3 8V3h5"/></svg>',
    // click/tap outside to close the lightbox
    docClose: true,
    // allows to close the lightbox with swipe event
    swipeClose: true,
    // hides scrollbar when the lightbox is activated
    hideScrollbar: true,
    // enables drag and touch swipe events
    draggable: true,
    // touch and mouse dragging threshold in pixels
    threshold: 100,
    // auto plays videos
    autoplayVideo: false,
    // modal mode
    modal: false,
    // theme class
    theme: 'tobii--theme-default'

8. API methods.

// open a specific item, callback);
// goto the next item;
// back to the prev item
// close the lightbox
// add a new item to the lightbox
instance.add(element, callback);
// remove an item
instance.remove(element, callback);
// check if is open
// get the current item index
// select a specific group
// select a slide;
// return the current slide index
// return the current number of slides
// get the current group
// reset the lightbox
// destroy the lightbox

9. Events.

instance.on(eventName, listener);, listener);
instance.on('open', function(){
  // do something
instance.on('close', function(){
  // do something
instance.on('next', function(){
  // do something
instance.on('previous', function(){
  // do something


v2.5.0 (01/17/2023)

  • Apply opacity to buttons on :hover
  • Change opacity on close button
  • Support for audio element
  • Introduce captionHTML parameter
  • Replace em function
  • Bugs fixed

v2.4.0 (06/07/2022)

  • tobii.mjs -> tobii.modern.js
  • All CSS custom properties are now prefixed with –tobii- to avoid conflicts (e.g. –tobii-base-font-size instead of –base-font-size: 18px).

v2.3.3 (03/16/2022)

  • Fix Safari background scrolling issue

v2.3.2 (12/07/2021)

  • Bugfix IE11

v2.3.0 (10/25/2021)

  • Bugfixes

v2.3.0 (08/31/2021)

  • Added close event
  • button, background style changes
  • Added ability to select HTML links using tab, ability to select text in HTML element
  • Added data-zoom attribute
  • ignore duplicates
  • Split into modules
  • proof that images with query parameters works fine
  • console error on multiple instances
  • lint update: allow for “font-weight: bold;”
  • lint update: allow for “color: #aabbcc”
  • bump dependencies

v2.2.0 (06/30/2021)

  • Vimeo support
  • better YouTube iframe support
  • close event
  • retina images support
  • events with data
  • styles for inline HTML
  • improvements for iframe
  • hide iframe until loaded
  • bugfixes

v2.1.0 (04/27/2021)

  • Rebuild

v0.2.6 (02/22/2021)

  • Move to ES6
  • Create extra module and UMD builds
  • Add captionText config to set a callback for custom caption elements
  • Add AVIF support


  • Add theme option/ class, improve small things

You Might Be Interested In:

Leave a Reply