vimeo-video-element
Version:
A custom element for the Vimeo player with an API that matches the `<video>` API
59 lines (43 loc) • 3.52 kB
Markdown
# `<vimeo-video>`
[](https://www.npmjs.com/package/vimeo-video-element)
[](https://www.npmjs.com/package/vimeo-video-element)
[](https://www.jsdelivr.com/package/npm/vimeo-video-element)
[](https://bundlephobia.com/result?p=vimeo-video-element)
A [custom element](https://developer.mozilla.org/en-US/docs/Web/Web_Components/Using_custom_elements)
for the Vimeo player with an API that matches the
[`<video>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/video) API.
- 🏄♂️ Compatible [`HTMLMediaElement`](https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement) API
- 🕺 Seamlessly integrates with [Media Chrome](https://github.com/muxinc/media-chrome)
## Example ([CodeSandbox](https://codesandbox.io/s/vimeo-video-element-x5ku6s))
<!-- prettier-ignore -->
```html
<script type="module" src="https://cdn.jsdelivr.net/npm/vimeo-video-element@1.0/+esm"></script>
<vimeo-video controls src="https://vimeo.com/648359100"></vimeo-video>
```
## Install
First install the NPM package:
```bash
npm install vimeo-video-element
```
Import in your app javascript (e.g. src/App.js):
```js
import 'vimeo-video-element';
```
Optionally, you can load the script directly from a CDN using [JSDelivr](https://www.jsdelivr.com/):
<!-- prettier-ignore -->
```html
<script type="module" src="https://cdn.jsdelivr.net/npm/vimeo-video-element@1.0/+esm"></script>
```
This will register the custom elements with the browser so they can be used as HTML.
## Related
- [Media Chrome](https://github.com/muxinc/media-chrome) Your media player's dancing suit. 🕺
- [`<youtube-video>`](https://github.com/muxinc/media-elements/tree/main/packages/youtube-video-element) A custom element for the YouTube player.
- [`<spotify-audio>`](https://github.com/muxinc/media-elements/tree/main/packages/spotify-audio-element) A custom element for the Spotify player.
- [`<jwplayer-video>`](https://github.com/muxinc/media-elements/tree/main/packages/jwplayer-video-element) A custom element for the JW player.
- [`<videojs-video>`](https://github.com/muxinc/media-elements/tree/main/packages/videojs-video-element) A custom element for Video.js.
- [`<wistia-video>`](https://github.com/muxinc/media-elements/tree/main/packages/wistia-video-element) A custom element for the Wistia player.
- [`<cloudflare-video>`](https://github.com/muxinc/media-elements/tree/main/packages/cloudflare-video-element) A custom element for the Cloudflare player.
- [`<hls-video>`](https://github.com/muxinc/media-elements/tree/main/packages/hls-video-element) A custom element for playing HTTP Live Streaming (HLS) videos.
- [`castable-video`](https://github.com/muxinc/media-elements/tree/main/packages/castable-video) Cast your video element to the big screen with ease!
- [`<mux-player>`](https://github.com/muxinc/elements/tree/main/packages/mux-player) The official Mux-flavored video player custom element.
- [`<mux-video>`](https://github.com/muxinc/elements/tree/main/packages/mux-video) A Mux-flavored HTML5 video element w/ hls.js and Mux data builtin.