juggle是一个极简的、组件式的js框架。无依赖,完美闭包,灵活且适合渐进学习,可与任何框架整合。包含(支持冒泡的事件、Tween、MV框架、http、websocket、资源、模块)等组件,按需选择组件,不绑架开发者。
juggle架构图及其依赖关系(深颜色的是核心组件强烈推荐)
allinone下载
npm install juggle-all
核心组件介绍
1、juggle-event(支持冒泡的事件)
介绍:支持冒泡的事件,可用于解除包含结构,树形结构的耦合性。支持监听事件、移除事件、派发事件、阻止冒泡、立即阻止。使用对象池减少垃圾回收。
优秀且需要注意的特性:
1、支持冒泡,前提是冒泡对象有parent属性并且不为空,有isDisplayObject属性并且为true。 2、在派发事件的回调函数内将parent设置为null,不能阻止这一次parent接到这次事件 3、在派发事件某层级的回调函数内,移除这层级的监听或添加这层级的监听,是不会影响这次派发事件目标的改变。 4、但是如果在某层级的回调函数内,移除上层的监听或添加上层的监听,上层本轮会受到影响。
下载:
npm install juggle-event
使用场景:开发UI组件库,封装任意组件时都可以使用。例如:juggle-http,juggle-websocket都是基于此事件,可以派发专有的自定义事件。
示例代码:
1、继承事件类
function DisplayObj() {
juggle.EventDispatcher.apply(this);
}
2、监听事件
obj.addEventListener("aaa", function(event){}, this);
3、派发事件,派发类型为aaa,冒泡,携带数据bbb
obj.dispatchEventWith("aaa", true, "bbb");
4、事件Demo(双击test.html即可)
2、juggle-juggler(时间轴总控)
介绍:时间轴总控,支持添加动画,移除动画,每帧进行动画回调并携带与上一次调用的间隔毫秒数
优秀且需要注意的特性:
1、回调中新加入的动画不能在这一次被调度,因为没有经历时间过程这是合理的 2、回调中移除的分两种可能,已经在本次调度的无影响,没有在本次调度的取消本次调度
下载:
npm install juggle-juggler
使用场景:动画,每帧进行调用的业务逻辑,都可以使用。
示例代码:
1、必须实现规定的advanceTime方法
function View() {
this.advanceTime = function (time) {
}
}
2、加入时间轴总控,每帧会调用advanceTime,并携带与上一次调用的间隔毫秒数
juggle.jugglerManager.juggler.add(new View());
3、时间轴总控Demo
3、juggle-tween(缓动类)
介绍:缓动类,支持17种过渡模式,每帧无误差精准定位,完美的平滑过渡。支持对象池减少垃圾回收。
优秀且需要注意的特性:
1、每次调用都是开始值+(终点-起点)*(经过时间/总时间),这是最稳定的,没有任何误差 2、连续调度,每次完成时过剩的时间再次利用不浪费。
下载:
npm install juggle-tween
使用场景:需要动画过渡的都可以使用。
示例代码:
1、创建一个显示对象
function DisplayObject(obj) {
this.obj = obj;
this.xValue = 0;
this.yValue = 0;
this.getX = function () {
return this.xValue;
};
this.setX = function (value) {
this.xValue = value;
this.draw();
};
this.getY = function () {
return this.yValue;
};
this.setY = function (value) {
this.yValue = value;
this.draw();
};
this.draw = function () {
this.obj.style.position = "absolute";
this.obj.style.top = this.yValue + "px";
this.obj.style.left = this.xValue + "px";
}
}
2、使用juggle-tween进行动画过渡
var display = new DisplayObject(document.getElementById("tween_div"));
display.setX(100);
display.setY(100);
tween = juggle.tweenPool.fromPool(display, 2);
tween.animate(display.getX, display.setX, 800);
tween.animate(display.getY, display.setY, 400);
juggle.jugglerManager.juggler.add(tween);
3、Tween的Demo(双击test.html即可)
4、Tween的Demo线上演示地址:
4、juggle-delayedcall(延迟回调)
介绍:一个绝对精准的延迟回调工具,支持设置回调间隔,回调次数(支持无限次数)。解决setInterval多次调用不精准的问题。使用对象池减少垃圾回收。
优秀且需要注意的特性:
1、连续调度,每次完成时过剩的时间再次利用不浪费。调度时间间隔例如:1001毫秒,999毫秒这种模式。
下载:
npm install juggle-delayedcall
使用场景:所有需要延迟回调的业务,替代setInterval。
示例代码:
1、延迟回调例子,参数1延迟回调函数,每1秒回调一次,携带1111参数,重复5次后停止回调。
var delayedCall = juggle.delayedCallPool.fromPool(function(arg){}, 1, "1111");
delayedCall.mRepeatCount = 5;
juggle.jugglerManager.juggler.add(delayedCall);
2、延迟回调Demo(双击test.html即可)
5、juggle-mv(MV框架)
介绍:一个MV框架解除数据源与视图控制器的耦合性,视图控制器之间的耦合性,严密的闭包封装,用户只需继承Proxy与Mediator即可开发MV模式的项目。
下载:
npm install juggle-mv
使用场景:需要与服务器进行交互的web项目。
示例代码:
1、继承Proxy作为数据代理,可以请求数据结果后广播消息。
function UserProxy() {
//继承
juggle.Proxy.apply(this);
//获取数据然后广播
this.getData = function () {
this.notifyObservers(this.getNotification("test", "getData success"));
};
}
2、继承Mediator作为视图控制器,控制视图、调用数据源Proxy、关注数据源Proxy与视图控制器Mediator广播过来的消息并处理。
function IndexMediator() {
//关注消息
this.listNotificationInterests = ["test"];
//关注消息的处理
this.handleNotification = function (data) {
switch (data.name) {
case "test":
alert("IndexMediator接到数据" + data.body);
break;
}
};
//继承
juggle.Mediator.apply(this);
}
3、MV框架Demo(双击test.html即可)
其他组件介绍
1、juggle-websocket(简易封装,支持自定义事件派发的websocket客户端库)
下载:
npm install juggle-websocket
使用场景:需要与服务器建立长连接,依赖服务器推送消息的web项目。
示例代码:
1、websocket客户端与服务器示例
2、juggle-http(简易封装,通用性很好的http客户端库)
下载:
npm install juggle-http
使用场景:需要向服务器发送http请求的web项目。
示例代码:
1、http客户端与服务器示例
3、juggle-resource(支持加载多资源回调的资源库)
下载:
npm install juggle-resource
使用场景:配合juggle-module使用。
示例代码:
1、加载资源Demo
4、juggle-module(模块库,前端模块化架构)
下载:
npm install juggle-module
示例代码:
1、模块Demo