讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

SoundView
SoundView

字幕擦除翻译、配音口型同步

updream

一键生成高质量推广成片

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

老丽酱_9571

老丽酱_9571

发布时间:2026-11-21 09:09:12

|

247人浏览过

|

来源于php中文网

原创

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

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

相关专题

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

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

3143

2023.08.11

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

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

6903

2023.10.09

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

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

7690

2024.03.19

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

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

7678

2024.03.22

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

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

1083

2024.05.22

json数据格式
json数据格式

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

2415

2023.08.07

json是什么
json是什么

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

4022

2023.08.23

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

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

1316

2023.10.13

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

0

2026.11.20

热门下载

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

精品课程

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

共87课时 | 13.3万人学习

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

共89课时 | 11.6万人学习

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

共5课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn