Swap.js:轻量级的页面动态更新库
2024-05-31 23:23:40作者:殷蕙予
Swap.js 是一个只有不到100行代码的JavaScript微库,它提供了类似AJAX的网页导航功能,使页面部分内容动态替换变得简单易行。这个项目受到了最近流行的服务器端渲染和“HTML过线”技术的启发。
项目介绍
通过Swap.js,你可以直接从服务器获取HTML片段,轻松替换网页中的元素,无需复杂的前端框架。一个简单的例子就是点击链接,将#container元素的内容替换为newpage.html中对应的#container内容。这种简洁的交互方式使得网页更新更加流畅,用户体验更佳。
项目演示:Demo
项目技术分析
- AJAX式导航:使用
<a>标签与swap-target属性结合,实现部分页面内容的异步加载。 - 浏览器历史管理:支持回退操作,保持浏览历史的连贯性。
- DOM监听器:自动检测DOM的变化,当元素创建或移除时触发相应的处理函数。
- 单页应用友好:无论是单页应用还是传统多页应用,都能完美兼容。
项目及技术应用场景
- 快速构建SPA(单页应用):在不引入大型框架的情况下,可以快速实现页面间的动态切换。
- 增强现有网站:在已有的网站基础上添加局部动态更新功能,提供更好的用户体验。
- 实验性项目:对于短期项目或学习实践,Swap.js的简洁代码便于理解和维护。
项目特点
- 纯JavaScript:无需任何外部工具,如打包器、webpack或TypeScript编译器,简化开发流程。
- 渐进增强:即使用户禁用了JavaScript,传统的
<a>标签仍能正常工作。 - 后端兼容:可与现有的服务器端渲染方案(如PHP、Python等)无缝集成。
- 小巧高效:代码量少,运行速度快,资源占用低。
示例代码
查看demo1/文件夹以了解一个基础示例,以及demo3-email/文件夹的更复杂应用,包括一个几乎完全使用HTML属性驱动的邮件应用实例。
简单示例
<body>
<a href="index.html" swap-target="#container" swap-history="true">Home</a>
<a href="screen2.html" swap-target="#container" swap-history="true">Go to screen 2</a>
<div id="container">Container</div>
<script src="../swap.js"></script>
</body>
高级示例
详细文档介绍了如何利用swap-target、swap-history等特性,以及如何定义元素加载和卸载时的JS回调函数。
关于代码量限制
Swap.js的代码量被刻意控制在100行左右,目的是:
- 易于维护:项目越小,阅读和修改代码所需的时间就越少。
- 灵活性:想要添加新功能,只需要改动几行代码即可。
- 针对性:只保留核心功能,避免过度复杂化。
欢迎贡献您的想法,一起让Swap.js变得更好!
作者与许可
本项目由Joseph Ernest编写,如果你有R&D、Python、数据科学或自动化相关的咨询需求,请访问afewthingz.com联系他。
Swap.js采用MIT许可证,自由使用,尽情分享。
登录后查看全文
热门项目推荐
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0152- DDeepSeek-V4-ProDeepSeek-V4-Pro(总参数 1.6 万亿,激活 49B)面向复杂推理和高级编程任务,在代码竞赛、数学推理、Agent 工作流等场景表现优异,性能接近国际前沿闭源模型。Python00
LongCat-Video-Avatar-1.5最新开源LongCat-Video-Avatar 1.5 版本,这是一款经过升级的开源框架,专注于音频驱动人物视频生成的极致实证优化与生产级就绪能力。该版本在 LongCat-Video 基础模型之上构建,可生成高度稳定的商用级虚拟人视频,支持音频-文本转视频(AT2V)、音频-文本-图像转视频(ATI2V)以及视频续播等原生任务,并能无缝兼容单流与多流音频输入。00
auto-devAutoDev 是一个 AI 驱动的辅助编程插件。AutoDev 支持一键生成测试、代码、提交信息等,还能够与您的需求管理系统(例如Jira、Trello、Github Issue 等)直接对接。 在IDE 中,您只需简单点击,AutoDev 会根据您的需求自动为您生成代码。Kotlin03
Intern-S2-PreviewIntern-S2-Preview,这是一款高效的350亿参数科学多模态基础模型。除了常规的参数与数据规模扩展外,Intern-S2-Preview探索了任务扩展:通过提升科学任务的难度、多样性与覆盖范围,进一步释放模型能力。Python00
skillhubopenJiuwen 生态的 Skill 托管与分发开源方案,支持自建与可选 ClawHub 兼容。Python0112
项目优选
收起
暂无描述
Dockerfile
733
4.75 K
Ascend Extension for PyTorch
Python
617
795
本项目是CANN提供的数学类基础计算算子库,实现网络在NPU上加速计算。
C++
1.01 K
1.01 K
openEuler内核是openEuler操作系统的核心,既是系统性能与稳定性的基石,也是连接处理器、设备与服务的桥梁。
C
433
395
华为昇腾面向大规模分布式训练的多模态大模型套件,支撑多模态生成、多模态理解。
Python
145
237
Claude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed.
Get Started
Rust
1.18 K
152
暂无简介
Dart
983
252
Oohos_react_native
React Native鸿蒙化仓库
C++
348
403
昇腾LLM分布式训练框架
Python
166
198
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
1.68 K
989