tempo 2.0 学习记录

最近在做项目时使用了tempo,感觉还不错,但是发现网上对于tempo 2.0 的介绍比较少,我也是在GitHub才找到了比较完整的使用说明,我也简单记录一下自己的使用过程,重新学习一下tempo 2.0 ,

不喜勿喷,喜欢看英文的朋友请移步tempo 2.0 英文说明 .

1.引入tempo.js

<script src="js/tempo.js" type="text/javascript"></script>

2.准备数据Data(标准的json数据)

var data = [
{'name':{'first':'Leonard','last':'Marx'},'nickname':'Chico','born':'March 21, 1887','actor': true,'solo_endeavours':[{'title':'Papa Romani'}]},
{'name':{'first':'Adolph','last':'Marx'},'nickname':'Harpo','born':'November 23, 1888','actor':true,'solo_endeavours':[{'title':'Too Many Kisses',
'rating':'favourite'},{'title':'Stage Door Canteen'}]},
{'name':{'first':'Julius Henry','last':'Marx'},'nickname':'Groucho','born': 'October 2, 1890','actor':true,'solo_endeavours':[{'title':'Copacabana'},
{'title':'Mr. Music','rating':'favourite'},{'title':'Double Dynamite'}]},
{'name':{'first':'Milton','last':'Marx'},'nickname':'Gummo','born':'October 23, 1892'},
{'name':{'first':'Herbert','last':'Marx'},'nickname':'Zeppo','born':'February 25, 1901','actor':true,'solo_endeavours':[{'title':'A Kiss in the Dark'}]}
];

3.Tempo.prepare().render()使用方式(需要找到承载数据的容器)

<script language="javascript" type="text/javascript"> $(function(){ Tempo.prepare('呈现数据的容器ID').render(数据源); }); </script>

4.data-template(html数据展示)

<script type="text/javascript">
$(function () {
    var data1 = { 'leonard': 'Leonard Marx', 'adolph': 'Adolph Marx', 'julius': 'Julius Henry Marx', 'milton': 'Milton Marx', 'herbert': 'Herbert Marx' };
    var data2 =  [{'name':{'first':'Leonard','last':'Marx'},'nickname':'Chico','born':'March 21, 1887','actor': true,'solo_endeavours':[{'title':'Papa Romani'}]},
    {'name':{'first':'Adolph','last':'Marx'},'nickname':'Harpo','born':'November 23, 1888','actor':true,'solo_endeavours':[{'title':'Too Many Kisses','rating':'favourite'},{'title':'Stage Door Canteen'}]},
    {'name':{'first':'Milton','last':'Marx'},'nickname':'Gummo','born':'October 23, 1892'},
    {'name':{'first':'Herbert','last':'Marx'},'nickname':'Zeppo','born':'February 25, 1901','actor':true,'solo_endeavours':[{'title':'A Kiss in the Dark'}]}];

    Tempo.prepare("list1").render(data1);
    Tempo.prepare("list2").render(data2);

});
</script>

<fieldset>
    <legend>简单数据展示</legend>
    <ol id="list1">
        <li data-template data-from-map>{{value}} - {{key | append '@marx.com'}}</li>
    </ol>
</fieldset>
<fieldset>
    <legend>嵌套数据展示</legend>
    <ol id="list2">
        <li data-template>
            {{nickname}} {{name.last}}
            <ul>
                <li data-template-for="solo_endeavours">{{title}}</li>
            </ul>
        </li>
    </ol>
</fieldset>

5.对字段数据格式化

{{ field | truncate 25[, 'optional_suffix'] }}
截取字符串 使用方法：{{字段名|truncate 长度}}

{{ field | format[, numberOfDecimals] }}
保留小数后的位数 使用方法：{{字段名|format 位数}}

{{ field | default 'default value' }}
如果字段未定义和值为NULL时显示的默认值 使用方式：{{字段名| default '默认值'}}

{{ field | date 'preset or pattern like HH:mm, DD-MM-YYYY'[, 'UTC'] }}
日期格式化 使用方式{{字段名 | date 'YYYY-MM-DD HH:mm:ss'}}

{{ field | trim }}
清除开始和结尾的空格

{{ field | upper }}
改变任何小写字符的值为大写。

{{ field | lower }}
改变任何小写字符的值为小写。

{{ field | titlecase[, '需要过滤的字符串'] }}
对标题进行过滤不显示的字符

{{ field | append '需要添加的字符串' }}
如果字段非空，添加后缀和其它字符串

{{ field | prepend 'some prefix ' }}
如果字段非空，添加前缀或者其它字符串

{{ field | join 'separator' }}
如果此字段是一个数组，则往该数组里添加一个项

6.字段值转义

　　 Tempo.prepare('marx-brothers', {'escape': false}).render(data);

7.template.when(type, handler)

Type 事件类型 的值

• • TempoEvent.Types.RENDER_STARTING :模板替换开始
  • TempoEvent.Types.ITEM_RENDER_STARTING :数据项替换开始
  • TempoEvent.Types.ITEM_RENDER_COMPLETE : 数据项替换完成
  • TempoEvent.Types.RENDER_COMPLETE :模板替换完成
  • TempoEvent.Types.BEFORE_CLEAR : 在清理数据之前
  • TempoEvent.Types.AFTER_CLEAR : 在清理数据之后 

handler (function(){})

8.加载数据时前后事件的处理,事件注册

1.
Tempo.prepare('tweets').when(TempoEvent.Types.RENDER_STARTING, function (event) {
        $('#tweets').addClass('loading');
    }).when(TempoEvent.Types.RENDER_COMPLETE, function (event) {
        $('#tweets').removeClass('loading');
    }).render(data);

2.template.starting()手动调用开始事件
var template = Tempo.prepare('tweets').when(TempoEvent.Types.RENDER_STARTING, function (event) {
            $('#tweets').addClass('loading');
        }).when(TempoEvent.Types.RENDER_COMPLETE, function (event) {
            $('#tweets').removeClass('loading');
        });
template.starting();
$.getJSON(url, function(data) {
    template.render(data.results);
});

3. jQuery  live() 事件
$('ol li').live('click', function() {
    // Do something with the clicked element
    alert(this);
});

9.条件选择模板 if....else...

{% if javascript-expression %} ... {% else %} ... {% endif %}   //{% else %} 为可选块

Data-if-字段名="值"
       <li data-template  data-if-sex="母">{{Name}}</a></li>

Data-has="是否存在的字段"
       <li data-template  data-has="ifBianZhong">{{Name}}</a></li>

Data-src="{{字段名|append '.png'}}"
       <img src="1.gif" data-src="{{Image| append '.png'}}"  />

ok.大功告成...如果有理解不对的地方,还请朋友及时提出,此文为个人学习总结,英文较好的朋友可直接移步tempo 2.0 英文说明 .