讲师中心 微信公众号
AI工具推荐 视频效率加速

uni-app实现左右联动菜单 uni-app分类页面双向滚动实现

千晨小哥_5345

千晨小哥_5345

发布时间:2026-05-08 08:02:00

|

993人浏览过

|

来源于php中文网

原创

左右联动菜单核心是scroll-view嵌套+scroll-into-view控制,左侧滚动高亮、右侧滚动自动定位;需节流监听、DOM就绪校验、固定高度及避免样式干扰。

uni-app实现左右联动菜单 uni-app分类页面双向滚动实现

左右联动菜单的核心逻辑是 scroll-view 嵌套 + scroll-into-view 控制

uni-app 里没有原生的 sticky 或 sync-scroll,左右联动本质是「左侧菜单滚动时高亮对应项,右侧内容滚动时自动定位到对应菜单项」。关键不是监听 scroll 事件本身,而是利用 scroll-into-view 主动滚动左侧,用 scrollTop + getBoundingClientRect(通过 uni.createSelectorQuery)判断当前可视区域属于哪个分类区块。

常见错误:直接监听 scrolltoupper 或 scrolltolower,这两个只在滚动到顶/底才触发,无法实现精细联动;还有人试图用 scroll-y + bindscroll 频繁 setData,导致卡顿甚至白屏。

  • 左侧菜单必须用 scroll-view 包裹,且设 scroll-y 和固定高度(不能靠内容撑开)
  • 右侧内容区也必须是 scroll-view,禁用 scroll-y 的默认滚动条(加 show-scrollbar="false" 更干净)
  • 每个分类区块需有唯一 id(如 category-0、category-1),用于 scroll-into-view 定位
  • 不要在 onPageScroll 里做 DOM 查询——它不触发于 scroll-view,只作用于页面级滚动(即未使用 scroll-view 时)

监听右侧 scroll-view 滚动并匹配左侧高亮项

右侧 scroll-view 的 bindscroll 事件每帧都可能触发,但你不需要每次都查位置。建议节流(例如 throttle 50ms),并在每次触发时用 uni.createSelectorQuery() 获取所有分类区块的 top 值,对比当前 scrollTop 找出「当前最顶部且未完全滚出视口」的区块。

注意:boundingClientRect().top 返回的是相对于页面顶部的距离,而 scroll-view 内部坐标系需减去其容器 offsetTop —— 更稳妥的做法是统一用 scroll-view 自身的 scrollTop 和各区块的 offsetTop(通过 selectComponent 或 querySelector 获取)做差值判断。

  • 给每个分类区块加 ref(如 :ref="'category'+index),在 bindscroll 回调中遍历 refs 获取 offsetTop
  • 高亮逻辑:找出满足 item.offsetTop scrollTop 的第一个项(+100 是容错偏移,避免临界点误判)
  • 找到后调用 this.$nextTick(() => { this.leftActiveIndex = index }),再让左侧 scroll-view 用 scroll-into-view 滚到对应 id
  • 别忘了在 data 中定义 leftActiveIndex 并绑定到左侧菜单 class 切换上

左侧点击跳转右侧时,右侧 scroll-view 必须能精准滚动到目标区块

左侧菜单点击后,不能只靠 scroll-into-view,因为右侧 scroll-view 可能还没渲染完(尤其用 v-for 动态生成时)。常见现象是第一次点击没反应,或滚动位置偏差。

uni-app
uni-app

uni-app 是基于 Vue 的跨端开发框架,适合开发 H5、App、小程序、鸿蒙和多端业务应用。

下载

根本原因是:点击瞬间,目标区块 DOM 还未挂载,scroll-into-view 查不到对应 id。解决方案是确保 DOM 就绪后再滚动。

  • 点击后先 setData({ rightTargetId: 'category-' + index }),在 watch 中监听 rightTargetId 变化
  • watch 回调里用 uni.createSelectorQuery().select('#' + this.rightTargetId).boundingClientRect() 查询位置
  • 查到后调用 this.$refs.rightScrollView.scrollIntoView(this.rightTargetId)(如果用 ref)或手动设置 scrollTop
  • 若查询失败(返回 null),加一个 setTimeout 重试(最多 2 次),避免死等
  • 右侧 scroll-view 的 scroll-top 属性要双向绑定(:scroll-top="rightScrollTop"),便于手动控制

真机调试时左右不同步?重点检查 scroll-view 的 height 和 overflow

H5 上表现正常,但微信小程序或 App 真机常出现「左侧不动」「右侧滚不动」「滚动卡顿」,90% 是样式问题:scroll-view 必须有明确高度,且父容器不能有 overflow: hidden 或 position: fixed 干扰。

另一个隐蔽坑:iOS 微信中,如果右侧 scroll-view 内部用了 flex: 1 或 height: 100%,会导致内部高度计算异常,boundingClientRect 返回的 top 偏差极大。

  • 右侧 scroll-view 的 style 必须写死高度,如 height: calc(100vh - 100px)(减去头部和菜单高度)
  • 禁止在 scroll-view 上设 overflow: hidden,它自己会处理溢出
  • 微信小程序中,若用 nvue 渲染,scroll-view 不支持 scroll-into-view,必须改用 scrollTo API + 手动计算位置
  • App 端开启 renderjs 可提升滚动性能,但会增加包体积,非必要不启用

联动越顺滑,越说明你绕开了 setData 频繁触发和 DOM 查询时机错位这两个最常被忽略的点。

热门AI工具

更多
PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2463

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

5343

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6370

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

5978

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

843

2024.05.22

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

0

2026.10.16

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

0

2026.10.15

MySQL 忘记密码怎么办
MySQL 忘记密码怎么办

MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

0

2026.10.15

Vue.js 中 ref 和 reactive 的区别
Vue.js 中 ref 和 reactive 的区别

Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

0

2026.10.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app从入门到实战教程
uni-app从入门到实战教程

共0课时 | 0人学习

uni-app x harmony开发指南
uni-app x harmony开发指南

共0课时 | 0人学习

uni-app鸿蒙运行和发行
uni-app鸿蒙运行和发行

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn