Layui弹出层layer.tab如何实现点击切换时通过Ajax动态加载内容

云静小哥_4607

云静小哥_4607

2026-05-04

678人浏览

原创

layer.tab默认不刷新内容,需禁用原切换事件并绑定自定义click,通过Ajax按需加载;使用data-loaded防重复请求,配合loading提示与错误降级,推荐div替换而非iframe以避免跨域、高度适配等问题。

layer.tab 切换时内容不刷新?默认不支持 Ajax 动态加载

layer 的 layer.tab 是静态渲染模式:所有 tab 内容在弹出层初始化时就一次性写入 dom,切换只是 show/hide,根本不会触发任何加载逻辑。所以你点来点去,内容始终是初始 html,想“按需加载”必须自己接管切换行为。

核心思路是:禁用 layer 默认的 tab 切换绑定,改用自定义点击事件 + 手动调用 layer.getChildFrame 或直接操作 iframe / content 区域,再配合 Ajax 更新内容。

如何禁用 layer 默认 tab 切换并绑定自己的 click 事件

layer 创建 tab 后,会为每个 tab 标签(.layui-tab-title li)绑定内部切换逻辑。你需要在 success 回调里解绑原事件,并重绑自己的逻辑:

layer.tab({
  area: ['600px', '400px'],
  tab: [
    {title: '用户列表', content: '<div id="tab-user"></div>'},
    {title: '日志详情', content: '<div id="tab-log"></div>'}
  ],
  success: function(layero, index) {
    // 解绑 layer 自带的 tab 切换
    layero.find('.layui-tab-title li').off('click');
    
    // 绑定自定义 click:只对未加载过的 tab 发起 Ajax
    layero.find('.layui-tab-title li').on('click', function() {
      const $this = $(this);
      const tabIndex = $this.index();
      const $contentDiv = layero.find('.layui-tab-content .layui-tab-item').eq(tabIndex);
      
      // 检查是否已加载过(比如加 data-loaded 属性标记)
      if (!$contentDiv.data('loaded')) {
        loadTabContent(tabIndex, $contentDiv);
      }
      // 手动激活 tab(layer 内部状态不同步,需手动补)
      $this.addClass('layui-this').siblings().removeClass('layui-this');
      $contentDiv.addClass('layui-show').siblings().removeClass('layui-show');
    });
  }
});

loadTabContent 函数怎么写才不重复请求、支持 loading 状态

这个函数负责实际的 Ajax 加载和 DOM 插入,关键点在于防抖、loading 占位、错误降级:

  • 用 data-loading 防止快速连点多次触发请求
  • 首次加载前插入 loading 提示(比如 <div class="loading">加载中...</div>),成功后替换
  • 失败时保留空容器或显示错误提示,避免白屏
  • 把返回的 HTML 直接 $contentDiv.html(html) 即可,无需额外初始化 layui 组件(除非内容含 form/select 等,需手动 form.render())

示例片段:

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载
function loadTabContent(tabIndex, $target) {
  if ($target.data('loading')) return;
  
  $target.data('loading', true).html('<div style="padding:20px;text-align:center;">加载中...</div>');
  
  const urlMap = {
    0: '/api/users',
    1: '/api/logs'
  };
  
  $.get(urlMap[tabIndex], function(res) {
    $target.html(res.data || res).data('loaded', true);
    // 若新内容含 layui 表单元素,需手动渲染
    if (tabIndex === 0 && $target.find('select').length) {
      layui.form.render('select');
    }
  }).fail(function() {
    $target.html('<div style="padding:20px;color:#e25a5a;">加载失败,请重试</div>');
  }).always(function() {
    $target.removeData('loading');
  });
}

为什么不用 iframe 方式?iframe 在 layer.tab 里有坑

虽然 layer.tab 支持传入 content: '<iframe src="/page.html"></iframe>',但问题明显:

  • iframe 加载完成时机难监听,layer.getChildFrame 可能取不到 DOM
  • 父子页面跨域时完全无法通信,Ajax 请求受限
  • layer 默认对 iframe 的高度自适应失效,容易出现滚动条嵌套
  • 每次切换都重新加载 iframe,无法缓存内容,体验差

所以纯 Ajax + div 内容替换是更可控、更轻量的选择。唯一要注意的是:动态插入的 JS 代码(如 <script>xxx</script>)不会自动执行,如有必要,得用 eval 或创建 script 标签手动注入——但绝大多数场景不需要,Layui 组件都支持后续 render。

真正容易被忽略的是 tab 索引与数据源的映射一致性,以及 data-loaded 状态在 layer 关闭后不会自动清除——如果用户反复打开同一 layer,得在 cancel 或 end 回调里清理,否则下次打开可能误判“已加载”。

相关文章

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

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

下载

相关标签:

ajax layui

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

相关专题

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

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

2023.08.11

2463

5

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

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

2023.10.09

5323

6

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

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

2024.03.19

6370

13

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

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

2024.03.22

5958

10

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

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

2024.05.22

843

5

ajax教程
ajax教程

php中文网为大家带来ajax教程合集,Ajax是一种用于创建快速动态网页的技术。通过在后台与服务器进行少量数据交换,Ajax可以使网页实现异步更新。这意味着可以在不重新加载整个网页的情况下,对网页的某部分进行更新。php中文网还为大家带来ajax的相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.14

2800

4

ajax中文乱码解决方法
ajax中文乱码解决方法

ajax中文乱码解决方法有设置请求头部的字符编码、在服务器端设置响应头部的字符编码和使用encodeURIComponent对中文进行编码。本专题为大家提供ajax中文乱码相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.31

360

5

ajax传递中文乱码怎么办
ajax传递中文乱码怎么办

ajax传递中文乱码的解决办法:1、设置统一的编码方式;2、服务器端编码;3、客户端解码;4、设置HTTP响应头;5、使用JSON格式。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.11.15

2633

5

ajax网站有哪些
ajax网站有哪些

使用ajax的网站有谷歌、维基百科、脸书、纽约时报、亚马逊、stackoverflow、twitter、hacker news、shopify和basecamp等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.09.24

1161

6

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
jQuery官方API文档
jQuery官方API文档

共0课时 | 0人学习

Symfony教程(入门篇+基础篇)
Symfony教程(入门篇+基础篇)

共18课时 | 1.8万人学习