最后更新:2026-09-12
<audio>音频标签
用于在页面中嵌入音频播放器,常配合 source 提供多种格式以保证兼容。
| 分类 | 链接与媒体 |
|---|---|
| 内容模型 | 嵌入内容 |
| 允许的父元素 | 接受流式内容的元素 |
| 闭合标签 | 需要 </audio> 标签 |
| 状态 | 标准 |
📝 语法
<audio controls>音频内容</audio>
⚙️ 属性
该元素支持全局属性及以下专有属性:
| 属性 | 值 | 描述 |
|---|---|---|
src | 音频文件 URL(单文件时可用,多格式用 source)。 | |
controls | 显示播放/暂停、音量等控件。 | |
autoplay | 页面加载后自动播放(多需配合 muted)。 | |
loop | 播放结束后循环。 | |
muted | 默认静音。 | |
preload | 预加载策略:none/metadata/auto。 |
▶ 示例
编辑下方代码,在 playground 中查看实时效果:
🌐 浏览器支持
| 浏览器 | |||||
|---|---|---|---|---|---|
| <audio> | ✓ v1 | ✓ v12 | ✓ v1 | ✓ v1 | ✓ v1 |
| 所有主流浏览器均支持 | |||||
提示: 加 controls 才显示播放控件;自动播放通常需配合 muted 才能生效(浏览器策略限制)。
🏷️ 相关标签
💡 相关案例
更多案例即将上线,敬请期待。