SVG动画需依赖HTML5上下文支持，纯SVG内联动画已弃用；推荐用style.transform操作、IntersectionObserver触发、预设路径模板插值及校准viewBox等方案确保跨环境一致性。

SVG 动画本身不依赖 HTML5，但真正实用的「SVG 动画」几乎都离不开 HTML5 的上下文支持——比如用 requestAnimationFrame 控制帧率、用 IntersectionObserver 触发入场动画、或通过 dataset 传递参数。纯 SVG 内联动画（）在现代项目中已基本弃用，兼容性差、无法交互、调试困难。

用 document.getElementById 拿到 SVG 元素后直接操作 style.transform

这是最轻量、最可控的联动方式。SVG 元素（如 、）和 HTML 元素一样支持 style.transform，且硬件加速生效，性能远好于修改 cx/cy 属性。

常见错误：试图对 根节点设 transform 后再对子元素设 transform，导致坐标系嵌套混乱；或误用 getBBox() 在未渲染时调用（返回空矩形）。

• 确保 SVG 已插入 DOM 且完成 layout（可用 offsetParent 判定，或放 setTimeout(fn, 0)）
• 优先用 translate3d(0,0,0) 触发 GPU 加速，避免 translateX/Y 在某些安卓 WebView 中掉帧
• 不要用 setAttribute('transform', '...') 频繁更新——它会触发重排；改用 element.style.transform = '...'

const circle = document.getElementById('my-circle');
let x = 0;
function animate() {
  x += 2;
  circle.style.transform = `translate3d(${x}px, 0, 0)`;
  if (x < 400) requestAnimationFrame(animate);
}
animate();

监听 HTML5 input[type="range"] 实时驱动 SVG 路径变形

用 range 滑块控制 的 d 属性是最典型的 SVG/HTML5 联动场景。关键在于：不能拼接字符串生成 d，而应预先定义好路径模板，用插值函数动态计算控制点。

容易踩的坑：滑块 value 是字符串，直接参与运算会隐式转成 NaN；或未对 path 设置 vector-effect: non-scaling-stroke，缩放时描边粗细异常变化。

• 用 parseFloat(event.target.value) 显式转数字
• 路径数据尽量用三次贝塞尔曲线（C 或 c），比 Q 更易控制曲率连续性
• 若需响应式缩放，把 设为 width="100%" height="auto"，并在 JS 中监听 window.resize 重绘

const slider = document.getElementById('curve-slider');
const path = document.getElementById('morph-path');
function updatePath(t) {
const x1 = 50 + t  100;
const y1 = 80 - t  30;
path.setAttribute('d', M20,100 C${x1},${y1} ${x1+50},${y1+60} 150,100);
}
slider.addEventListener('input', (e) => {
updatePath(parseFloat(e.target.value));
});

用 IntersectionObserver 触发 SVG 元素淡入+位移动画

滚动触发动画必须用 IntersectionObserver，而不是监听 scroll 事件——后者在快速滚动时丢帧严重，且无法处理 position: sticky 等复杂布局。

注意：SVG 元素默认没有 getBoundingClientRect() 的滚动感知能力，必须包裹一层 或使用 svg.parentElement 做观察目标；且 opacity 动画需配合 will-change: opacity 防止闪烁。

• 阈值设为 [0.05]（5% 进入视口即触发），比 0 更可靠
• 动画启动后立即 unobserve，避免重复触发
• 若 SVG 内含大量 引用，确保被引用的 在文档内已定义

const observer = new IntersectionObserver((entries) => {
  entries.forEach(entry => {
    if (entry.isIntersecting) {
      const svg = entry.target.querySelector('svg');
      svg.style.opacity = '1';
      svg.style.transform = 'translateY(0)';
      observer.unobserve(entry.target);
    }
  });
}, { threshold: [0.05] });
document.querySelectorAll('.js-svg-trigger').forEach(el => {
observer.observe(el);
});

真正难的不是写动画，而是让 SVG 在不同缩放、不同 DPR、不同滚动状态下的坐标系保持一致。很多“动画失效”问题，根源是 viewBox 和 preserveAspectRatio 配置与容器尺寸不匹配，这点比 JS 逻辑更值得花时间验证。