最稳妥结构是内联svg，配aria-label或aria-hidden="true"；svg须内联以支持css动画；仅transform/opacity/fill可动画，d属性不可；状态用dataset管理，防连点加pointer-events: none。
按钮点击后图标切换用什么 HTML 结构最稳妥
直接用 <button></button> 包裹一个 <i></i> 或 <svg></svg>，别用 <div role="button"> 模拟——语义错误、键盘焦点和屏幕阅读器支持都会出问题。图标必须是内联元素，且不能脱离按钮的可访问性上下文。
<p>推荐结构：</p>
<pre class="brush:php;toolbar:false;"><button type="button" aria-label="切换静音状态">
<svg class="icon" viewbox="0 0 24 24"><path d="M12 3v10.55c-.59-.34-1.27-.55-2-.55-2.21 0-4 1.79-4 4s1.79 4 4 4 4-1.79 4-4V7h4V3h-6z"></path></svg></button></pre>
<ul>
<li>
<code>aria-label 必须写，尤其当图标无文字时；若按钮内有可见文字（如“播放”），可用 aria-hidden="true" 隐藏图标，避免重复朗读
background-image 里——无法用 CSS 控制 SVG 路径动画，也无法通过 JS 切换 class 精准控制状态fill、transform 和 @keyframes 直接驱动动画，外链或 base64 不行CSS 实现图标变形动画的关键限制
不是所有 SVG 属性都能动画。只有「可计算属性」（如 transform、opacity、fill）能平滑过渡；d 属性（路径数据）不能直接动画，强行加 transition: d 0.3s 会完全失效。
可行方案只有两个：
- 用两套
<path></path>，通过opacity+visibility切换显示（适合简单开关，如播放/暂停） - 用
transform移动/缩放/旋转已有路径（适合形变较轻的动效，如汉堡菜单 → X）
例如汉堡变 X：
.icon.burger .line:nth-child(1) { transform: rotate(45deg) translate(6px, 6px); }
.icon.burger .line:nth-child(2) { opacity: 0; }
.icon.burger .line:nth-child(3) { transform: rotate(-45deg) translate(6px, -6px); }
注意：必须给每条线加 transform-origin: center，否则旋转中心偏移；translate 值要根据 SVG viewBox 尺寸微调，24×24 下 ±6px 是常见起点。
文章转信息图。将文章/笔记转化为手机可读的 HTML 信息图，自动匹配视觉风格。触发场景：文章转图、笔记转图、信息图、转小红书图、做张图、可视化这篇文章、文生图。
JS 切换图标状态时容易漏掉的细节
只切 class 名不够。很多开发者写了 btn.classList.toggle('active') 就以为完事，但没处理状态同步、过渡中断、多次快速点击等问题。
- 用
dataset记录当前状态（如data-state="play"），比靠 class 存在与否判断更可靠 - 添加
pointer-events: none到按钮上（配合transitionend事件恢复），防止连点导致动画错乱 - 如果图标变化依赖异步操作（如请求后才允许切换），务必在 Promise resolve 后再更新 UI，而不是点击瞬间就切状态
最小可用逻辑示例：
const btn = document.querySelector('button');
btn.addEventListener('click', () => {
if (btn.dataset.state === 'loading') return;
btn.dataset.state = 'loading';
btn.style.pointerEvents = 'none';
someApiCall().finally(() => {
btn.dataset.state = btn.dataset.state === 'on' ? 'off' : 'on';
btn.style.pointerEvents = '';
});
});
移动端 Safari 的 SVG 动画兼容性坑
iOS 15.4 之前，Safari 对 SVG 内联样式中的 transform 动画支持不稳定，尤其是 rotate() + translate() 组合，可能出现跳帧或卡死。不是 bug，是渲染管线限制。
- 绕过方式：改用
scale(0)→scale(1)或纯opacity切换，牺牲一点表现力换稳定性 - 必须为 SVG 加
width和height属性（哪怕只是width="24"），否则 iOS 可能忽略transform-origin - 避免在
@keyframes中写transform: rotate(0deg) translateX(0)这类冗余值——Safari 解析慢，易触发回流
真正难的不是做出动画，而是让同一段代码在 Chrome、Firefox、Edge、Safari（含旧版 iOS）里都按预期执行一次、只执行一次、不闪不跳。这点常被 demo 视频忽略。
