要让页面真正全屏,需重置html/body样式清除默认边距、设置height:100%和overflow:hidden;清除Layui容器留白;处理滚动条宽度干扰;清理残留遮罩层。

要让整个页面“真正全屏”,关键不是靠 Layui 某个模块配置,而是从 HTML 和 CSS 根层入手——Layui 本身不接管 body 或 html 的默认样式,所以必须手动清除浏览器默认的外边距、内边距和滚动条干扰。
重置 html 和 body 的默认样式
所有现代浏览器都会给 和 添加默认 margin、padding,甚至可能有默认字体、行高、背景色。全屏布局第一步就是清空这些:
- 在
中或全局样式表顶部添加以下 CSS:
-
height: 100%确保 body 能撑满视口,为后续子元素(如 Layui 容器)提供高度基准 -
overflow: hidden防止意外滚动条出现;若需内部滚动,请改用局部容器控制(如.layui-body)
移除 Layui 默认容器的留白
Layui 常见布局结构(如 layui-layout)中,.layui-header、.layui-footer、.layui-side 默认带 padding/margin,且 .layui-body 有内边距。要扁平化,需针对性覆盖:
- 清除主内容区内外边距:
.layui-body { padding: 0 !important; margin: 0 !important; } - 隐藏头部/侧边栏(如不需要):
.layui-header, .layui-side, .layui-footer { display: none; } - 确保内容区域占满剩余空间:
.layui-body { height: 100vh !important; }
处理滚动条宽度导致的错位
Windows 或某些浏览器下,右侧滚动条会占用约 17px 宽度,导致“100%”宽度内容被挤出、出现横向滚动。解决方法有两个:
- 统一禁用 body 滚动:
body { overflow-y: hidden; }(适合纯单页全屏场景) - 或更稳妥地补偿滚动条宽度:
body { width: calc(100vw - 17px); }(仅当必须保留局部滚动时使用)
避免 iframe 或弹窗残留遮罩干扰
如果页面中用过 layer.open 或 layer.load,它们会插入遮罩层(.layui-layer-shade),即使关闭也可能未完全移除 DOM。全屏前建议主动清理:
- 在进入全屏逻辑开始时执行:
$('.layui-layer-shade, .layui-layer').remove(); - 若使用了自定义 loading 遮罩(如页面加载时的
#loading-mask),务必确认它已被移除,否则会盖住全屏内容











