Full-featured audio player with waveform visualisation, playlist management, transport controls and a scoped-slot API.
Aperçu
Rendu de l’aperçu en cours…
expanded
Rendu de l’aperçu en cours…
compact
Rendu de l’aperçu en cours…
primary
Structure
Anatomie
Décomposition visuelle de la structure interne du composant avec les appels de classes BEM.
Anatomy of <origam-audio> — 5 internal parts. The hidden <audio> element (⓪) drives state; the visual shell is a flex column: cover ①, metadata header ②, waveform ③, transport controller ④, optional playlist ⑤.
1.origam-audio__cover
Album cover image rendered as . 96 px in expanded, 48 px in compact.
2.origam-audio__header
Metadata strip: title, artist and album. Hidden when all three are absent.
3.origam-audio__waveform
Waveform visualiser — decoded peaks painted via SVG bars. Visible only when waveform prop is truthy.
4.origam-audio__controller
shell housing the transport row (play/pause, scrubber, volume, playback-rate menu).
5.origam-audio__playlist
Ordered list of tracks shown below the transport when playlist prop is set.
API
Props
Toutes les props acceptées par ce composant, avec leur type, valeur par défaut et description.
Imperative player methods: play(), pause(), seek(t), setVolume(v), setMuted(b), setPlaybackRate(r).
Personnalisation
Variables CSS
Propriétés CSS personnalisées exposées par ce composant. Surchargez-les pour personnaliser sans perdre la compatibilité avec le thème.
Player surface background.
Default foreground color (text and icons).
Accent color driving scrubbers, play-button surface and active-loop pill.
Player container border color.
Player container border-radius.
Gap between header, waveform and controller sections.
Padding of the player container.
Cover image size in expanded variant. 48 px in compact.
Played waveform bar color.
Inclusion
Accessibilité
Rôles ARIA, navigation clavier et gestion du focus. Sourcé depuis le template réel du composant.
Rôles ARIA
article
application
Interactions clavier
Interactions clavier
Touche
Action
Space
Play / Pause toggle via the transport button.
Arrow Left / Right
Seek backward / forward on the scrubber slider.
Arrow Up / Down
Increase / decrease volume on the volume slider.
Tab
Navigate between transport controls.
Notes
Autoplay is suppressed when prefers-reduced-motion: reduce is set.
The waveform scrubber has aria-label="Seek" pointing to the useLocale translation.
When controls="native", the browser's native audio controls are used, which include keyboard support by default.
Fondation
Design tokens
Extrait des tokens de ce composant — les variables --origam-<composant>---<propriété>, déclarées dans sa feuille de tokens tenue à la main, sans étape de build.
Source
color
var(--origam-color__surface---raised)
Player background.
color
var(--origam-color__action--primary---bg)
Accent color for scrubbers and the play button.
dimension
96px
Cover size in expanded variant.
dimension
48px
Play button size.
dimension
48px
Waveform visualiser height.
dimension
var(--origam-radius---lg)
Player container border-radius.
Interactif
Playground
Modifiez les props en direct et observez le composant se mettre à jour. Le snippet de code généré suit vos changements.
Rendu de l’aperçu en cours…
Usage
Exemples
Extraits de code prêts à coller dans vos templates.
Basic player
vue
Playlist with loop
vue
Compact dock variant
vue
Écosystème
Éléments liés
Composants et directives d'autres dossiers qui collaborent avec celui-ci.