uni-app侧边栏联动核心是scroll-into-view+ref双向驱动:左侧点击跳转右侧,右侧滚动反向高亮左侧;须避坑scroll-y缺失、id非法、scrollTop手动设值卡顿;禁用onPageScroll,因仅适用于页面级滚动而非scroll-view内部。
scroll-view做分类侧边栏联动,核心就两件事不是靠page-scroll事件硬监听,也不是用scrollTop反复设值——真正稳定的做法是:左侧菜单点击驱动右侧滚动,右侧滚动反向高亮左侧项。两者都走scroll-into-view + ref定位,避开手动计算滚动高度的坑。
常见错误现象:scroll-view没加scroll-y导致无法滚动;右侧列表id带中文或空格,scroll-into-view直接失效;用scrollTop动态设置时,在iOS上卡顿、跳动、甚至不响应。
id(纯字母/数字/下划线,如category-food)@click="jumpTo('category-food')",跳转函数里调this.$nextTick再执行scrollIntoView
scroll-view需设:scroll-top="currentTop"并监听@scroll,但仅用于更新左侧高亮,不用于控制滚动onPageScroll监听页面滚动来做联动因为onPageScroll在scroll-view内部无效,它只响应整个页面的滚动(即pages.json里disableScroll: false时的page级滚动)。而美团式侧边栏99%跑在scroll-view里,否则无法固定左侧菜单、也无法精准锚点对齐。
真实场景中,用户快速滑动右侧列表时,onPageScroll根本收不到事件;即使能收到,它的scrollTop单位是px,和scroll-view的scrollTop数值也不一致,换算极易出错。
scroll-view而不是整页滚动,检查模板里有没有<scroll-view scroll-y>
onPageScroll,会发现iOS下完全不触发,Android下触发但位置偏移——这不是bug,是机制不匹配scroll-view自身的@scroll事件,取detail.scrollTop做判断scroll-into-view在uni-app里容易被忽略的三个兼容性细节这个API看着简单,但在不同端表现差异极大。最常踩的坑不是写法错,而是没处理好端间行为断层。
scrollIntoView({ block: 'start' }),但App和小程序只认scroll-into-view属性绑定的id字符串,不支持配置对象id必须在scroll-view子元素第一层,嵌套一层view就找不到——得写成<scroll-view><view id="xxx">...</view></scroll-view>
scroll-into-view响应有延迟,必须配合this.$nextTick(() => { ... }),否则id还没渲染完成就去滚动,静默失败右侧滚动时高亮左侧对应菜单,关键不在“滚到哪”,而在“当前可视区域覆盖了哪个区块”。别用scrollTop除以平均高度来猜——分类区块高度不一,顶部吸顶、间距、padding都会干扰。
正确做法是遍历所有分类区块的boundingClientRect,看哪个的top最接近0(即刚进入视口),再结合height判断是否过半。uni-app里用uni.createSelectorQuery()比getRect更可靠。
@scroll里频繁调查询,加节流(比如setTimeout防抖300ms).exec回调,不要依赖async/await,uni-app旧版本不支持Promise化then里,查到top < 0 && top + height > 0的项就停,避免遍历全部复杂点在于吸顶标题和空状态区块会打乱位置计算,这些节点得提前过滤掉。事情说清了就结束