@molecule/app-video-player-svelte
v1.1.0
Published
HTML5 video player chrome — play/pause, scrub, elapsed/total time, mute toggle, fullscreen, optional caption track
Readme
@molecule/app-video-player-svelte
Svelte HTML5 video player chrome.
Exports VideoPlayer — a <video> element wrapped with custom
ClassMap-styled controls: play/pause, scrub bar, elapsed/total time,
mute toggle, fullscreen, optional caption track. It is the Svelte
counterpart of @molecule/app-video-player-react: the same props (React
names) and the same DOM for the same input.
Auto-generated, AI-first package reference for the molecule.dev ecosystem. It is written to be read by coding agents as much as by people, and is generated from this package's source — edit
src/index.tsJSDoc, not this file.
Quick Start
<script lang="ts">
import { VideoPlayer } from '@molecule/app-video-player-svelte'
</script>
<VideoPlayer
src="https://cdn.example.com/intro.mp4"
poster="https://cdn.example.com/intro-thumb.jpg"
captionsSrc="https://cdn.example.com/intro.vtt"
onEnded={() => console.log('watched to the end')}
/>Type
feature
Installation
npm install @molecule/app-video-player-svelte @molecule/app-svelte @molecule/app-ui @molecule/app-ui-svelte svelteAPI
Interfaces
VideoPlayerProps
Props accepted by the {@link VideoPlayer} component.
interface VideoPlayerProps {
/** Video URL. */
src: string
/** Optional poster image URL. */
poster?: string
/** Caption track URL (.vtt). */
captionsSrc?: string
/** Caption language code. */
captionsLang?: string
/**
* Human-readable name of the captions track (the track's `label`, which
* screen readers and the browser's caption menu announce). Defaults
* through i18n (`video.captions`, English "Captions").
*/
captionsLabel?: string
/** Autoplay (must be muted to work in most browsers). */
autoPlay?: boolean
/** Initial muted state. */
defaultMuted?: boolean
/** Called when the media starts playing. */
onPlay?: () => void
/** Called when the media is paused. */
onPause?: () => void
/** Called when the media reaches its end. */
onEnded?: () => void
/** Extra classes. */
className?: string
}Constants
VideoPlayer
const VideoPlayer: LegacyComponentTypeInjection Notes
Requirements
Peer dependencies:
@molecule/app-svelte^3.5.0@molecule/app-ui^1.4.0@molecule/app-ui-svelte^1.1.0svelte^5.0.0
Runtime Dependencies
@molecule/app-svelte@molecule/app-ui@molecule/app-ui-sveltesvelte
Renders its own <video> element directly — it does NOT use
@molecule/app-video's provider system; reach for that package when you
need an imperative, provider-swappable player. Volume control is a MUTE
TOGGLE only (no slider), and there is no PiP / playback-rate / quality
UI. Buttons use emoji glyphs (▶ ⏸ 🔇 🔊 ⛶). Only the Play/Pause labels
go through t('video.play') / t('video.pause'); the 'Seek',
'Mute'/'Unmute' and 'Fullscreen' aria-labels are hardcoded English (the
on-disk @molecule/app-locales-video-player bond carries only the two
play/pause keys and is not registered yet). autoPlay also forces the
initial state to muted (browser autoplay policy); captionsLang
defaults to 'en'. Single src URL only — no multi-source/quality list.
Props (documented on the exported VideoPlayerProps interface): src,
poster, captionsSrc, captionsLang, autoPlay, defaultMuted, onPlay,
onPause, onEnded, className.
Translations
Translation strings are provided by @molecule/app-locales-video-player.
