发生了什么
换电业务里,商户要在某个城市开展业务,得先在商户端 App 里选城市、开通这个城市,这一步叫“开城”;开通后商户会拿到一段免费使用时长,也就是免时长。城市不是手输的,而是从一个下拉面板里选:点开输入框,弹出城市列表,商户在列表里点中一个城市,名称回填到输入框,再继续提交。
正常流程是:商户在某个城市已经生效、有该城市的开城列表权限、也还有剩余免时长,点开城市选择,就能在列表里看到并选中这个城市;选中后继续下一步。也就是说,城市在不在列表里,取决于商户有没有这个城市的开城列表权限;能不能选中,由下拉面板能不能保持展开决定。
这次两件事混在了一起。商户确实有目标城市的权限,免时长也还在,但城市列表一长,手指在面板里往上滑、去翻后面的城市时,整个下拉面板自己收起来了,一项都点不到。收起后面板看起来和没打开一样,商户只能反复点开、再滑、再被关掉,最后反馈成“App 里搜不到这个城市”。影响多少商户、持续了多久,记录里没有统计。
在这之前,这个页面还修过另一个问题:清空手机号输入框后,页面上方的吸顶区域显示不正常。吸顶区域是滚动时固定在页面顶部的那一块。当时的做法是在页面里监听全局的滚动事件,页面一滚动,就顺手把打开着的下拉菜单关掉。城市选择的这段关闭逻辑,就是那次改动带进来的。
本质
问题出在关闭下拉面板的条件上:它把“页面滚动”当成了“用户要离开下拉框”,却没有区分这次滚动发生在页面主体,还是发生在下拉列表内部。
- 城市列表的数据一多,列表高度超过面板高度,列表自身变成可滚动区域,只有滑动它才能看到后面的城市。
- 关闭逻辑监听的是 window 上的滚动事件,并且开在捕获阶段;手指在列表内部滑动时,这个事件同样会被它收到。列表滚动的本意是翻看后面的城市,在这里却被当成页面在滚动。
- 处理函数收到事件后直接关闭:把面板的展开状态置为 false,列表从页面上移除,刚滑到一半的位置也一起丢了。
- 城市越多、列表越长、越需要滑动,面板就越容易在目标城市露出来之前被关掉。商户看到的结果是“列表里没有这个城市”,实际是还没翻到就被收起了。
- 同一段监听还把“页面滚动”和“下拉框开不开”绑死:页面主体滚动会关它,列表内部滚动也会关它。出问题时从城市选择本身查,很难想到是页面别处的滚动监听在关它。
关闭条件没有区分滚动发生在哪里,列表自身的滑动被当成页面滚动,面板在选中之前就被关掉了。
修复方向是:下拉面板打开期间不再监听全局 scroll,改成监听 visualViewport 的 resize 来更新面板位置,只在键盘弹出、收起这类可视区域变化时重新定位;面板只在选中城市、点击面板外部或主动取消时收起。记录没有说明这个改动是否已经上线、上线后是否验证过。
下面的代码为脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
// 城市选择面板:打开时挂全局滚动监听,滚动就关闭(脱敏教学示例)
function openCityPanel() {
panel.open = true;
render(panel);
// 为什么错:关闭逻辑挂在 window 的 scroll 上并开在捕获阶段,
// 下拉列表内部滚动也会被它收到,被当成“页面滚动”
window.addEventListener('scroll', closeCityPanel, true);
}
function closeCityPanel() {
panel.open = false;
render(panel);
window.removeEventListener('scroll', closeCityPanel, true);
}
function onCityListScroll() {
// 用户在这里滑动翻后面的城市,事件被上层 window 捕获,
// closeCityPanel 紧接着执行,目标城市还没露出来面板就没了
trackListScroll(panel.listEl);
}
修复代码示例
// 同一面板:去掉全局滚动监听,只跟可视区域变化定位(脱敏教学示例)
let viewportHandler = null;
function openCityPanel() {
panel.open = true;
render(panel);
// 修复:不再监听全局 scroll,只监听 visualViewport 的 resize,
// 键盘弹出、收起时重新定位面板,不改变展开状态
viewportHandler = () => positionCityPanel(panel.listEl);
window.visualViewport?.addEventListener('resize', viewportHandler);
document.addEventListener('pointerdown', onPointerDown, true);
}
function onCityListScroll() {
// 修复:列表内部滚动只更新列表自身,不关闭面板,用户可以继续往后翻
positionCityPanel(panel.listEl);
}
function closeCityPanel() {
panel.open = false;
render(panel);
window.visualViewport?.removeEventListener('resize', viewportHandler);
document.removeEventListener('pointerdown', onPointerDown, true);
}
function onPointerDown(event) {
// 修复:只有点在面板外面才收起,点列表内部不算离开
if (!panel.listEl.contains(event.target)) closeCityPanel();
}
下次遇到这些场景要警惕
- 给下拉框或浮层加“滚动即关闭”时,先构造一份长度明显超过面板高度的选项,在列表内部滑动翻找,观察面板是否在选中之前收起。
- 遇到“选项里没有某条数据”的反馈,先确认列表有没有正常展开并保持住,再查权限和接口返回;本例权限、城市数据、剩余免时长都在,断的是选中这一步。
- 用全局事件驱动浮层状态时,检查事件来源是否可能落在浮层内部;能绑在目标元素上,就不要挂到 window 或 document 上。
- 用 visualViewport 的 resize 处理键盘遮挡后,分别回归“列表内部滚动”和“页面主体滚动”两种操作,确认位置更新和面板关闭是两件独立的事。