微信小程序实现瀑布流布局:CSS与JS方案对比及代码详解

作者:交互手记

时间:2026-10-23

浏览:371

本文详解微信小程序中实现瀑布流布局的两种方案: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();
    });
   });
  })
 }
})

以上即为微信小程序实现瀑布流布局的完整内容,希望能为开发者提供有益参考。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章