SpeedkitVimeo
We have integrated SpeedkitVimeo
as an example to show how iFrame content must be integrated in a performance-optimized manner.
For this purpose, a separate IntersectionObserver has been implemented, which detects a longer dwell time of the component in the viewport. The iFrame is initialized only after a positive detection. This prevents immense data from having to be loaded when simply scrolling through the page.
So that no empty space is visible to the user, we use the functionality of the SpeedkitPicture
and preload the corresponding Vimeo poster in different renditions, so the illusion is perfect for the user and he does not notice anything of the optimized lazy load procedure.
Usage
The SpeedkitVimeo
is used to initialise Vimeo videos with Vimeo Player-SDK
.
nuxt-speedkit
and will be loaded by an external script.The url
of the Vimeo video must be specified.
The SpeedkitPicture
is used for the poster, so the generation of the poster is automated, you can define the image sizes with sizes
(What is sizes
?).
Learn more about SpeedkitPicture
SpeedkitVimeo
do not disable @nuxt/image
via disableNuxtImage
Example
<template>
<div>
<speedkit-vimeo
v-bind="{
url,
title,
options,
posterSizes
}"
@playing="onPlaying" />
</div>
</template>
<script setup>
import SpeedkitVimeo from '#speedkit/components/SpeedkitVimeo';
defineProps({
url: { type: String, default: '<vimeo-url>' },
title: { type: String, default: 'Vimeo Title' },
options: {
type: String,
default() {
return {
controls: false
};
}
},
posterSizes: {
type: Object,
default() {
return {
default: '100vw',
md: '50vw'
};
}
}
});
const onPlaying = () => console.log('Vimeo Player playing!');
</script>
Properties
{
url: '<vimeo-url>',
title: 'Player Title',
autoplay: false,
mute: false,
posterSizes: { … },
options: { … }
}
url
- Type:
String
Sets a video via the vimeo url.
title
- Type:
String
Sets the title for the player iframe and poster.
autoplay
- Type:
Boolean
- Default:
false
- Default:
When set starts video in autoplay. It is required that the component is integrated via SpeedkitHydrate
or is only activated when entering the visible area.
mute
- Type:
Boolean
- Default:
false
- Default:
When set the player is muted.
posterSizes
- Type:
String
- Default:
{ default: '100vw', xxs: '100vw', xs: '100vw', sm: '100vw', md: '100vw', lg: '100vw', xl: '100vw', xxl: '100vw' }
- Default:
Sets the image sizes of the poster.
options
- Type:
Object
Overrides the vimeo player options. These will be the same as the vimeo player embed options.
Learn more about Vimeo Player Parameters
autoplay
and mute
the component properties are used.Option playsinline
is always set, mute
is set automatically for touch devices.This is important for autoplay on mobile devices.
Slots
<template #default="{ videoData }">
{{videoData.title}}
</template>
<template #loading-spinner>
Loading…
</template>
<template #play>
<span>Click!</span>
</template>
Name | Description |
---|---|
default | Used to display more information about the video below the player. The slot has a scoped property videoData . This contains the result from the Vimeo oembed api.https://developer.vimeo.com/api/oembed/videos#table-2 |
loading-spinner | Overwrites the loading spinner. |
play | Overwrites the play button. |
Events
<speedkit-vimeo
@ready="console.log('Player Ready!')"
@playing="console.log('Player Playing!')"
/>
Name | Description |
---|---|
ready | Triggered when Vimeo Player-SDK is completely loaded. |
playing | Triggered when video is finished loading and playing. |
beforePlayer | Used to place elements in the player container (before). |
afterPlayer | Used to place elements in the player container (after). |