页面顶部本来就有个会自己弹出来、四秒后自己收起的「灵动岛」——消息提示走那儿。后来我给站点加了音乐播放器,顺手就想:再起一个 fixed 悬浮层多省事。
结果是两个浮层在右上角打架,一个收起来另一个还在,看着很难受。最后决定把播放器塞进那个岛里,共用一套容器。这一改,冒出来四个坑,症状全是「看不出来为什么」。
一、宿主的 opacity:0 写在模板里,CSS 覆盖不掉
第一版改完,岛不显示。我加了一堆类名和 !important,怎么都不出来。
因为那个 opacity:0 是后端模板直接输出的内联样式:
<div id="dynamicIsland" style="opacity:0">…</div>
内联样式优先级本来就高于选择器,而且这个值多半由 JS 后续改写成 1——但常驻挂件根本不该等那个流程。结论很简单:必须用 JS 改内联值,CSS 层怎么努力都是空转。
host.style.opacity = '1';
host.classList.remove('inactive');
host.classList.add('active');
顺手把旧的挂件容器留着但 display:none,别删——里面可能有既有的定位样式,删了以后想回退就麻烦。
body .lcbk-music { display: none !important; }
二、四秒后,播放器被宿主的定时器一起收走了
第二条是实现一半才发现的:双击播放、切歌都正常,但过几秒岛自己缩回去了,音乐还在响,界面没了。
宿主有自动收起逻辑——trigger() 弹出,四秒后定时器回调收起。它不知道里面现在装的是一个「该常驻」的播放器。
只在 CSS 上写「常驻」是没用的,因为动手的是定时器。正确做法是在两个入口都短路掉:
function isMusicMounted() {
return host.classList.contains('is-music');
}
// 原来的自动收起入口
function trigger() {
if (isMusicMounted()) { keepOpen(); return; }
// …原有逻辑
}
// 四秒定时器回调
setTimeoutTimer = setTimeout(function () {
if (isMusicMounted()) { keepOpen(); return; }
collapse();
}, 4000);
keepOpen() 里除了恢复展开态,还要 clearTimeout——否则定时器已经被重置过一次,下次还会再来一遍。
还有一个容易漏的点:展开/收起的点击事件要绑在宿主上,不是原来那个挂件容器。绑错地方的表现是「鼠标放上去没反应」,但代码看着完全正常。
三、收起态量宽度是 64,展开后是 320,夹紧该用哪个
给这个胶囊加拖拽之后,位置开始漂。存进去是 left: 900px,恢复回来变成 799。
因为夹紧边界的时候我用了 offsetWidth:
// 错:收起态读到 64,过渡中读到的是中间某个值
var half = host.offsetWidth / 2;
host.style.left = Math.min(Math.max(left, pad + half), innerWidth - pad - half) + 'px';
而这个胶囊在悬停/拖动时会展开到 min(320px, 100vw - 24px) × 58。用 64 算边界,展开后必然越界;用过渡中的瞬时值算,结果每次都不一样。
正确做法是拿「拖动时将呈现的尺寸」去算:
var w = Math.min(320, innerWidth - 24);
var h = 58;
var minX = pad + w / 2;
var maxX = innerWidth - pad - w / 2;
位置表达也别改成 transform: translate(x, y)——这个元素已经在用 translateX(-50%) 做居中,还有状态相关的 scale,混着写迟早对不上。居中 + left 就够了,夹紧时按半宽算。
另外两个配套的小事:一是从 localStorage 读回坐标时,也要按展开尺寸再夹一次再落盘,不然旧坐标在大尺寸状态下会越界;二是初始化时元素可能还没渲染(隐藏态或动画没开始),offsetWidth 是 0,拿 0 参与计算会存下完全错误的坐标——这时候回退默认尺寸,且不要写库。
拖拽本身还有两个细节:位移超过 5px 才进拖动态(否则点击会被判成拖动),以及松手后用一次性标记(活 300ms 左右)在 click 里吞掉那次点击,避免「拖完顺手把面板也展开了」。
四、切到后台,宽度被永久卡在 64px
最后一个坑最像玄学。
切歌时我想要宽度平滑地 morph 一下,用了 Web Animations:
host.style.width = from + 'px';
host.animate([{ width: from + 'px' }, { width: to + 'px' }],
{ duration: 420, easing: 'cubic-bezier(0.22,0.61,0.36,1)' });
正常情况没问题。但如果此刻页面在后台(document.hidden === true),WAAPI 的时间线不推进,onfinish 永远不触发,内联的 width 就永远停在起始值上——CSS 里的 width 规则完全失效,看起来像「样式坏了」。
排查三步:先读 host.getAttribute('style') 里是否残留 width,再 getAnimations() 看是否空数组,最后确认 document.hidden。三个一起看,基本就能定性。
修法是别只依赖 onfinish,加一条比自己时长略长一点的定时兜底:
var anim = host.animate(
[{ width: from + 'px' }, { width: to + 'px' }],
{ duration: 420, easing: 'cubic-bezier(0.22, 0.61, 0.36, 1)' }
);
var fallback = setTimeout(function () {
if (morphAnim === anim) { host.style.width = ''; morphAnim = null; }
}, 460);
anim.onfinish = anim.oncancel = function () {
clearTimeout(fallback);
host.style.width = '';
morphAnim = null;
};
内容切换(文字 ↔ 播放器内容)也别用 display:none,那样淡入淡出根本没法做。用 opacity 加 visibility,并且给 visibility 一个延迟,收起时让它等淡出跑完再隐藏。
五、小结
| 坑 | 症状 | 原因 |
|---|---|---|
| 岛不显示 | 加类名、!important 都无效 |
模板内联 opacity:0 压过 CSS |
| 几秒后自己收了 | 音乐在响,界面没了 | 宿主自动收起定时器不知道里面装了常驻内容 |
| 拖完位置漂移 | 存 900 回来 799 | 用收起态 offsetWidth 或过渡中间值夹紧 |
| 宽度卡死 | 切后台回来宽度不变 | WAAPI 在隐藏页面不推进,onfinish 不触发 |
四个坑的共同点是「代码不报错、逻辑看着也对」,坏在别人的既定行为上:模板写死了内联样式、宿主有自己的定时器、元素有两种尺寸、浏览器在后台会停掉动画时间线。
所以改别人的容器之前,先把它原来的状态机读一遍——它什么时候显示、什么时候收、尺寸有几种形态,比急着往里塞东西重要得多。