HTMLAudioElement

Das HTMLAudioElement-Interface bietet Zugriff auf die Eigenschaften von <audio>-Elementen sowie Methoden zu deren Manipulation.

Dieses Element basiert auf dem HTMLMediaElement-Interface und erbt von diesem Eigenschaften und Methoden.

Konstruktor

Audio()

Erstellt und gibt ein neues HTMLAudioElement-Objekt zurück. Optional kann der Ladevorgang einer Audio-Datei in das Objekt gestartet werden, wenn die Dateiadresse angegeben ist.

Instanz-Eigenschaften

Keine spezifischen Eigenschaften; erbt Eigenschaften von seinem Elterninterface HTMLMediaElement und vom HTMLElement.

Instanz-Methoden

Erbt Methoden von seinem Elterninterface HTMLMediaElement und vom HTMLElement. Es bietet keine eigenen Methoden an.

Beispiele

Grundlegende Verwendung

Sie können ein HTMLAudioElement vollständig mit JavaScript unter Verwendung des Audio()-Konstruktors erstellen:

const audioElement = new Audio("car_horn.wav");

dann können Sie die play()-Methode auf dem Element aufrufen

audioElement.play();

Einige der am häufigsten verwendeten Eigenschaften des Audio-Elements sind src, currentTime, duration, paused, muted und volume. Dieses Snippet kopiert die Dauer der Audiodatei in eine Variable:

const audioElement = new Audio("car_horn.wav");
audioElement.addEventListener("loadeddata", () => {
 let duration = audioElement.duration;
 // The duration variable now holds the duration (in seconds) of the audio clip
});

Events

Erbt Methoden von seinem Elterninterface HTMLMediaElement und von seinem Vorfahren HTMLElement. Sie können Events mit addEventListener() überwachen oder einen Event-Listener an die oneventname-Eigenschaft dieses Interfaces zuweisen.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Web-Medientechnologien
• Audio- und Video-Bereitstellung
• HTML-Element, das dieses Interface implementiert: <audio>.