Layui弹出层layer.load如何设置在遮罩层上显示自定义的文字说明

小伟大大_1554

小伟大大_1554

2026-05-02

678人浏览

原创

layer.load 的 content 参数需配合 success 回调调整文字位置,推荐用 padding-top 下移文字避开图标重叠;浅色遮罩下须同时修改文字颜色和图标 filter 以确保可见性;shade 必须为数组格式(如 [0.2, '#000'])才生效。

layer.load 的 content 参数能直接显示文字,但默认会和 loading 图标重叠

直接传 content: '正在提交' 是最简方式,但 layui 默认把文字塞进同一个 .layui-layer-content 容器里,而 loading 图标(.layui-layer-loading1)也在这里渲染,结果就是文字压在图标上、看不清、排版乱。

真正起效的做法是:用 success 回调拿到 DOM,手动调整文字位置和样式。关键不是“加文字”,而是“把文字从图标底下揪出来”。

  • content 仍要传,它是触发文字渲染的前提
  • 必须用 success 钩子,不能靠 CSS 全局覆盖 —— 因为 layer 每次新建 load 层都会动态生成 class 名,且图标和文字共用一个父容器
  • 常见错法:layer.load(2, { content: '加载中' }) 单独写,不配 success,结果文字糊在旋转图标正中间

用 success 调整文字位置时,padding-top 是最稳的方案

图标的 SVG 是绝对定位或 inline-block,文字是行内元素,默认垂直对齐基线。强行用 margin 或 transform 容易在不同 icon 类型(1/2/3)下失效,而 padding-top 直接撑开容器内部空间,让文字自然下移,兼容性最好。

示例:

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

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

下载
layer.load(2, {
  shade: [0.2, '#000'],
  content: '请稍候...',
  success: function(layero) {
    layero.find('.layui-layer-content').css({
      'padding-top': '50px',
      'width': '180px',
      'color': '#fff',
      'text-align': 'center'
    });
  }
});
  • padding-top 值需根据 icon 类型微调:icon=1(小圆圈)一般 40–45px;icon=2(大圆圈)建议 50–60px;icon=3(齿轮)可能要 70px+
  • 务必设 width,否则文字过长会换行,破坏居中效果
  • 浅色遮罩(如 [0.1, '#fff'])下,记得同步改 color,否则白底白字看不见

想让文字出现在图标下方(而非包裹图标),得用 after() 插入新 DOM

上面的 padding-top 方案本质是“图标不动、文字下移”,如果 UI 要求图标居中、文字严格在正下方(比如带间距的卡片式 loading),就得绕过原有结构,手动追加一个独立 <div>。 <p>示例:</p> <pre class="brush:php;toolbar:false;">layer.load(2, { shade: [0.3, '#000'], success: function(layero) { layero.find('.layui-layer-content').after( '&lt;div class=&quot;layer-load-text&quot; style=&quot;color:#fff;text-align:center;margin-top:12px;font-size:14px;&quot;&gt;数据处理中...&lt;/div&gt;' ); } });</pre> <ul> <li>不用依赖 <code>content 参数,文字完全由 JS 注入,彻底脱离原生布局逻辑

  • 注意加 margin-top 控制图标与文字间距,避免紧贴
  • 如果项目用了 scoped CSS 或 Shadow DOM,这个插入的 div 需额外加样式,不能指望全局 class 生效
  • shade 设成白色或浅色时,.layui-layer-loading1 图标会变淡甚至消失

    这是 Layui 的设计缺陷,不是你代码写错。深色 loading 图标(SVG fill="#333")在 shade: [0.1, '#fff'] 这种浅背景上,对比度极低,肉眼几乎不可见。

    必须在 success 里手动重置图标样式:

    success: function(layero) {
      // 调整文字
      layero.find('.layui-layer-content').css({ 'padding-top': '50px', 'color': '#333' });
      // 同时翻转图标颜色
      layero.find('.layui-layer-loading1').css({
        'filter': 'invert(1) brightness(1.5)',
        'width': '40px',
        'height': '40px'
      });
    }
    • filter: invert(1) 是最轻量的翻色方案,对 SVG 和 PNG 都有效;brightness 补偿反色后可能偏暗的问题
    • 别只调文字不调图标 —— 白底黑字 + 白底隐形图标,用户只会看到一行字,不知道有 loading 动画
    • 某些旧版 Chrome 对 SVG filter 支持不稳定,可备选方案:用 background-image 替换整个 loading 区域,但工作量翻倍
    实际项目里最容易被忽略的点:layer.load() 的 shade 必须是数组格式,写成 shade: 0.2 或 shade: true 就完全不生效,遮罩永远是默认黑灰。这个坑没有报错,只能靠调试器看 computed style 确认是否真的 applied。

    相关专题

    更多
    OpenJDK JVM参数怎么调优
    OpenJDK JVM参数怎么调优

    Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

    2026.10.16

    0

    10

    OpenJDK怎么配置Java开发环境
    OpenJDK怎么配置Java开发环境

    怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

    2026.10.16

    0

    10

    OpenJDK怎么部署Java应用
    OpenJDK怎么部署Java应用

    Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

    2026.10.16

    0

    10

    Revel框架模板渲染与表单验证
    Revel框架模板渲染与表单验证

    本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

    2026.10.16

    0

    15

    Revel框架MVC路由与控制器
    Revel框架MVC路由与控制器

    本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

    2026.10.16

    0

    15

    Revel框架入门与安装配置
    Revel框架入门与安装配置

    本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

    2026.10.16

    0

    15

    Linux 新手先学哪些命令
    Linux 新手先学哪些命令

    Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

    2026.10.15

    0

    20

    MySQL 忘记密码怎么办
    MySQL 忘记密码怎么办

    MySQL忘记密码专题汇集不同版本与系统下的root密码重置方法,覆盖MySQL 5.7、8.0、Mac、Linux及本地集成环境,并提示恢复权限与重新登录的检查步骤。

    2026.10.15

    0

    18

    Vue.js 中 ref 和 reactive 的区别
    Vue.js 中 ref 和 reactive 的区别

    Vue.js中ref和reactive的区别专题汇集两种响应式API的定义、访问方式、对象解构、侦听与性能取舍等文章,帮助结合实际状态类型选择合适写法。

    2026.10.15

    0

    20

    热门下载

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

    精品课程

    更多
    相关推荐
    /
    热门推荐
    /
    最新课程
    ThinkPHP配置开发与CMS后台实战
    ThinkPHP配置开发与CMS后台实战

    共87课时 | 12.9万人学习

    第二十三期_综合实战
    第二十三期_综合实战

    共89课时 | 11.1万人学习

    Layui 快速入门精讲
    Layui 快速入门精讲

    共5课时 | 1.6万人学习