IMediaScrubberProps
Props for <OrigamMediaScrubber> — a headless, media-agnostic value-on-a-track widget. Stateless: the parent controls modelValue and listens to update:modelValue, change, drag*, and hover events. Used for the timeline and the volume slider.
TypeScript
Définition
La définition TypeScript de l'interface telle que trouvée dans le code source d'origam. Cliquez sur l'icône de copie pour copier l'extrait.
Héritage
Hérite de
Interfaces parentes dont celle-ci hérite. Leurs propriétés sont disponibles pour tout consommateur de cette interface.
API
Propriétés
Chaque propriété déclarée par cette interface, avec son type, son caractère optionnel et sa valeur par défaut.
- modelValuerequisnumber
- Current value between min and max. Supports v-model. The component never mutates this directly.
- minnumber0
- Lower bound of the value range.
- maxrequisnumber
- Upper bound of the value range. Required to compute thumb position. Passing 0 or a value <= min freezes the scrubber at the start.
- stepnumber0
- Discrete step. 0 means continuous (pointer events emit the raw float); positive values snap each emission to the nearest multiple.
- bufferednumber
- Optional buffered position (end of the browser media buffer). Renders the __buffer bar from min up to buffered. Pass undefined to hide the bar.
- orientationTMediaScrubberOrientation'horizontal'
- Layout axis. 'horizontal' = YouTube timeline shape, 'vertical' = volume / level meter shape (top = max, bottom = min).
- disabledbooleanfalse
- Disables pointer + keyboard interaction. The element drops out of the tab order and pointer events become no-ops.
- showThumbOnHoverOnlybooleanfalse
- Hides the thumb at rest and reveals it on hover / focus / drag — the YouTube pattern.
- showHoverTooltipbooleanfalse
- Shows a tooltip above the cursor (horizontal only) reflecting the hovered value. Content can be overridden via the #tooltip slot.
- formatHoverTooltip(value: number) => string
- Formatter for the default hover tooltip label. Receives the hovered value and returns the string to render.
- ariaLabelstring
- Required accessibility label — read by screen readers when the scrubber gains focus. Always pass a translated string.
- ariaValueTextstring
- Optional human-readable representation of the current value (e.g. "1:23" for a timestamp, "45 %" for a volume). Mapped to aria-valuetext.
- dataCystring
Écosystème
Utilisé par
Composants et composables qui étendent ou consomment cette interface.
Usage
Exemples
Extraits de code prêts à coller utilisant cette interface.
Video timeline scrubber with buffer display