10分钟搭建企业级信息流：Layui工作流模块实战指南

2026-02-05 05:01:26作者：蔡丛锟

你还在为复杂的内容分页加载烦恼？还在手动实现图片懒加载浪费开发时间？本文将带你零基础掌握Layui工作流（flow）模块，通过10分钟实战，轻松构建高性能的信息流加载和图片懒加载功能，让你的网站体验提升300%。

读完本文你将获得：

掌握两种核心加载模式：信息流自动加载与图片懒加载
学会3个关键配置项优化加载性能
获取企业级应用的完整代码示例
理解工作流模块在实际项目中的最佳实践

模块概述：什么是Layui工作流

Layui工作流（flow）模块是用于信息流加载和图片懒加载的前端组件，通过监听滚动事件实现内容的按需加载，有效提升页面加载速度和用户体验。该模块已广泛应用于电商商品列表、社交媒体动态、新闻资讯等场景。

官方文档：docs/flow/index.md

核心功能解析

信息流加载：无限滚动的秘密

信息流加载是分页功能的进阶形式，当用户滚动到页面底部时自动加载新内容，避免传统分页的页面跳转。核心方法为flow.load(options)，通过配置参数实现灵活控制。

主要配置项说明：

参数名	类型	描述
elem	string	流加载容器选择器
done	function	加载回调函数，返回HTML片段和是否还有下一页
isLazyimg	boolean	是否开启图片懒加载
end	string	没有更多数据时显示的提示文本

基础实现代码：

<ul class="flow-container" id="news-list"></ul>

<script>
layui.use('flow', function(){
  var flow = layui.flow;
  
  flow.load({
    elem: '#news-list', // 容器
    isLazyimg: true,    // 开启图片懒加载
    done: function(page, next){ // 加载回调
      // 模拟AJAX请求
      setTimeout(function(){
        var data = [];
        for(var i = 0; i < 6; i++){
          data.push('<li><img lay-src="https://img.example.com/news/'+(page+i)+'.jpg"></li>');
        }
        // 第一个参数是新内容HTML，第二个参数是是否还有下一页
        next(data.join(''), page < 5); 
      }, 500);
    }
  });
});
</script>

示例文件：examples/flow.html

图片懒加载：性能优化利器

图片懒加载通过延迟加载可视区域外的图片，显著减少初始加载时间和带宽消耗。核心方法为flow.lazyimg(options)，特别适用于图片密集型页面。

使用示例：

<div class="image-container" id="product-images">
  <img lay-src="https://img.example.com/product/1.jpg" alt="商品图">
  <img lay-src="https://img.example.com/product/2.jpg" alt="商品图">
  <!-- 更多图片 -->
</div>

<script>
layui.use('flow', function(){
  var flow = layui.flow;
  
  flow.lazyimg({
    elem: '#product-images img', // 图片选择器
    scrollElem: '#product-images' // 滚动容器，默认document
  });
});
</script>

实战案例：构建企业级商品列表

下面我们通过一个完整案例，实现电商网站的商品列表页，包含无限滚动加载和图片懒加载功能。

页面结构设计

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <title>商品列表 - Layui工作流示例</title>
  <link rel="stylesheet" href="https://cdn.staticfile.org/layui/2.6.8/css/layui.css">
  <style>
    .product-list {padding: 15px; font-size: 0;}
    .product-item {display: inline-block; width: 24%; margin: 0.5%; background: #fff; border-radius: 4px; overflow: hidden; box-shadow: 0 1px 2px rgba(0,0,0,0.1);}
    .product-img {width: 100%; height: 200px;}
    .product-info {padding: 10px; font-size: 14px;}
  </style>
</head>
<body>
  <div class="layui-container">
    <h2>热销商品</h2>
    <div class="product-list" id="product-container"></div>
  </div>

  <script src="https://cdn.staticfile.org/layui/2.6.8/layui.js"></script>
  <script>
    layui.use('flow', function(){
      var flow = layui.flow;
      
      flow.load({
        elem: '#product-container',
        isLazyimg: true,
        end: '<p style="text-align:center; padding:20px;">到底了</p>',
        done: function(page, next){
          // 实际项目中这里会替换为真实API请求
          setTimeout(function(){
            var html = '';
            for(var i = 0; i < 8; i++){
              var id = (page-1)*8 + i + 1;
              html += `
                <div class="product-item">
                  <img lay-src="https://img.example.com/goods/${id}.jpg" class="product-img">
                  <div class="product-info">
                    <h3>商品名称 ${id}</h3>
                    <p class="layui-text-red">¥${(Math.random()*1000).toFixed(2)}</p>
                  </div>
                </div>
              `;
            }
            next(html, page < 5); // 加载5页后结束
          }, 800);
        }
      });
    });
  </script>
</body>
</html>

高级应用技巧

自定义滚动容器

当页面存在多个滚动区域时，可通过scrollElem参数指定滚动容器：

flow.load({
  elem: '#comment-list',
  scrollElem: '#comment-container', // 仅监听该容器的滚动事件
  done: function(page, next){
    // 加载评论数据
  }
});

预加载距离调整

通过修改模块内部的threshold参数（默认50px），控制提前加载的距离：

// 提前200px开始加载下一页
layui.flow.config.threshold = 200;

结合表格组件使用

与Layui表格组件结合，实现数据表格的无限滚动加载：

flow.load({
  elem: '#data-table',
  done: function(page, next){
    // 加载表格数据
    $.get('/api/data', {page: page}, function(res){
      // 渲染表格行
      next(res.data, res.hasMore);
    });
  }
});

常见问题解决方案

图片闪烁问题

使用占位图+淡入效果解决图片加载闪烁：

img[lay-src] {
  background: #f5f5f5;
  transition: opacity 0.3s;
}
img[lay-src].layui-loaded {
  opacity: 1;
}

重复加载问题

确保在done回调中正确处理加载状态，避免快速滚动导致的重复请求：

var loading = false;
flow.load({
  elem: '#list',
  done: function(page, next){
    if(loading) return;
    loading = true;
    // AJAX请求
    $.get('/api', {page: page}, function(res){
      loading = false;
      next(res.html, res.more);
    });
  }
});