HTML5的<audio>标签本质是语义化容器，需配合controls属性显示控件、autoplay+muted实现受限自动播放，并依赖JavaScript事件（如loadedmetadata、ended）和方法（play/pause）进行精准控制与状态管理。
HTML5 的 <audio> 标签本质是语义化容器，不是“播放器”本身——它声明“这里有一段音频”，而播放行为、状态反馈、交互控制都需靠属性配合与 JavaScript 协同完成。单纯写个 <audio src="xxx.mp3"></audio> 不会显示控件，也无法被用户操作。
语义化结构：从声明到兼容降级
语义化的起点是正确表达意图和容错能力：
- 必须包含 controls 属性才能让音频对用户可见且可操作；不加则 DOM 存在，但页面无任何 UI，也不响应点击
- 使用
<source>元素提供多格式备选（如 MP3 + OGG），浏览器按顺序尝试首个支持的类型，避免因格式不兼容导致静默失败 - 在
<audio>标签内部写一段提示文字（如“您的浏览器不支持音频播放”），这是给老旧或禁用 JS 浏览器的降级内容，属于无障碍基础实践 - 添加 preload="metadata" 是语义优化：告诉浏览器“只需加载时长、采样率等元信息”，既提升首屏性能，又为后续进度条、时间显示提供必要数据
播放控制：属性声明与 JS 调用不可混用
HTML 属性负责初始状态声明，JavaScript 负责运行时动态干预，二者职责分明：
Html To Pdf
下载
使用 Puppeteer + Chrome 将 HTML 渲染为中文 PDF，自动处理图表等待、Tab 展开、动画、测高、白边消除、防分页，适用于看板、报表、网页和交互图表转 PDF。
- autoplay 和 muted 必须同时存在才可能触发自动播放（尤其在 iOS 和 Chrome 移动端），单独 autoplay 几乎总被忽略
-
loop 是纯声明式属性，启用后无需 JS 干预即可循环；但若想在播放结束时执行其他逻辑（如切换下一曲），仍需监听
ended事件 - 调用
play()或pause()是唯一有效启停方式；给paused属性赋值无效，它只是只读状态标识 -
play()返回 Promise，失败时会 reject（例如未获用户手势授权），应捕获错误而非静默忽略
时间与状态管理：时机比代码更重要
很多“跳转失败”“进度条不动”的问题，根源不在写法，而在执行时机：
立即学习“前端免费学习笔记（深入）”；
-
duration初始为NaN，必须等待loadedmetadata或canplay事件后再读取，否则无法获取总时长 - 设置
currentTime前，确保音频至少已加载元数据；若源刚切换，需先调用load()再设时间点 - 拖动进度条时，应绑定
input事件（实时响应）或change事件（松手后触发），并在回调中直接赋值currentTime，不必手动调用play()—— 若原处于暂停态，跳转后保持暂停；若正在播，则继续播 - 监听
timeupdate更新当前时间显示，但该事件触发频繁，建议用requestAnimationFrame节流或简单防抖
移动端与跨平台适配要点
不同平台策略差异明显，硬编码容易失效：
- iOS Safari 对自动播放限制最严：即使
muted+autoplay，首次播放仍常需用户点击触发；更稳妥做法是用按钮显式启动 - Android Chrome 允许静音自动播放，但仅限页面加载后短时间内；延迟调用
play()仍可能被拒 - 部分安卓 WebView 或旧版浏览器不支持
playbackRate或buffered，需做特性检测（canPlayType或 try-catch） - 避免复用同一 Audio 实例频繁切换 src：iOS 下易出现状态残留；推荐每次播放新建实例或调用
load()重置内部状态
