Layui无内置card组件,需用原生全屏API实现卡片全屏:通过requestFullscreen/exitFullscreen控制DOM元素,并配合:fullscreen伪类优化样式与交互,确保响应式与兼容性。

Layui 本身没有内置的 card 组件,所谓“layui卡片”通常指用 layui-card 类名或自定义 HTML 结构(如 )模拟的卡片容器。要实现其全屏放大与退出切换,本质是控制该容器所在 DOM 元素进入/退出浏览器原生全屏(requestFullscreen),并配合样式与交互优化,而非靠 CSS 拉伸“伪全屏”。
核心:用原生全屏 API 控制卡片容器
不能只改 height: 100vh 或隐藏侧边栏——那只是视觉欺骗,F11 退出后布局错乱、打印异常、响应式失效。必须走标准 documentElement.requestFullscreen() 流程,并监听 fullscreenchange 做状态同步。
- 给卡片外层加唯一 ID,例如:...
- 获取目标元素:
const cardEl = document.getElementById('myCard'); - 进入全屏调用:
cardEl.requestFullscreen?.() || cardEl.webkitRequestFullScreen?.() || cardEl.mozRequestFullScreen?.() || cardEl.msRequestFullscreen?.(); - 退出全屏统一用:
document.exitFullscreen?.() || document.webkitExitFullscreen?.() || document.mozCancelFullScreen?.() || document.msExitFullscreen?.();
按钮集成到卡片右上角(推荐 toolbar 方式)
在卡片头部插入一个可点击图标按钮,绑定切换逻辑。建议使用 Layui 的 layui-icon 和事件委托:
- HTML 示例(放在卡片
.layui-card-header内): - JS 监听:
layui.$('#cardFullscreenBtn').on('click', function () { toggleCardFullscreen(); }); - 定义
toggleCardFullscreen()函数,内部判断document.fullscreenElement是否等于cardEl,再决定调用进入或退出
全屏时的样式与体验优化
原生全屏后,卡片会脱离常规文档流,需针对性调整:
- 全屏中隐藏非必要 UI:用 CSS 在
:fullscreen伪类里隐藏侧边栏、顶部导航、其他卡片等,例如:#myCard:fullscreen + .layui-layout-left { display: none; } - 确保卡片内容撑满:给
#myCard:fullscreen设置position: fixed; top: 0; left: 0; width: 100vw; height: 100vh; margin: 0; z-index: 9999; - 退出后恢复原布局:监听
fullscreenchange全局事件,在退出时移除临时样式、重置容器宽高(如有 JS 动态设置过) - 键盘快捷支持:可选添加
ESC键监听,退出时自动调用document.exitFullscreen()
兼容性与注意事项
老版本浏览器或移动端需降级处理,但现代项目建议聚焦 Chrome/Firefox/Edge/Safari 最新版:
- 移动端 Safari 不支持对任意元素调用
requestFullscreen,只能对或document.documentElement;此时应 fallback 到document.documentElement.requestFullscreen()并全屏整个页面,再用 CSS 隐藏其余区域 - 必须由用户手势触发(如 click),否则 Chrome 等会静默拒绝,不报错也不生效
- 避免在 iframe 内调用,跨域 iframe 受限;若必须,确保同源且
allow="fullscreen"属性已设置 - 不要依赖
layer.full()或table.fullscreen,它们不适用于普通卡片容器











