Documentation menu · Media
Media

LiquidGlassMediaControls

A floating control strip styled in liquid glass.

Live previewProduction package import

#Overview

Loading preview
Status
live
Category
Media
Package
aura-glass

#Install and Import

Install the package once, import the component from the public entry, and load styles a single time at the app root.

shell
npm install [email protected]
import
import { LiquidGlassMediaControls } from 'aura-glass/compat'
styles
import 'aura-glass/styles.css';

#Examples

Three baseline shapes flagship components use across docs and AI-agent guidance:

Basic

tsx
import { LiquidGlassMediaControls } from 'aura-glass/compat';
import 'aura-glass/styles.css';

export function MediaControlsExample() {
  return (
    <LiquidGlassMediaControls
      playing
      currentTime={42}
      duration={180}
      aria-label="Aurora Drift playback"
    />
  );
}

Production

tsx
import { LiquidGlassMediaControls, Card } from 'aura-glass';
import 'aura-glass/styles.css';

export function LiquidGlassMediaControlsSurface() {
  return (
    <Card>
      <LiquidGlassMediaControls
        aria-label="Media production surface"
      />
    </Card>
  );
}

Contained

tsx
import { LiquidGlassMediaControls, Card } from 'aura-glass';
import 'aura-glass/styles.css';

export function LiquidGlassMediaControlsContainedPreview() {
  return (
    <Card style={{ maxWidth: 420 }}>
      <LiquidGlassMediaControls />
    </Card>
  );
}

#Accessibility

Expose play, pause, seek, volume, captions, and time information with labels. Do not rely only on icons.

#SSR and Performance

Pause analyzers when playback stops, when the tab is hidden, and when reduced motion is enabled.

#Theming

Theme with public props, `className`, `style`, and AuraGlass CSS variables. Avoid private DOM selectors so the component can upgrade with the package.