本文提供一种基于 css 自定义属性与 javascript 动态控制的可靠方案，解决呼吸训练中动画起始状态不一致、文字提示（inhale/exhale）与缩放动作不同步的问题，确保每次启动动画都从初始缩放值（scale(1)）精确开始。
在实现呼吸训练类 UI 时，一个常见但易被忽视的关键问题是：CSS 动画无法保证每次从初始状态干净重启。原代码使用 animation + @keyframes 并尝试通过 animationDuration = "0ms" 或强制 reflow 重置动画，但这类方式无法真正“中断并归零”当前动画进度——浏览器仍可能保留中间渲染状态（如 transform: scale(1.15)），导致后续 Inhale 文字显示时圆圈并未处于收缩起点，破坏呼吸节奏的可视化一致性。
✅ 正确解法是：弃用 animation，改用 transition + CSS 自定义属性（CSS Custom Property）驱动状态切换。这种方式将动画控制权完全交由 JS：通过添加/移除 class 触发过渡，并利用 :root 变量动态调节过渡时长，从而实现毫秒级精准启停与状态归零。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
核心实现要点
-
CSS 层：声明变量与过渡规则
在 :root 中定义 --transition-duration，并在 .circle 上绑定 transition: transform var(--transition-duration) ease-in-out。初始状态设为 transform: scale(1)，.inhale 类仅负责目标状态 scale(1.2)：
:root {
--transition-duration: 0ms;
}
.circle {
width: 200px;
height: 200px;
background-color: #4BC0C0;
border-radius: 50%;
display: flex;
justify-content: center;
align-items: center;
color: #fff;
font-size: 24px;
font-weight: bold;
transform: scale(1); /* 初始锚点，关键！ */
transition: transform var(--transition-duration) ease-in-out;
}
.circle.inhale {
transform: scale(1.2); /* 唯一变化属性 */
}-
JavaScript 层：状态驱动而非时间驱动
- 重置阶段：直接设置 --transition-duration: 0，移除 .inhale 类，并重置文字为 "Ready"，确保 DOM 状态与视觉状态严格一致；
- 启动阶段：先更新 --transition-duration 为吸入时长（如 5000ms），再通过 classList.add('inhale') 触发过渡；呼气则移除该类，自然回退。
function startAnimation(circleId, duration, totalCycles, timerId) {
const circle = document.getElementById(circleId);
const root = document.documentElement;
const inhaleTime = duration / 2;
const exhaleTime = duration / 2;
// ✅ 关键：动态设置过渡时长
root.style.setProperty('--transition-duration', `${inhaleTime}ms`);
let cycles = 0;
const animate = () => {
circle.innerHTML = "Inhale";
circle.classList.add("inhale"); // → 触发 scale(1) → scale(1.2)
setTimeout(() => {
circle.innerHTML = "Exhale";
circle.classList.remove("inhale"); // → 触发 scale(1.2) → scale(1)
setTimeout(() => {
cycles++;
if (cycles < totalCycles) {
animate(); // 下一周期
}
}, inhaleTime); // 注意：此处等待的是 *吸入完成* 时间点
}, exhaleTime);
};
animate();
}-
重置逻辑必须原子化
selectExercise() 中需同步执行三步操作（缺一不可）：- 清空自定义属性：root.style.setProperty('--transition-duration', '0')
- 移除状态类：circle.classList.remove('inhale')
- 重置内容与样式：circle.innerHTML = "Ready"
无需 offsetWidth 强制 reflow —— 因为 transition 的触发依赖 class 变更，而 class 移除后 transform 会立即回退到 scale(1)（由 CSS 规则定义）。
注意事项与优化建议
- ⚠️ 避免混用 animation 和 transition：原代码中残留的 animation-* 属性会与 transition 冲突，务必全部注释或删除。
- ? ease-in-out 是呼吸节奏的理想缓动函数，它使缩放在两端减速，模拟真实呼吸的自然起止。
- ? 如需支持暂停/继续，可扩展为监听 transitionend 事件 + getComputedStyle() 检查当前 transform 值，但本方案默认以“周期性完整循环”为设计前提。
- ? 兼容性：CSS 自定义属性和 transition 在所有现代浏览器（Chrome 49+, Firefox 31+, Safari 9.1+）中均受支持，无需 polyfill。
通过这一重构，呼吸动画彻底脱离了 CSS animation 的“黑盒状态管理”，转为可预测、可调试、可复位的状态机模型——每一次 Inhale 都从 scale(1) 精确开始，每一次 Exhale 都以 scale(1) 干净结束，真正实现视觉反馈与生理节律的严丝合缝。
