avalonJS是司徒正美开发和维护的前端mvvm框架，可以轻松实现数据的隔离和双向绑定，相比angularJS等前端框架它有如下优势：

1.压缩后仅有60多kb，而angular的min版是100多kb；

2.兼容IE6+，符合天朝市场需求；

3.效率更高，跑起来比angular和knockout都要更快，在移动端上该优势会更大（avalon有移动端专版的avalon.modern.js）。关于其性能更详细的介绍可以看；

4.涵盖了angular的大部分功能，且实现方式更为便捷、上手更容易;

5.有配套的UI库（当然这个按需选择即可），由司徒正美及其“去哪儿”团队维护，有相关的中文文档（下方会提到），除了在github提交issue，你也可以加入正美的Q群79641290 来交流问题或提交bug。

（这位兄台，谷歌送温暖，开门查水表）

然而avalon也有自己的劣势——知名度较低。不过毕竟国产的东西没经BAT推广，要像seaJS那样驰名中外倒是不容易。

相关中文文档

正美其实私下写了不少avalon的官方api和教程，大家可以访问如下地址：

（下载最新的avalon以及实例（examples文件夹里），通过实例来掌握某些功能的实现是很好的学习途径）

（比较快捷的入门课程，只用了几篇文章来介绍了最常用的一些功能）

（正美的博文，篇幅较大，涵盖知识点很多，可以当作API来查阅，只是正美的博客排版真的。。。看起来略吃力），也可以在查看更规范的API。

（强烈推荐，用了20多篇文章较详细地、渐进地介绍avalon，必读的就是啦）

（推荐）

本系列初衷

虽然正美已经细心编写了不少中文文档，不过有的文章技术门槛有点高，不太适合初学者，另外作为avalon的用户，以用户的角度来较详细地介绍avalon或许会更合适些。

本系列相比正美的教程，会更侧重于“怎么用”，而非其机制或原理的介绍。

另外也希望本系列能为推广avalon出一份绵薄之力，希望能让更多的前端爱好者开始接触avalon，并喜欢上这个前端利器。

本系列技术需求

本系列除了avalonJS之外，还会搭配requireJS做辅助，特别是后面我们会使用avalon的路由系统，来做一个单页面站点（放到移动端就是SPA了），需要requireJS及其插件来按需加载脚本和样式文件，故建议查阅本系列的朋友要多多少少会一点requireJS的知识。

个人还是觉得avalon搭配requireJS的话，在前端可谓hold住全场了（咱忽略node及其框架...）~

开始

我们可以在获取最新版本的avalonJS，然后将其引入页面中（本章先不考虑搭配requireJS，仅仅先玩一玩、介绍下）：

接着，类似于ng的“ng-controller”，avalon的控制域属性名叫做“ms-controller”，你可以把它当作一个监听器，把它绑定到一个容器后，avalon就能扫描和监听这个容器内的所有（绑定了avalon方法或带有插值表达式的）元素了。

我们来给div加上这个监听器，并在里面写一个avalon插值表达式{

{

XXX}}:

     
      {
   {a}}
     

你现在运行它的话，还没有任何效果，因为我们还没有写脚本来让avalon工作起来。我们可以来这么一段简单的脚本：

     
      {
   {a}}
     

在avalon中，我们用 avalon.define({

... }) 的形式来定义一个Model实例（其参数可以看做一个avalon数据对象），其中的 $id 是内置属性，对应所要扫描和监控的控制域名。

我们还在内部定义了一个属性"a"，故在对应的控制域（如这段代码对应的域是绑定ms-controller="wrap"的div标签）里，我们使用avalon插值表达式{

{a}}的话，可以自动绑定其值“你好啊”。

注：最后一句 avalon.scan(); 可以不加上，不过后续我们会使用requireJS来配合使用avalon，届时会建议删掉avalon的DOMReady模块，故先养成加上scan的习惯。

上述代码运行效果如下：

当然，avalon有着更类似ng的写法：

avalon.define("wrap", function(vm) {  ......})

但个人觉得没必要，还是下方的写法来的简单（本系列后续的实例也将遵从该写法）：

var vm = avalon.define({    $id:wrap,    ......})

下面这段代码可以帮你更好了解avalon的控制域：

     
      {
   {a}}
     
     
          {
    {a}}    
      {
   {b}}
     

执行效果如下：

两个作用域（ms-controller）之间可以互相访问彼此的数据，还记得我们给avalon.define的前面定义了一个载体么（var XX = avalon.define），利用它就能轻松获取：

     
      {
   {a}}
     
     
          {
    {a}}    
      {
   {b}}
     

执行效果：

数据和视图同步

上方我们实现了非常简单的数据绑定，将一个avalon对象属性a绑定到DOM元素上。不过avalon更有趣和实用的地方是它实现了数据与视图的同步，说的简单点，我们用脚本修改了a的值，那么DOM上绑定的数据也会跟着改变（当然反过来也是一样的）：

     
    
      {
   {a}}    
      
     

注意我们这里增加了一个 <input ms-duplex="a" /> ，其中的 ms-duplex 是avalon的双工绑定属性，它除了负责将VM中对应的值（如本例是a）放到表单元素的value中，还对元素偷偷绑定一些事件，用于监听用户的输入从而自动刷新VM。

执行如下：

实例

利用avalon数据-视图同步的特性，我们可以更便捷地、更少代码地实现某些功能。举个例子，我们来实现一个选项卡的功能：

如上图的选项卡你会如何实现呢？可能你会写两个ul来对应下方两个选项卡列表，每个ul里都写上4个li（或者让后端人员通过后端框架来写loop，从而动态生成li），然后你再把第二个ul隐藏了，接着写个方法，让鼠标移到第二个选项卡标题时，第一个ul隐藏，第二个ul显示，对吧。

还有右上角的 “更多XX” 的连接，也可以通过隐藏-显示的方式来实现

你的DOM代码可能是这样的：

     
  
      公告
      媒体报道  
      更多公告
      更多报道  
      
      
       
公告文章标题1
      
       
公告文章标题2
      
       
公告文章标题3
      
       
公告文章标题4
  
      
  
      
      
       
媒体报道文章标题1
      
       
媒体报道文章标题2
      
       
媒体报道文章标题3
      
       
媒体报道文章标题4
  
      
     

但使用avalon的话，一切都更简单：

     
    
      公告    
      媒体报道    
      {
   {more_text}}    
      
        
       
            {
   {el.title}}        
    
      
     

首先它只有一个“更多XX”的<a>标签，而且只有一个<ul>，而且不存在任何后端标签的介入就能实现数据循环绑定。

它的优势在数据越多的时候会越明显（例如每个ul要显示100条li）。

我们来看看avalon的脚本应当怎么写：

     
    
      公告    
      媒体报道    
      {
   {more_text}}    
      
        
       
            {
   {el.title}}        
    
      
     

执行效果：

我们来逐步分析下上方的代码。首先看第一段脚本：

这里的 gg 表示“公告”的列表JSON数据，bd 则是“媒体报道”的列表JSON数据，你可以让后端的朋友直接在此处提供JSON数据过来。我们后续会利用avalon把这些数据绑定到页面视图上。

我们再看DOM结构：

     
    
      公告    
      媒体报道    
      {
   {more_text}}    
      
        
       
            {
   {el.title}}        
    
      
     

<span>中的 ms-mouseover 是avalon的“onmouseover”方法，其值 changeUl(X) 是我们在最后的avalon脚本中定义的一个事件方法，然后比如当鼠标移到“媒体报道”的span上，会触发绑定是 changeUl(0) 事件。

我们再看看 <a ms-href="'#!/'+ more_name">{

{more_text}}</a>  这里的 ms-href 自然也是avalon中的“href”属性，可以植入avalon对象属性（如这里的more_name），也可以加上字符串（如这里的'#!/'），但要用引号括起来，不然会被当作avalon对象属性处理。

接着是最重要的部分：

      {
   {el.title}}

我们使用了 ms-repeat="XX" 属性来绑定要重复显示的哈希数据，同时会生成一个代理VM对象，该代理对象拥有el，$index, $first, $last, $remove 等属性（点查看详细），其中我们用到的 el 表示指向当前的数据元素，从而可以通过 el.id ，el.title 来获取infoList数组对象的具体元素。

最后咱再看看avalon脚本：

这里要注意的是我们用了

gg:gg,   //获取公告JSON数据        bd:bd,   //获取媒体报道JSON数据

来获取和存储“公告/媒体报道”的JSON数据到avalon对象的属性中（左侧的gg和bd是avalon对象属性，右侧的gg和bd是全局变量），这样做的原因是后续的回调事件changeUl(flag)要通过参数来判断和修改vm.infoList的值，而其值应同为avalon对象属性。如果把代码改为这样会出错（刚用avalon的朋友可能就会这样写）：

执行效果如下：

是的，鼠标第一次移上去的时候是无误的，但再移到其它选项卡的时候就不按常理出牌了，这是为什么？

这是因为当我们定义 “vm.infoList=gg” 时，vm.infoList 自然指向了 gg（注意gg是一个对象类型），若vm.infoList的值改变了，那么其指向的 gg 对象的值自然也会跟着改变。你可以这样来调试：

var vm = avalon.define({        $id: "list",        more_name: "gg",        more_text: "更多公告",        infoList:gg,        changeUl:function(flag){            console.table(gg); //console出“公告”变量的数据信息            if(flag){                vm.more_name = "gg";                vm.more_text = "更多公告";                vm.infoList = gg;            }else{                vm.more_name = "bd";                vm.more_text = "更多报道";                vm.infoList = bd;            }        }    });    avalon.scan();

结果（第一次回调事件的gg是正常的，但第二次开始就变成了媒体报道的数据）：

因此我们要记得，若存在外部引入的数据，应用一个avalon对象属性保存起来。

第一篇入门文章就到这里，下一篇我们开始以配合requireJS的形式来使用avalon。

共勉~