uni-app实现瀑布流布局 uni-app多列布局排列实现方案

月夜之吻

月夜之吻

2026-05-05

486人浏览

原创

js动态分配图片到最短列需维护列高数组,插入前找最小值索引并更新高度;预估高度用宽高比+固定宽度,真实高度通过@load回调+boundingclientrect修正;分发逻辑应在computed/watch中完成二维数组构建。

uni-app实现瀑布流布局 uni-app多列布局排列实现方案

uni-app 没有原生瀑布流支持,纯 CSS 的 column-countdisplay: grid 在小程序端会被忽略或降级,必须用 JS 动态分发数据到列并维护高度 —— 这是跨端稳定的唯一路径。

怎么用 JS 动态分配图片到最短列

核心是维护一个列高数组(如 columnHeights = [0, 0]),每次插入新项前找出最小值索引,把该项 push 进对应列,并更新该列高度。注意:这个“高度”不能直接用 DOM 获取,得靠预估或异步加载后回调修正。

  • 图片未加载时,按宽高比 + 固定宽度(如 340rpx)预估高度:height = (340 * item.height) / item.width + 'rpx'
  • 真实高度需等 @load 触发后调用 uni.createSelectorQuery() 获取节点 boundingClientRect,再更新列高并触发重排
  • 别在 v-for 里直接写逻辑分发,应提前在 computedwatch 中完成二维数组构建(如 columns = [[], []]
  • 列数动态计算:用 uni.getSystemInfoSync().screenWidth 判断,> 750px 用 3 列,否则 2 列;单列场景直接退化为普通列表,避免无效计算

scroll-view 布局避坑要点

scroll-view 是瀑布流容器的常见选择,但小程序对它的限制极多,稍不注意就留白、错位、监听失效。

创意扇形排列卡片画廊
创意扇形排列卡片画廊

基于“创意扇形排列卡片画廊”制作的前端特效源码,包含扇形卡片、旋转展开、层级聚焦、键盘切换,打开 index.html 即可直接查看效果,可替换标题、颜色和图形元素复用。 下载包已经整理好特效舞台、样式变量、动画规则和必要脚本,适合用于学习当前效果的实现方式,也方便替换文字、颜色、图形或图片后直接复用。

下载
  • 绝对禁止给 scroll-viewheight: 100vh —— 小程序不识别 vh,必须用 height: calc(100vh - 100rpx)(减去导航栏/TabBar 高度)
  • 子元素禁用 position: absolute,iOS 微信中会导致 scrolltolower 监听丢失,改用 flex-direction: column + transform: translateY() 模拟定位更稳
  • 不要在 scroll-view 内嵌套带异步加载的自定义组件(如封装好的 WaterfallItem),父组件无法感知子项高度变化,容易底部留白
  • 安卓真机 setData 大量节点易卡顿,建议用 uni.createSelectorQuery 手动查高度做增量更新,而非全量重绘整个 columns

图片加载与占位如何不触发重排抖动

瀑布流最明显的卡顿来源是图片加载后高度突变,导致整列重排、滚动跳动。关键不是“等所有图加载完再渲染”,而是“边加载边占位+懒更新”。

  • 服务端最好返回每张图的宽高字段(width/height),前端按比例算出初始 height 并设为 image 的内联样式,避免空白塌陷
  • 若无服务端配合,用 uni.getImageInfo({ src }) 预加载(并发 ≤ 3),拿到尺寸后再插入对应列,比 onLoad 后再查 DOM 快得多
  • 加载完成后的高度修正必须节流:同一列多次更新只合并一次,避免高频 setData
  • 慎用 mode="aspectFit",它会强制缩放破坏宽高比,推荐 mode="widthFix" + 显式设 height

懒加载触底判断为什么经常失效

onReachBottom 在页面级可用,但在 scroll-view 内必须用 bindscrolltolower,且触发条件苛刻:滚动区域内容高度 − 可视高度 − scrollTop ≤ 1px 才算“触底”。实际中极易因高度计算不准而漏触发。

  • 不要依赖 scroll-view 自身的 scrolltolower,改用 IntersectionObserver 监听最后一项是否进入视口(小程序基础库 ≥ 2.27.0)
  • 若需兼容老版本,可在最后一项加一个 1px 高的 view 占位符,用 createSelectorQuery 轮询其 top 值是否 ≤ 可视区域高度
  • 请求下一页前先置 loading = true 并禁用再次触发,防止快速上拉重复请求
  • 后端需返回 hasMore: boolean 字段,而不是只靠页码判断,避免因数据删减导致空页仍无限加载

真正难的不是分两列还是三列,而是图片高度如何在加载前后保持布局稳定 —— 宽高信息缺失、小程序 DOM 查询延迟、scroll-view 高度计算误差,这三者叠加才是瀑布流卡顿和错位的根源。绕开它们,比写一百行分发逻辑更重要。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

排列 uni-app

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.08.11

1111

5

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

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

2023.10.09

2285

6

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

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

2024.03.19

2154

13

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

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

2024.03.22

2345

10

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

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

2024.05.22

336

5

Qt Creator新建项目使用教程
Qt Creator新建项目使用教程

本专题整理 Qt Creator 新建项目、打开已有工程、项目模板选择、目录结构、源文件管理、构建目录、运行配置和项目迁移方法,重点解决新手不知道选 qmake 还是 CMake、项目打不开、文件不参与编译等常见问题。

2026.08.05

0

10

maven常用插件使用大全
maven常用插件使用大全

PHP中文网精心整理Maven主流插件用法合集,涵盖编译、测试、打包等常用插件使用大全。从基础配置到进阶实战,详细解析各插件功能与适用场景,助你轻松掌握Maven自动化构建,解决Java项目开发痛点,是开发者必备的实用指南。

2026.08.05

0

31

PyCharm快速入门指南
PyCharm快速入门指南

本专题汇总了PyCharm快速入门的全套指南与教程,涵盖从官网下载安装、创建第一个Python项目、配置虚拟环境,到代码编辑、运行调试等基础操作,并整理了版本控制(Git)集成、常用高效快捷键及实用插件等进阶技巧,助你快速上手这款高效的Python IDE。

2026.08.05

2

17

PyCharm运行程序教程大全
PyCharm运行程序教程大全

本专题汇总了PyCharm运行程序的多种方式与详细操作步骤,涵盖通过主菜单Run、点击工具栏绿色三角图标、使用快捷键Shift+F10(或Ctrl+Shift+F10)等基本运行方法,以及配置运行/调试参数、设置PYTHONPATH环境变量、管理多脚本运行与交互式Python控制台调试等进阶技巧,助您全面掌握在PyCharm中高效运行与管理Python程序的方法。

2026.08.05

0

14

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习