juggle - 组件式 JS 框架


MIT
跨平台
JavaScript

软件简介

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即可)

>>>>>>事件Demo

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

>>>>>>时间轴总控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即可)

>>>>>>Tween的Demo

4、Tween的Demo线上演示地址:

>>>>>>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即可)

>>>>>>延迟回调Demo

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即可)

>>>>>>MV框架Demo