AudioPlayer

Transcript: A short, quiet reference tone fades in and out. No speech.

Usage

import { AudioPlayer } from "@devvy-ui/react";

<AudioPlayer label="Studio tone" src="/examples/studio.wav" transcript={<p>A short, quiet reference tone.</p>} />

API reference

Native HTML attributes, className, style and a forwarded ref are supported. Component-specific props:

Prop	Type	Default	Description
label	string	required	Media name.
transcript	ReactNode	required	Visible transcript content.
native audio props	AudioHTMLAttributes	—	Sources, media events, ref and settings.

Source ownership

Run npx @devvy-ui/cli init once in your React project, then add the source:

npx @devvy-ui/cli add audio-player

Make the source yours.

Start from the canonical implementation used by the package and registry. Change the code, keep the MIT notice, and build the behavior your project needs.

AudioPlayer.tsxREACT / TSX

import { forwardRef, type AudioHTMLAttributes, type ReactNode } from 'react';
import { safeURL } from '../lib/widgets';
export interface AudioPlayerProps extends AudioHTMLAttributes<HTMLAudioElement> {
  label: string;
  transcript: ReactNode;
}
export const AudioPlayer = forwardRef<HTMLAudioElement, AudioPlayerProps>(function AudioPlayer(
  { label, transcript, src, className, children, ...props },
  ref,
) {
  return (
    <figure className="dvy-media-player">
      {/* eslint-disable-next-line jsx-a11y/media-has-caption -- Native audio has a required visible transcript; audio caption tracks do not provide the transcript UI. */}
      <audio
        {...props}
        ref={ref}
        aria-label={label}
        controls
        preload={props.preload ?? 'metadata'}
        src={src ? safeURL(src, true) : undefined}
        className={['dvy-audio-player', className].filter(Boolean).join(' ')}
      >
        {children}
      </audio>
      {transcript && <figcaption>{transcript}</figcaption>}
    </figure>
  );
});

Edit your own copy. Downloaded source uses your changes; the component preview above uses the shipped version. Run the source installer first to include shared helpers.

Interactive preview

Usage

API reference

Accessibility & behavior

Platform Behavior & Guidelines

Source ownership

Make the source yours.