JavaScript原生实现音乐播放器需控制audio元素：1.点击按钮切换播放/暂停；2.拖动进度条实时跳转时间；3.监听timeupdate更新UI；4.监听loadedmetadata确保元数据加载后设置duration；5.格式化时间显示为mm:ss。
用 JavaScript 实现一个基础音乐播放器，核心是控制 <audio></audio> 元素的行为——播放/暂停、跳转时间、监听进度、同步时间轴 UI。不需要框架，原生 API 就够用，关键是理清几个关键点。
1. 搭建音频容器和基础控制按钮
先在 HTML 中放一个 <audio></audio> 标签（可隐藏）和几个按钮 + 进度条：
<audio id="player" src="song.mp3"></audio> <button id="playBtn">播放</button> <input type="range" id="progress" min="0" max="100"> <span id="currentTime">0:00</span> / <span id="duration">0:00</span>
JavaScript 里获取元素并绑定点击事件：
const audio = document.getElementById('player');
const playBtn = document.getElementById('playBtn');
const progress = document.getElementById('progress');
<p>playBtn.addEventListener('click', () => {
if (audio.paused) {
audio.play().catch(e => console.warn('播放被阻止：', e));
} else {
audio.pause();
}
});
注意：audio.play() 可能被浏览器静音策略拒绝（尤其自动调用），务必由用户手势（如 click）触发。
立即学习“Java免费学习笔记（深入）”；
2. 控制播放时间与拖动进度条
要让进度条拖动时跳转到对应时间，需把 input[type="range"] 的值映射为秒数：
- 监听
progress的input事件（实时拖动），而非change（松手才触发） - 用
audio.duration计算目标时间：audio.currentTime = progress.value / 100 * audio.duration - 确保
audio.duration已加载完成（监听loadedmetadata或检查是否为有限值）
示例代码：
audio.addEventListener('loadedmetadata', () => {
progress.max = audio.duration || 100; // 防止 NaN
document.getElementById('duration').textContent = formatTime(audio.duration);
});
<p>progress.addEventListener('input', () => {
const time = parseFloat(progress.value) / 100 * audio.duration;
audio.currentTime = isNaN(time) ? 0 : time;
});
3. 实时更新时间轴与进度条
用 timeupdate 事件监听播放进度（约每 200–250ms 触发一次）：
- 更新当前时间显示：
currentTime.textContent = formatTime(audio.currentTime) - 同步进度条位置：
progress.value = (audio.currentTime / audio.duration) * 100 - 写个简单的
formatTime(seconds)把秒转成mm:ss格式（注意补零）
例如：
function formatTime(sec) {
const mins = Math.floor(sec / 60);
const secs = Math.floor(sec % 60);
return `${mins}:${secs < 10 ? '0' : ''}${secs}`;
}
<p>audio.addEventListener('timeupdate', () => {
if (!isNaN(audio.duration)) {
progress.value = (audio.currentTime / audio.duration) * 100;
document.getElementById('currentTime').textContent = formatTime(audio.currentTime);
}
});
4. 处理播放结束与错误
常见状态需响应：
-
ended：播放完毕后自动暂停，可重置按钮文字或自动播下一首 -
error：加载失败时提示，比如检查audio.error码（MediaError.MEDIA_ERR_SRC_NOT_SUPPORTED等） -
pause和play：同步按钮文字（“播放” ↔ “暂停”）
例如同步按钮文字：
audio.addEventListener('play', () => playBtn.textContent = '暂停');
audio.addEventListener('pause', () => playBtn.textContent = '播放');
audio.addEventListener('ended', () => {
audio.currentTime = 0;
playBtn.textContent = '播放';
});
基本上就这些。不复杂但容易忽略细节：元数据加载时机、时间格式化、拖动时的 NaN 判断、以及浏览器自动播放策略。把这几个点串起来，一个可交互的简易播放器就跑起来了。
