Skip to main content
Version: 4.x


Enables loading, playing and controlling HLS based media. If the browser does not support HLS then the hls.js library is downloaded and used as a fallback to play the stream.

You don't interact with this component for passing player properties, controlling playback, listening to player events and so on, that is all done through the vime-player component.


<vime-player controls>
<vime-hls version="latest" poster="/media/poster.png">
<source data-src="/media/index.m3u8" type="application/x-mpegURL" />
<!-- ... -->


autoPiPauto-pipEXPERIMENTAL: Whether the browser should automatically toggle picture-in-picture mode as the user switches back and forth between this document and another document or application.boolean ∣ undefinedundefined
configconfigThe hls.js configuration.anyundefined
controlsListcontrols-listDetermines what controls to show on the media element whenever the browser shows its own set of controls (e.g. when the controls attribute is specified).string ∣ undefinedundefined
crossOrigincross-originWhether to use CORS to fetch the related image. See MDN for more information."" ∣ "anonymous" ∣ "use-credentials" ∣ undefinedundefined
disablePiPdisable-pipEXPERIMENTAL: Prevents the browser from suggesting a picture-in-picture context menu or to request picture-in-picture automatically in some cases.boolean ∣ undefinedundefined
disableRemotePlaybackdisable-remote-playbackEXPERIMENTAL: Whether to disable the capability of remote playback in devices that are attached using wired (HDMI, DVI, etc.) and wireless technologies (Miracast, Chromecast, DLNA, AirPlay, etc).boolean ∣ undefinedundefined
mediaTitlemedia-titleThe title of the current media.string ∣ undefinedundefined
posterposterA URL for an image to be shown while the video is downloading. If this attribute isn't specified, nothing is displayed until the first frame is available, then the first frame is shown as the poster frame.string ∣ undefinedundefined
preloadpreloadProvides a hint to the browser about what the author thinks will lead to the best user experience with regards to what content is loaded before the video is played. See MDN for more information."" ∣ "auto" ∣ "metadata" ∣ "none" ∣ undefined'metadata'
versionversionThe NPM package version of the hls.js library to download and use if HLS is not natively supported.string'latest'


Pass <source> elements to the underlying HTML5 media player.


Used by#

Depends on#


graph TD;
vime-hls --> vime-video
vime-video --> vime-file
vime-playground --> vime-hls
style vime-hls fill:#f9f,stroke:#333,stroke-width:4px

Built with StencilJS