smartmoov-vue-h5p

Vue.js Component for displaying h5p content, based on h5p-standalone

Usage no npm install needed!

<script type="module">
  import smartmoovVueH5p from 'https://cdn.skypack.dev/smartmoov-vue-h5p';
</script>

README

Travis (.org) Coveralls github Depfu NPM npm

vue-h5p

A vue h5p component for displaying H5P content standalone, inspired by tunapanda/h5p-standalone.

Installation

With module loader

npm install vue-h5p

or

yarn add vue-h5p

in your component:

<template>
  <h5p src="path/to/h5p-content" :l10n="translations" @xapi="handleXAPIEvent">
    Loading...
    <template #error>
      Resource not available. :(
    </template>
  </h5p>
</template>

<script>
import h5p from 'vue-h5p'
import translations from './translations'

export default {
  components: {
    h5p
  },
  computed: {
    translations () {
      return translations
    }
  },
  methods: {
    handleXAPIEvent (ev) {
      console.log('H5P emitted X-API event')
    }
  }
}
</script>

Props

The component accepts the following props:

Prop Required Type Default Description
src yes String - Path to the h5p content
l10n no Object {} UI translations
embed no String '' Set embedCode and enable embed button
resize no String '' Set resizeCode
export no String '' Set exportUrl and enable export button
copyright no Boolean false Enable copyright button
icon no Boolean false Enable H5P icon
fullscreen no Boolean false Enable fullscreen button

See https://h5p.org/creating-your-own-h5p-plugin for translation strings.

NOTE: UI translations are not reactive. You have to manually trigger a rerender for translation changes to take effect (e.g. by binding :key to your locale).

Events

All events emitted by H5P are emitted by vue-h5p, event names are the H5P event type, payload is the event data.

Slots

You can use the default slot to render a placeholder while the content is loading.

The named slot "error" is rendered if a request to get the h5p JSON files fails, the slot-scope provides failed request as "error" object.

Development

Put your extracted h5p content into public/h5p, files are served by vue-dev-server.

Serve the example using

yarn example

Write code, commit changes using conventional commits.

Prepare release with

yarn pre-version