介绍
Elf.js 是一个简洁的高效的
JavaScript框架。它不仅高度重视用户的体验，也高度重视开发者的体验。在实现当今主流技术的同时，以尽可能原生态的形式展现出来。在如今花样繁多的框架中，你是否感觉各种思想、语法、工具大大增加了你的学习时间，那么Elf.js是一个不错的开始。她将最初的 Web 设计理念与现代技术完美结合，她追求的是简单、明朗、返璞归真。
安装
- NPM
npm install elfjs --save
- 文件
- 在
NPM包的目录你将找到.js(完整版)、.min.js(迷你版)以及.d.ts(类型声明)文件。 elf-loader.js提供简单的AMD/CommonJS规范的加载器，她可以让你在开发中免去编译的等待。shims目录下的提供在IE9上运行的补丁与集成第三方库的补丁。她们并不是时常用到。- 使用支持 DefinitelyTyped 的 IDE 可以有效的进行代码提示与类型检查。
- 在
开始
Elf.js并未创建过多的私有思想和语法。若你已经具有 Web 中级知识，那么一切将非常得心应手。
第一个组件
Elf.js采用简洁的模板语法来声明 DOM 与数据。
<!-- viewComponent.html -->
<div>
{{ message }}
</div>
// viewComponent.js
var temp = require("viewComponent.html");
module.exports = Elf.Component("view", {
constructor : function () {
this.message = "Hello Word!";
},
render : Elf.redactElement(temp)
});
// bootstrap.js
var View = require("viewComponent");
Elf.render(Elf.createElement(View), document.body, true);
- 上面的代码展示了如何从模板中创建组件和如何将组件渲染到指定节点。
- 更多模板语法参见 模板语法
使用指令
Elf.js提供可增强HTML特性的功能。下面将展示一个简单的拖动功能。
// dragDirective.js
module.exports = Elf.Directive("drag", {
onInitial : function (element, props) {
Elf.attachEvent(element, "mousedown", this);
Elf.attachEvent(element, "mousemove", this);
Elf.attachEvent(element, "mouseup", this);
},
onDispose : function (element, props) {
Elf.detachEvent(element, "mousedown", this);
Elf.detachEvent(element, "mousemove", this);
Elf.detachEvent(element, "mouseup", this);
},
handleEvent : function (event) {
// coding drag
}
});
<!-- viewComponent.html -->
<div cmd="drag">
{{ message }}
</div>
// viewComponent.js
var temp = require("viewComponent.html");
var dragDirective = require("dragDirective");
module.exports = Elf.Component("view", {
constructor : function () {
this.message = "Hello Word!";
},
render : Elf.redactElement(temp, dragDirective)
});
- 通过
Elf.Directive方法，我们定义并实现了一个拖动指令。通过Elf.redactElement函数注入依赖的指令（已经通过Elf.depend方法注册为全局依赖则不必在这里注入了），就可以在模板中通过指令别名使用了。此时的div已经具备拖动能力。 - 指令能有效的将功能操作与业务逻辑分离，并高度重用代码。
使用管道
- 在渲染过程中，往往数据需要转换成某种特定格式，我们可以通过
Transform来实现。例如下面代码将日期格式化输出。
// dateTransform.js
module.exports = Elf.Transform("date", {
transform : function (value, formatExpr) {
return moment(value).format(formatExpr);
}
});
<!-- viewComponent.html -->
<div cmd="drag">
{{ now | date "YYYY-MM-DD" }}
</div>
// viewComponent.js
var temp = require("viewComponent.html");
var dateTransform = require("dateTransform");
module.exports = Elf.Component("view", {
constructor : function () {
this.now = new Date();
},
render : Elf.redactElement(temp, dateTransform)
});
- 上面的代码最终将日期输出为
xxxx-xx-xx格式。 - 管道与指令一样，都是为了将功能操作与业务逻辑分离，使得相同的功能能得以重用。
事件处理
Elf.js的事件绑定与原生HTML一样。
<!-- viewComponent.html -->
<button onclick="onClick($event);">
点击试试
</button>
// viewComponent.js
var temp = require("viewComponent.html");
module.exports = Elf.Component("view", {
render : Elf.redactElement(temp),
onClick : function (event) {
alert("点击被触发了!");
}
});
Elf.js将会自动管理事件的绑定与移除，即使在循环中也不必担心作用域的问题。也不必担心性能问题。Elf.js提供了一套与原生一样的冒泡机制，Component亦可作为触发事件的对象。
组件通讯
- 因为
Elf.js实现的事件机制与原生相同，并且可作用与Component，所以Elf.js不需要额外的状态管理手段。子组件的事件通过这种机制会冒泡到Individual，你只需在Individual处处理业务逻辑即可。又因为Elf.js是自动响应的，你也不需要关心数据变化后的呈现。她会自动分析新的数据与之前的数据，将更新呈现在页面上。 Elf.js并不提供双向绑定，亦不推崇单向数据流。原始的事件机制就是最好的手段，她早已深入每一个前端程序员心中。- 这里我们使用一个完整的示例 elfjs-calendar 。
- 在
sldier.js与calendar.js里分别抛出了日历操作事件，在main.js业务逻辑。
进阶
正如上面的教程，
Elf.js核心只提供了Component、Directive和Transform三个对象。模板中只提供了两个控制流程的属性（e-for和e-if）和一个文本输出{{ }}。但Elf.js在背后所做的远远不止于此。她有着高效的虚拟DOM和原生一样的事件机制，还能自动响应数据变化。如果你想深入了解其原理（其实现在主流框架的原理都是相近的）。Elf.js为一个极简的框架，将会是一个最好最优的选择。
深入响应式原理
受 zone.js 启发。数据的改变的时机无外乎用户操作（触发事件）和异步函数（Ajax和setTimeout等）。Elf.js封装了事件监听和常用的异步操作。使之能够得到监控，在这些异步操作结束后，Elf.js将会去计算数据变化，然后以最优的方式更新DOM。
集成第三方类库
由于Elf.js封装了原生的事件，但并没有像 zone.js 一样侵入。所以通过Elf.js创建的DOM不再触发用原生方法绑定的事件。因此第三方类库的监听可能无法触发其绑定的事件。通过引入shims_for_Lib.js可以让Elf.js接管Window和Node的事件监听。从而让第三方类库完美运行，亦可自动响应数据变化。
使用扩展语言
Elf.js无缝支持JSX（elf.d.ts中可以找到JSX定义）。但Elf.js更推荐使用模板。相较于JSX，模板有着良好的结构，视图与逻辑分离，更好的与UI合作。同时，使用elf-loader.js加载模板，会有source map，弥补了模板调试难的短板。
生产环境部署
如同之前的开发一样，我们使用node开发，AMD和CommonJS的风格都能支持，在开发阶段无需编译、打包，并有source map输出，拥有非常好的开发体验。在使用打包工具（如：webpack）打包后不再输出source map，在没有察觉的情况下就已经提升了性能。打包过程中亦无需其它loader。当然，若想追求极致性能可以使用loader将模板预编译为 JavaScript 。
