Need help with vue-image-lightbox?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

pexea12
296 Stars 77 Forks 302 Commits 19 Opened issues

Description

A Vue component to display an image gallery lightbox

Services available

!
?

Need anything else?

Contributors list

vue-image-lightbox

A simple image/video lightbox component for Vuejs NPM Package

I use CSS style from react-images

Demo!

Development (NPM / Yarn)

npm run dev
yarn dev

Install

NPM / Yarn

Install the package:

npm install vue-image-lightbox vue-lazyload
yarn add vue-image-lightbox vue-lazyload

Then import it in your project At your entry point (

main.js
normally)
javascript
import Vue from 'vue'
import VueLazyLoad from 'vue-lazyload'
...
Vue.use(VueLazyLoad)

and use the lightbox: ```javascript import LightBox from 'vue-image-lightbox'

export default { components: { LightBox, }, } ```

Browser global


Usage

You can simply view App.vue to see how to use vue-image-lightbox

Import CSS style

javascript
require('vue-image-lightbox/dist/vue-image-lightbox.min.css')
// Use only when you are using Webpack
How to use:
html

media
has the structure:
javascript
[
  { // For image
    thumb: 'http://example.com/thumb.jpg',
    src: 'http://example.com/image.jpg',
    caption: 'caption to display. receive  tag', // Optional
    srcset: '...' // Optional for displaying responsive images
  },
  { // For video
    thumb: 'https://s3-us-west-1.amazonaws.com/powr/defaults/image-slider2.jpg',
    sources: [
      {
        src: 'https://www.w3schools.com/html/mov_bbb.mp4',
        type: 'video/mp4'
      }
    ],
    type: "video",
    caption: '

Monsters Inc.

', width: 800, // required height: 600, // required autoplay: true //Optional to autoplay video when lightbox opens } ]

Options

Properties

<tr>
  <td>lengthToLoadMore</td>
  <td>Number</td>
  <td>0</td>
  <td>Minimum length unto end to emit load more event</td>
</tr>
<tr>
  <td>closable</td>
  <td>Boolean</td>
  <td>true</td>
  <td>Display the close button at the right top corner or not. ESC clicking-close will also be disabled if closable is set to false.</td>
</tr>
<tr>
  <td>closeText</td>
  <td>String</td>
  <td>Close (Esc)</td>
  <td>Text for the close button</td>
</tr>
<tr>
  <td>previousText</td>
  <td>String</td>
  <td>Previous</td>
  <td>Text for the previous image button</td>
</tr>
<tr>
  <td>nextText</td>
  <td>String</td>
  <td>Next</td>
  <td>Text for the next image button</td>
</tr>
<tr>
  <td>previousThumbText</td>
  <td>String</td>
  <td>Previous</td>
  <td>Text for the previous thumb image button</td>
</tr>
<tr>
  <td>nextThumbText</td>
  <td>String</td>
  <td>Next</td>
  <td>Text for the next thumb image button</td>
</tr>
<tr>
  <td>showFooterCount</td>
  <td>Boolean</td>
  <td>true</td>
  <td>Show footer count</td>
</tr>
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
siteLoading String default image when your image is error or loading
showCaption Boolean false Whether to show caption or not
disableScroll Boolean true set to `true` to avoid scrolling views behind lightbox
disableZoom Boolean true set to `true` to avoid zooming lightbox

Methods

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

Slots

close

The content of the close button.

footer

The content of the footer under the image.

slot-scopes
name type description
current integer Number of the current image displayed
total integer Numbers of the images

previous

The previous button on the main image.

next

The next button on the main image.

previousThumb

The previous button on the thumbs list.

nextThumb

The next button on the thumbs list.

customCaption

The caption of the current image.

videoIcon

The Icon used for videos

Events

  • 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.
  • onImageChanged
    : Emit when the image is changed.

CREDITS

Most of the CSS belongs to react-images

Contributors:

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.