首页
/ Swap.js:轻量级的页面动态更新库

Swap.js:轻量级的页面动态更新库

2024-05-31 23:23:40作者:殷蕙予
Swap
Swap.js is a "HTML-over-the-wire" AJAX-navigation micro-library

Swap.js Logo

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-targetswap-history等特性,以及如何定义元素加载和卸载时的JS回调函数。

关于代码量限制

Swap.js的代码量被刻意控制在100行左右,目的是:

  • 易于维护:项目越小,阅读和修改代码所需的时间就越少。
  • 灵活性:想要添加新功能,只需要改动几行代码即可。
  • 针对性:只保留核心功能,避免过度复杂化。

欢迎贡献您的想法,一起让Swap.js变得更好!

作者与许可

本项目由Joseph Ernest编写,如果你有R&D、Python、数据科学或自动化相关的咨询需求,请访问afewthingz.com联系他。

Swap.js采用MIT许可证,自由使用,尽情分享。

Swap
Swap.js is a "HTML-over-the-wire" AJAX-navigation micro-library
热门项目推荐
相关项目推荐

项目优选

收起
CangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
672
0
RuoYi-Vue
🎉 基于SpringBoot,Spring Security,JWT,Vue & Element 的前后端分离权限管理系统,同时提供了 Vue3 的版本
Java
136
18
openHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
12
8
redis-sdk
仓颉语言实现的Redis客户端SDK。已适配仓颉0.53.4 Beta版本。接口设计兼容jedis接口语义,支持RESP2和RESP3协议,支持发布订阅模式,支持哨兵模式和集群模式。
Cangjie
322
26
advanced-java
Advanced-Java是一个Java进阶教程,适合用于学习Java高级特性和编程技巧。特点:内容深入、实例丰富、适合进阶学习。
JavaScript
75.83 K
19.04 K
qwerty-learner
为键盘工作者设计的单词记忆与英语肌肉记忆锻炼软件 / Words learning and English muscle memory training software designed for keyboard workers
TSX
15.56 K
1.44 K
Jpom
🚀简而轻的低侵入式在线构建、自动部署、日常运维、项目监控软件
Java
1.41 K
292
Yi-Coder
Yi Coder 编程模型,小而强大的编程助手
HTML
30
5
easy-es
Elasticsearch 国内Top1 elasticsearch搜索引擎框架es ORM框架,索引全自动智能托管,如丝般顺滑,与Mybatis-plus一致的API,屏蔽语言差异,开发者只需要会MySQL语法即可完成对Es的相关操作,零额外学习成本.底层采用RestHighLevelClient,兼具低码,易用,易拓展等特性,支持es独有的高亮,权重,分词,Geo,嵌套,父子类型等功能...
Java
1.42 K
231
taro
开放式跨端跨框架解决方案,支持使用 React/Vue/Nerv 等框架来开发微信/京东/百度/支付宝/字节跳动/ QQ 小程序/H5/React Native 等应用。 https://taro.zone/
TypeScript
35.34 K
4.77 K