0.1.12 • Public • Published

FORK of Vue It Bigger!

npm Build Status codecov Depfu

A simple image / video lightbox component for Vue.js. Forked from vue-it-bigger.

This version is also using vue-pinch-zoom

Vue It Bigger Screenshot

Click on the screenshot above for a demo.

Why I bother to fork it?:

  • Parameter show-light-box is now reactive, whitch is easier to toggle LightBox from parent
  • Parameter start-at is reactive as well
  • Pinch to zoom added, which is useful for mobile view
  • Lazy-load added. Currently with default image only


  • NEW: pinch to zoom
  • NEW: lazy-loader
  • Unobtrusive interface that disappears after a few seconds, reappears on mouse activity
  • Optional thumbnail strip with all of the gallery's media
  • Can show an HTML enabled caption under each image or video
  • Can play the slideshow automatically
  • All of the graphics (previous, next and close buttons) can be customized via slots
  • Can skip to next / previous media programatically

Improvements over vue-image-lightbox

  • Lightbox opens and closes with a short fade
  • Media's width is no longer limited (stretches to the full width / height of the window)
  • When opening the lightbox the media doesn't flicker
  • Moved caption bar and image counter off the media to the bottom of the screen
  • Moved thumbnails to the top of the screen (as the bottom is now used by the caption bar)
  • All interface elements have a background for better visibility
  • Simplified CSS


You know the drill:

npm install vue-it-bigger-vladfork
yarn add vue-it-bigger-vladfork


You can view App.vue or the demo for an usage example.

In the <script> section of your component import it:

import LightBox from "vue-it-bigger-vladfork";
import("vue-it-bigger-vladfork/dist/vue-it-bigger-vladfork.min.css"); // when using webpack

Add it to the list of used components:

export default {
  components: {

And use it in the <template> section:


The media prop has the following structure

    // For an image
    thumb: "",
    src: "",
    caption: "Caption to display. HTML <b>enabled</b>", // Optional
    srcset: "..." // Optional for displaying responsive images
    // For a video
    thumb: "",
    sources: [
        src: "",
        type: "video/mp4"
    type: "video",
    caption: "<h4>Monsters Inc.</h4>",
    width: 800, // Required
    height: 600, // Required
    autoplay: true // Optional: Autoplay video when the lightbox opens

data variables:

  data () {
    return {
      media: [
      showLightBox: false,
      lbStartAt: 0,

add toggle method to methods:

    toggleLightBox(v) {
      this.showLightBox = v || false

to show the LightBox use a method something like:

  openGallery(index) {
    this.lbStartAt = index || 0
    this.showLightBox = true

Where index is the Index of image you want to pop up

Using it with NuxtJs

Create a file named lightbox.js under the plugins directory with following contents:

import Vue from "vue";
import LightBox from "vue-it-bigger-vladfork";
const plugin = {
  install() {
    Vue.component("LightBox", LightBox);

Add the plugin in nuxt.config.js:

plugins: [
    src: "~/plugins/lightbox.js",
    ssr: false

Use it in any of your components:

<no-ssr placeholder="Loading...">
  <!-- this component will only be rendered on client-side -->
  <LightBox :media="lightBoxMedia" ....></LightBox>



name type default description
media Array required Media array to display
showLightBox Boolean true Whether to show lightbox or not at the beginning
startAt Number 0 Index of the image that you want to start at
nThumbs Number 7 Number of thumbnail images
showThumbs Boolean true Whether to show thumbnails or not
autoPlay Boolean false Move to next image automatically
autoPlayTime Number 3000 (ms) Time to stop at an image before move on to next image
interfaceHideTime Number 3000 (ms) Time after which the interface is hidden
showCaption Boolean false Whether to show caption or not
disableScroll Boolean true set to `true` to avoid scrolling views behind lightbox
lengthToLoadMore Number 0 Minimum length unto end to emit load more event
closable Boolean true Display the close button at the right top corner or not. ESC clicking-close will also be disabled if closable is set to false.
closeText String Close (Esc) Text for the close button
previousText String Previous Text for the previous image button
nextText String Next Text for the next image button


name arguments description
nextImage () Move to next image
previousImage () Move to previous image
closeLightBox () Close lightbox
showImage (index) Show the image at index



The content of the close button.


The content of the footer under the image.

Slot props
name type description
current integer Number of the current image displayed
total integer Number of images


The previous button on the main image.


The next button on the main image.


The caption of the current image.

Slot props
name type description
currentMedia Object The currently displayed object from the media array

Usage example:

  <template v-slot:customCaption="slotProps">
    {{ slotProps.currentMedia.caption }}<br>
    There could be some description here.


The Icon used for videos


  • onOpened: Emit when the lightbox is opened.
  • onClosed: Emit when the lightbox is closed.
  • onLastIndex: Emit when the current image is the last one of the list.
  • onFirstIndex: Emit when the current image is the first one of the list.
  • onStartIndex: Emit when the current image is at the startAt index (specified in the properties).
  • onLoad: Emit when there are lengthToLoadMore images left in the array (specified in the properties). For example, if lengthToLoadMore = 2 and there are 7 images in your array, when you reach index 4 (which means there are 2 images left which are not discovered yet), this event will be emitted. After that, if the image array are updated and there are totally 15 images, the event will be emitted at index 12.

Development (NPM / Yarn)

Clone the repository, cd into it and run:

npm run dev
yarn dev

After you add or modify something make sure the tests still pass:

npm run test
yarn test


  • Improve documentation
  • Add pinch to zoom options



This project is licensed under the the Apache License, Version 2.0.

Package Sidebar


npm i vue-it-bigger-vladfork

Weekly Downloads






Unpacked Size

992 kB

Total Files


Last publish


  • shirler