Table of Contents

• Install
  • In package.json
  • In Component
• Props
• API
• Examples
• Reference
• License

Install

In package.json

The component can be installed by executing

npm install --save vue-chocolat
# or yarn add vue-chocolat

In Component

Add it globally

import vueChocolat from 'vue-chocolat'

// ...

Vue.component('vue-chocolat', vueChocolat)

or locally

import vueChocolat from 'vue-chocolat'

// ...

export default {
  // ...
  components: {
    'vue-chocolat': vueChocolat
    // or even in a async way
    // 'vue-chocolat': () => import('vue-chocolat')
  }
}

Props

No properties are required altough you'll have a better control over the component when using it.

• items
  • default: null
  • required: false
  • type: Array
  • Reference link (opens new window)
• options
  • default: undefined
  • required: false
  • type: Object
  • Reference link (opens new window)
• selector
  • default: :scope > a
  • required: false
  • type: String

items create a gallery, selector creates a collection of clickable elements. You can't use both of them at once.

API

Reference link (opens new window)

When creating a <vue-chocolat> component you'll have access to its api by adding a ref attribute to it.

<!-- Name whatever you prefer instead of `instance` -->
<vue-chocolat ref="instance"></vue-chocolat>

someMethod() {
  const { api } = this.$refs.instance

  // see the reference link to full detailed information
  api.open(1)
  api.close()
  api.next()
  api.prev()
  // etc
}

Examples

Examples can be found here.

Reference

• http://chocolat.insipi.de/ (opens new window)

License

MIT