@ispa.io/vimage
v1.0.3
Published
vimage is a plugin for Vue.js that allows you to show images in full-screen gallery by adding only one directive to the tag.
Downloads
3
Maintainers
Readme
v-image
is a plugin for Vue.js that allows you to show images in full-screen gallery by adding only one directive to the tag. This project created and used for iSPA CMS, so if you used this package, please noted that we may not check your issue or request.
Table of contents
Milestone
- [ ] srcSet attributes support
- [ ] Custom download buttons group for srcSet
- [ ] Custom Icons (Download, Arrows, Close)
- [ ] Video support
- [ ] Picture tag support
- [ ] Gallery Auto play
- [ ] Integrate with el-image (Element UI)
Getting started
Install
npm i @ispa.io/vimage // npm
Usage
import Vue from 'vue';
import vImage from '@ispa.io/vimage';
Vue.use(vImage);
Optional configurations
In this snippet all settings has its default value. Don't specify them unless you want to change default behavior.
const vImageConfig = {
// Global title
'title': null,
// Show download button
'download': false,
// Show thumbnails
'thumbnails': false,
// on Event to show image
'openOn': 'click',
}
Vue.use(vImage, vImageConfig);
Example
Grouping images list
<div v-image data-thumbnails title="global title">
<img data-group="group-1" data-download src="..." data-src="..." alt="image 1">
<img data-group="group-1" data-download src="..." data-src="..." alt="image 2">
<img data-group="group-2" src="..." data-src="..." alt="image 3">
<img data-group="group-2" src="..." data-src="..." alt="image 4">
</div>
OR
<div v-image="{
'group': 'group-name',
'download': true,
'thumbnails': true
}">
<img src="..." data-src="..." alt="image 1">
<img src="..." data-src="..." alt="image 2">
</div>
OR
<img v-image data-group="group-1" data-download src="..." data-src="..." alt="image 1">
<img v-image data-group="group-1" data-download src="..." data-src="..." alt="image 2">
<img v-image data-group="group-2" src="..." data-src="..." alt="image 3">
<img v-image data-group="group-2" src="..." data-src="..." alt="image 4">
Only one image
<img v-image data-download src="...">
OR
<img v-image src="..." data-src="...">
Options
| Option | Description | Default value | Data type |
| :----: | :---------: | :-----------: | :-------: |
| group | Group name | null | String |
| data-src | Image source that will be displayed in gallery | data-src attribute | String |
| src | Image thumbnails | src attribute | String |
| title | Caption that will be displayed | empty String or value of the alt
attribute | String |
| openOn | Event listener to open gallery will be applied to tagName. Available options are all native JS events. | click
/dblclick
/mouseover
... | String |
| data-download | Download button show | false
| Boolean |
| data-thumbnails | Small thumbnails show (this thumb will be show by the src
attribute) | false
| Boolean |
This plugins has more options and will be available at next versions.
Versioning
Maintained under the Semantic Versioning guidelines.
License
Invite me a cup of coffee
If you like this project and want to contribute us, then you can send us a cup of coffee by this ways below:
| PAYPAL.ME | MOMO App (Vietnam) | |:--------------------:|:------------------:| | | |