/vue-wave-sufver

Vue Wrapper for wavesurfer.js

Primary LanguageVue

Installation

npm i vue-wave-surfer

or

yarn add vue-wave-surfer

Module

As a global vue-cli plugin

import Vue from 'vue'
import VueWaveSurfer from 'vue-wave-surfer'

Vue.use(VueWaveSurfer)

As a nuxt global plugin

// plugins/vue-wave-surfer.js
import Vue from 'vue'
import VueWaveSurfer from 'vue-wave-surfer'

Vue.use(VueWaveSurfer)
// nuxt.config.js
export default {
  plugins: [
    '~/plugins/vue-wave-surfer'
  ]
}

As a component plugin

import VueWaveSurfer from 'vue-wave-surfer'
export default {
  components: {
    VueWaveSurfer
  }
}

Usage

<template>
  <vue-wave-surfer :src="file" :options="options"></vue-wave-surfer>
</template>
<script>
export default {
  data() {
    return {
      options: {
      },
      file: 'http://example.com/file.mp3'
    }
  }
}
</script>

Options

See the list of options in the official documentation

Using Plugins

An example implementing the Cursor plugin

<script>
import Cursor from 'wavesurfer.js/dist/plugin/wavesurfer.cursor';
export default {
  data() {
    return {
      options: {
        plugins: [
          Cursor.create()
        ]
      }
    }
  }
}
</script>

Capturing Events

  1. Create a vue-wave-surfer element and adding a ref to it
  2. Create a computed property returning the elemenents waveSurfer object
  3. Access waveSurfer events and methods in the mounted() function

This is a client-only module so be sure to wrap it in a client-only tag if using nuxt

<vue-wave-surfer src="url.mp3" ref="surf"></vue-wave-surfer>
<script
export default {
  mounted() {
    this.player.on('ready', () => {
      console.log('ready')
    })
  },
  computed: {
    player() {
      return this.$refs.surf.waveSurfer
    }
  }
}
</script>