perfect-seekbar
v1.1.0
Published
The ultimate seek/progress bar. Pixel perfect, smooth and reactive. Supports chapters, thumbnails, buffering and hovering. Lightweight, fast. Made with Svelte.
Downloads
46
Maintainers
thaunknownReadme
Functions:
import Seekbar from 'perfect-seekbar'
let progress = 10
const duration = 450
let seek = 0
const chapters = [
{ size: 20, text: 'Recap' },
{ size: 15, text: 'Opening' },
{ size: 50, text: 'Episode' },
{ size: 15, text: 'Ending' },
]
async function thumbnailGenerator (percent) {
return thumbnails[Math.floor(percent)]
}
(
<Seekbar
accentColor='#f00'
bind:progress
buffer={15}
bind:seek
length={duration}
{chapters}
getThumbnail={thumbnailGenerator}
on:seeked={handleSeeked}
on:seeking={handleSeeking} />
)All values are bindable and reactive, and can be updated at any point.
accentColor- CSS color - to use as the accent color for the progressprogress- Number - percent progress in the bar ex:56.4664buffer- Number - percent buffered ex:56.4664seek- Number - percent seeking when the user is hovering or dragging the bar ex:56.4664length- Number - progress duration in seconds, set to falsy if you want to hide the timestamp ex:153.4265chapters- Array<Object> - array of chapter objects with a percentage size and optional text ex:[{ size: 20 }, { size: 80, text: 'Main' }]getThumbnail- async function - getter for a thumbnail for a given percentage progresson:seeking- event emitted when the user is dragging the bar, you can just bind the progress variable if you use svelteon:seeked- event emitted when the user finishes dragging the bar
Or use as a web component outside Svelte:
<script src="https://cdn.jsdelivr.net/npm/perfect-seekbar@latest/dist/perfect-seekbar.js"></script>
<body>
<perfect-seekbar></perfect-seekbar>
</body>
<script>
const seekbar = document.querySelector('perfect-seekbar')
video.addEventListener('timeupdate', () => { seekbar.progress = video.currentTime / video.duration * 100 })
seekbar.addEventListener('seeking' ({ detail }) => { video.currentTime = detail * video.duration / 100 })
</script>