layui怎么利用ServiceWorker实现全站断网离线状态下仍然能展示历史数据

老丽酱_9571

老丽酱_9571

2026-11-21

247人浏览

原创

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

layui怎么利用serviceworker实现全站断网离线状态下仍然能展示历史数据

不能直接用 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),避免手写路径出错。

ServiceNow
ServiceNow

将AI智能体连接至ServiceNow,利用Table API和Stats API查询、创建、更新及管理任意表记录。支持完整的CRUD操作及聚合功能。

下载

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,导致表格不渲染——这和网络无关,是缓存不完整造成的假性“离线失败”。

相关文章

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

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

下载

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

相关专题

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

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

2023.08.11

3143

5

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

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

2023.10.09

6903

6

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

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

2024.03.19

7690

13

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

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

2024.03.22

7678

10

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

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

2024.05.22

1083

5

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2415

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

4022

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

1316

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

4679

7

热门下载

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

精品课程

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

共87课时 | 13.3万人学习

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

共89课时 | 11.6万人学习

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

共5课时 | 1.6万人学习