Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/ludo237/vuejs-carousel

Complete photo carousel build with VueJS and web standards in mind
https://github.com/ludo237/vuejs-carousel

carousel javascript photos vue vuejs vuejs-carousel vuejs2

Last synced: 13 days ago
JSON representation

Complete photo carousel build with VueJS and web standards in mind

Lists

README

        

[![npm version](https://img.shields.io/npm/v/vuejs-carousel.svg)](https://www.npmjs.com/package/vuejs-carousel)
[![Downloads](https://img.shields.io/npm/dt/vuejs-carousel.svg)](https://www.npmjs.com/package/vuejs-carousel)
[![License](https://img.shields.io/npm/l/vuejs-carousel.svg)](https://www.npmjs.com/package/vuejs-carousel)

[![Code Climate](https://codeclimate.com/github/ludo237/vuejs-carousel/badges/gpa.svg)](https://codeclimate.com/github/ludo237/vuejs-carousel)
[![Test Coverage](https://codeclimate.com/github/ludo237/vuejs-carousel/badges/coverage.svg)](https://codeclimate.com/github/ludo237/vuejs-carousel/coverage)
[![Issue Count](https://codeclimate.com/github/ludo237/vuejs-carousel/badges/issue_count.svg)](https://codeclimate.com/github/ludo237/vuejs-carousel)

[![bitHound Overall Score](https://www.bithound.io/github/ludo237/vuejs-carousel/badges/score.svg)](https://www.bithound.io/github/ludo237/vuejs-carousel)
[![bitHound Dependencies](https://www.bithound.io/github/ludo237/vuejs-carousel/badges/dependencies.svg)](https://www.bithound.io/github/ludo237/vuejs-carousel/master/dependencies/npm)
[![bitHound Dev Dependencies](https://www.bithound.io/github/ludo237/vuejs-carousel/badges/devDependencies.svg)](https://www.bithound.io/github/ludo237/vuejs-carousel/master/dependencies/npm)
[![bitHound Code](https://www.bithound.io/github/ludo237/vuejs-carousel/badges/code.svg)](https://www.bithound.io/github/ludo237/vuejs-carousel)

# VueJs Carousel [![Awesome Vue](https://cdn.rawgit.com/sindresorhus/awesome/d7305f38d29fed78fa85652e3a63e154dd8e8829/media/badge.svg)](https://github.com/vuejs/awesome-vue)

Easy to use VueJS component for Photo galleries, built with VueJS and web standards in mind

## How to install

In order to use the carousel you have to follow 3 simple steps:

- Install the package from npm `npm install vuejs-carousel --save`
- Go into your Vue main file or main javascript file
- Import the carousel `import {store, Photos, Theater} from "vuejs-carousel"`
- Add the component inside your views

## How to use

This carousel is pretty easy to use. Put the source code inside your page:

Add the components to your page like the example:




Try it with a source, for example you can use [Mockaroo](https://www.mockaroo.com/8e9a75b0)

## Configuration

The current state of the component uses an array of `photos` objects and it expects this attributes:

- id
- thumbnail
- photo
- name
- body
- created_at
- comments *array*
- id
- name
- body
- created_at

**Be Aware**: If you have a different API structure you have to change the code a little bit in particular
you have to change the attributes of `selectedPhoto` and of `photos`. I will try to make this as dynamic as
possible soon...

The source of the API is provided by [Mockaroo](https://www.mockaroo.com/8e9a75b0)

## Contributing

If you want to contribute to this project issues and pull requests are welcome! In order to get started with the code you should:

- Either download or clone this repository
- Run `npm install` this will install all the necessary dependencies
- Run `npm run dev`
- Start coding :smile:

## License

See [License file](LICENSE) for further details.

## Changelog

See [Changelog File](CHANGELOG) for further details.