HTMLAudioElement

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Giao diện HTMLAudioElement cung cấp quyền truy cập vào các thuộc tính của các phần tử <audio>, cũng như các phương thức để thao tác chúng.

Giao diện này dựa trên, và kế thừa các thuộc tính và phương thức từ, giao diện HTMLMediaElement.

EventTarget Node Element HTMLElement HTMLMediaElement HTMLAudioElement

Hàm khởi tạo

Audio()

Tạo và trả về đối tượng HTMLAudioElement mới, tùy chọn bắt đầu quá trình tải tệp âm thanh vào nó nếu URL tệp được cung cấp.

Thuộc tính phiên bản

Không có thuộc tính cụ thể; kế thừa thuộc tính từ lớp cha, HTMLMediaElement, và từ HTMLElement.

Phương thức phiên bản

Kế thừa phương thức từ lớp cha, HTMLMediaElement, và từ HTMLElement. Không có phương thức riêng.

Ví dụ

Sử dụng cơ bản

Bạn có thể tạo HTMLAudioElement hoàn toàn bằng JavaScript sử dụng hàm khởi tạo Audio():

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

sau đó bạn có thể gọi phương thức play() trên phần tử

js
audioElement.play();

Note: Một lỗi phổ biến là cố gắng phát phần tử âm thanh ngay khi trang tải. Chính sách autoplay mặc định của các trình duyệt hiện đại sẽ chặn điều đó xảy ra. Tham khảo Firefoxchrome để biết các thực hành tốt nhất và cách giải quyết.

Một số thuộc tính được sử dụng phổ biến nhất của phần tử âm thanh bao gồm src, currentTime, duration, paused, muted, và volume.

js
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
});

Sự kiện

Kế thừa phương thức từ lớp cha, HTMLMediaElement, và từ tổ tiên HTMLElement. Lắng nghe sự kiện bằng cách sử dụng addEventListener() hoặc bằng cách gán trình xử lý sự kiện vào thuộc tính oneventname của giao diện này.

Thông số kỹ thuật

Specification
HTML
# htmlaudioelement

Tương thích trình duyệt

Xem thêm