微信小程序实现瀑布流布局:CSS与JS方案对比及代码详解
本文详解微信小程序中实现瀑布流布局的两种方案:CSS多列排版与JS动态计算。重点推荐JS方法,通过判断左右列高度动态分配数据,避免CSS方案可能产生的空白区域。提供完整的WXML、WXSS及JS代码示例,并说明开启增强编译以使用await的准备工作。
前言
前言
在小程序开发中,处理数据列表或图片展示时,常遇到项目高度不一致的情况。通常我们需要固定宽度,让高度自适应,并实现无缝对接的效果。

瀑布流布局方案对比
实现瀑布流布局主要有两种技术手段。
第一种是利用CSS样式。
在父容器上设置 column-count: 2 可以实现双列排版。然而,这种左右分栏的方式存在缺陷:若左侧累计高度显著大于右侧,右侧区域会出现大片空白。
第二种是利用JavaScript逻辑(推荐方案)。
该方法通过动态获取节点元素的高度进行计算,判断左右两列的累计高度,将新数据添加到高度较小的一侧,从而实现更紧密的布局。
准备工作
准备工作
代码实现中使用了 await 关键字,因此需要在小程序本地配置中开启“增强编译”功能,具体设置请参考相关截图。

代码实现细节
实现代码
此方案采用左右双列布局,核心逻辑是实时比较两侧高度:若左侧高度小于右侧,则数据追加至左侧;反之则追加至右侧。注意,建议避免一次性请求过多数据,以免导致加载缓慢,可结合图片懒加载进行优化。
test.wxml 结构如下:
<!--pages/test/test.wxml-->
<view class="container">
<view id="left">
<view wx:for="{{leftList}}" wx:key>
<image src="{{item.url}}" mode='widthFix'></image>
<text>{{item.title}}</text>
</view>
</view>
<view id="right">
<view wx:for="{{rightList}}" wx:key>
<image src="{{item.url}}" mode='widthFix'></image>
<text>{{item.title}}</text>
</view>
</view>
</view>
test.wxss 样式定义如下:
/* pages/test/test.wxss */
#left, #right{
width: 48%;
margin: 0 1%;
float: left;
}
#left image, #right image{
width: 100%;
}
test.js 逻辑代码如下:
//test.js
let leftHeight = 0, rightHeight = 0; //分别定义左右两边的高度
let query;
Page({
data: {
list: [{
title: '1',
url: 'http://zq.jhcms.cn/attachs/photo/201711/20171130_176CFE51B6710715B1BBBEF2F86ACB0C.jpg',
}, {
title: '2',
url: 'http://img3.imgtn.bdimg.com/it/u=1417732605,3777474040&fm=26&gp=0.jpg',
},{
title: '3',
url: 'http://f10.baidu.com/it/u=121654667,1482133440&fm=72',
},{
title: '4',
url: 'http://img3.imgtn.bdimg.com/it/u=1417732605,3777474040&fm=26&gp=0.jpg',
},{
title: '5',
url: 'http://zq.jhcms.cn/attachs/photo/201711/20171130_9E39DA252E3946BE36218D85876C4AB4.jpg',
},{
title: '6',
url: 'http://img3.imgtn.bdimg.com/it/u=1417732605,3777474040&fm=26&gp=0.jpg',
},{
title: '7',
url: 'http://img3.imgtn.bdimg.com/it/u=1417732605,3777474040&fm=26&gp=0.jpg'
},{
title: '8',
url: 'http://img3.imgtn.bdimg.com/it/u=1417732605,3777474040&fm=26&gp=0.jpg',
},{
title: '9',
url: 'http://f10.baidu.com/it/u=121654667,1482133440&fm=72'
},{
title: '7',
url: 'http://img4.imgtn.bdimg.com/it/u=2748975304,2710656664&fm=26&gp=0.jpg'
},{
title: '8',
url: 'http://img2.imgtn.bdimg.com/it/u=1561660534,130168102&fm=26&gp=0.jpg'
},{
title: '9',
url: 'http://img3.imgtn.bdimg.com/it/u=1417732605,3777474040&fm=26&gp=0.jpg'
},{
title: '10',
url: 'http://zq.jhcms.cn/attachs/photo/201711/20171130_176CFE51B6710715B1BBBEF2F86ACB0C.jpg',
}],
leftList: [],
rightList: []
},
onLoad() {
this.isLeft();
},
async isLeft() {
const { list, leftList, rightList } = this.data;
query = wx.createSelectorQuery();
for (const item of list) {
leftHeight <= rightHeight ? leftList.push(item) : rightList.push(item); //判断两边高度,来觉得添加到那边
await this.getBoxHeight(leftList, rightList);
}
},
getBoxHeight(leftList, rightList) { //获取左右两边高度
return new Promise((resolve, reject) => {
this.setData({ leftList, rightList }, () => {
query.select('#left').boundingClientRect();
query.select('#right').boundingClientRect();
query.exec((res) => {
leftHeight = res[0].height; //获取左边列表的高度
rightHeight = res[1].height; //获取右边列表的高度
resolve();
});
});
})
}
})
以上即为微信小程序实现瀑布流布局的完整内容,希望能为开发者提供有益参考。
JS怎么实现页面强制刷新
2026-11-05 14:53:38
点击JS链接直接运行不下载?前端实现.js文件强制下载的三种方法
2026-11-05 12:12:23
怎么封装一个通用的JS创建元素辅助函数
2026-11-05 11:41:41
Swiper.js 怎么监听滑动结束并获取当前索引
2026-11-05 10:57:15
HTML、CSS和JS的关系:Web前端三件套怎么协作
2026-11-04 15:41:40
