Layui 默认不支持离线因无PWA能力、不生成预缓存清单且不自动注册Service Worker;实现离线需预缓存HTML/CSS/JS/数据文件,并在SW中按请求类型(navigate/json)分别响应,历史数据须提前存入IndexedDB或预缓存JSON。

不能直接用 Layui 实现断网离线展示历史数据——Layui 本身不提供 Service Worker 支持,必须手动集成,且“历史数据”能否离线取决于你如何存储和加载它。
为什么 Layui 项目默认不支持离线?
Layui 是一个轻量前端 UI 框架,不内置 PWA 能力,也不生成预缓存清单(__WB_MANIFEST),更不会自动注册 service-worker.js。它的资源(layui.css、layui.js、图标、模块 JS)全靠传统 HTTP 加载,断网时 fetch 失败即白屏或报错。
所谓“历史数据”,如果是从 /api/history 这类接口拉取的 JSON,那它默认根本不会被缓存;如果是存在 localStorage 或 IndexedDB 里的,那 Service Worker 本身不读这些——它只管网络请求的拦截与响应。
- Service Worker 不会自动读取
localStorage内容并返回给页面 - 它也不能直接渲染 Layui 表格(
table.render())——渲染逻辑仍在页面 JS 中执行 - 若页面 JS(如
index.js)本身没被预缓存,断网后连layui都加载不了,更别说执行渲染
必须预缓存哪些文件才能让 Layui 页面离线跑起来?
不是“加个 SW 就行”,而是要确保整个依赖链在 install 阶段全部进 Cache API:
-
index.html(入口页,必须带完整内联脚本或确保 JS/CSS 可离线加载) -
layui/css/layui.css和对应字体文件(如iconfont.woff2) -
layui/layui.js(注意:Layui 的模块化加载依赖layui.define,所以所有用到的模块 JS 也得进缓存,比如layui/table.js、layui/form.js) - 你自己的业务 JS(如
js/app.js),里面调用了table.render()并读取本地数据 - 如果历史数据是静态 JSON 文件(如
data/history.json),也要列入预缓存列表
推荐用 Workbox 的 InjectManifest 模式,在构建后自动生成包含哈希的资源列表:precacheAndRoute(self.__WB_MANIFEST),避免手写路径出错。
fetch 事件里怎么处理历史数据请求?
关键不是“缓存接口”,而是**区分请求类型**。Layui 页面发起的 /api/history 请求是 request.destination === 'json',而用户刷新 /history.html 是 request.mode === 'navigate':
- 对
mode === 'navigate':必须 fallback 到已缓存的/history.html(不能 fallback 到/index.html,否则路由错乱) - 对
destination === 'json':可走StaleWhileRevalidate策略——立即返回旧缓存,后台拉新;或干脆在 install 阶段就把data/history.json预缓存,fetch 里直接caches.match(request) - 不要在 fetch 里 try/catch
fetch()后手动读localStorage——SW 线程无法访问localStorage,会报undefined is not an object
示例片段(放在 sw.js 中):
self.addEventListener('fetch', event => {
const { request } = event;
if (request.mode === 'navigate') {
event.respondWith(
caches.match('/history.html').then(r => r || caches.match('/offline.html'))
);
} else if (request.url.includes('/api/history')) {
event.respondWith(
caches.match(request).then(r => r || fetch(request))
);
}
});
历史数据真正离线可用的两个前提
很多开发者卡在这一步:SW 装好了、页面能打开,但表格空着——因为“历史数据”压根没准备好。
- 如果你的数据来自接口,必须在用户在线时主动存一份到
IndexedDB(localStorage容量小、无事务、不适合批量历史记录),并在页面 JS 中判断navigator.onLine后决定读 DB 还是发请求 - 如果你把历史数据硬编码在
history.json里,那它必须出现在构建产物中,并被 Workbox 自动注入到__WB_MANIFEST——否则 SW 根本不知道该缓存它
最易忽略的一点:table.render() 初始化时若依赖未加载的模块(比如漏缓存了 layui/laydate.js),即使 HTML 和 JS 文件都缓存了,控制台仍会报 laydate is not defined,导致表格不渲染——这和网络无关,是缓存不完整造成的假性“离线失败”。











