XTemplate - 网页数据绑定组件


GPL
跨平台
JavaScript

软件简介

XTemplate是一个javascript组件,主要是用于完成html页面上数据的绑定。常用的方式是用ajax从远程读取数据,XTemplate会将这些数据按规则绑定到页面的dom上去。它支持两种绊绑定方式,绑定数组和绑定对象。简单的说一个用于显示列表,另一个用于显示一般内容。

单变量绑定

是以html中data-bind标记为绑定对象,只要data-bind的内容和绑定的变量同名,即会自动赋值。

例如:

<p data-bind='title'></p>

这时如果有一个变量为如下结构{title:’hello world’},那么,这个name为title的p标签就会显示hello world。

最终会生成

<p data-bind='title'>hello world</p>

使用方法参见示例:

1.普通绑定:输出到p的默认内容中,此处为innerHTML属性。一般img将输出到src,input输出到value,其它输出到innerHTML。

<p data-bind="content"></p>

2.原始值按html输出:

<p data-bind="content" data-bind-to="innerHTML"></p> 或 <p data-bind="content" data-bind-to="innerHTML">{!content}</p> 第1种为简写,第2种为data-bind-to的标准写法

3.data-bind-to使用:

<b data-bind="market_product_id" data-bind-to="title" title="{!content}">title</b> data-bind-to指定了输出的属性,所以将绑定的内容将按data-bind-to进行绑定。此处data-bind-to为title,
待绑定的属性内容要使用模板。
所以XTemplate将会把market_product_id的值绑定到title属性上。
此处模板内content前有个叹号“!”,代表输出原始值,不进行html转义。

4.模板输出:必须使用data-bind-to指定属性名,默认的输出属性值不会当作模板。

<p data-bind="content" data-bind-to="innerHTML"><b>{content|default,'没有内容显示'}</b></p> content的内容会以内部html为模板绑定后显示

如果content为空,最终输出 <p data-bind="content" data-bind-to="innerHTML"><b>没有内容显示</b></p> 如果刚开始不想显示出模板的内容,可以将p设置为隐藏 <p style="display:none" data-bind-to="innerHTML" data-bind="content"><b>{content|default,'没有内容显示'}</b></p> 或 <p class="hide" data-bind-to="innerHTML" data-bind="content"><b>{content|default,'没有内容显示'}</b></p> 绑定后style.display将被重置为空,css中的hide也会被移除。

5.img的src绑定:

<img data-bind="thumb"/> 最终输出<img data-bind="thumb" src="图片地址"/> 指定img的默认显示图片,直接使用原来的src指定默认图 <img data-bind="imgsrc" data-bind-src='/{imgsrc}/abc.jpg' src='默认图'/> 如果img的地址比较复杂,是组合而成,或是需要用函数,可以使用data-bind-src来指定src的模板。 <img data-bind="thumb" data-bind-src="{thumb1|default,'logo.jpg'}"/> 注意不要用src属性!!!

不使用data-bind-to指定src,是因为如果指定img的src,将会使浏览器多产生一个无效的http请求,影响加载效果。

错误的例子:<img data-bind="thumb" data-bind-to="src" src='/{imgsrc}/abc.jpg'> /{imgsrc}/abc.jpg这个地址是不存在的地方,所以会引起一个错误的http请求。

数组绑定

数组绑定是指定一个模板,并把数组的内容循环,按模板格式化后返回多行html。

例如:

 <ul data-repeat-name='listdata'> <li>{title}</li> </ul>

这里定义了一个名为listdata的模板,ul的内部html将成为可循环的模板,即

 <li>{title}</li>

为待循环的内容

我们绑定以下变量[{title:’hello 0’},{title:’hello 1’}]

最终会生成

<ul data-repeat-name='listdata'> <li>hello 0</li> <li>hello 1</li> </ul>

使用方法参见示例:

1.普通输出:

 <ul data-repeat-name='data'> <li>{market_product_id}:{product_name}</li> </ul>

2.img的src绑定:

 <ul data-repeat-name='data'> <li><img data-bind-src='{thumb}'/>{market_product_id}:{!content}</li> </ul> 这里与单变量绑定不同的是没有使用data-bind指定绑定的属性,其它使用方法完全一致。

模板的使用

模板的基本语法是{模板内容},两端以大括号包围,中间为模板的内容。

如:{username},即输出变量username的内容。

模板可以在循环的模板中使用,也可以在待绑定属性中使用,也可以在data-bind-src中使用。

使用方法参见示例:

1.使用内部函数处理输出结果:

{market_product_num|repeat,'*'}//最终输出market_product_num个*,repeat为内部函数 语法为:[属性名]|[函数]|[函数] 属性名后竖线"|"连接函数名,当前的属性必须为函数的第1个参数。 多个函数时依次用竖线连接,前一个函数作为后一个函数的第一个变量输入。 如:{user_money|format_money},其中user_money为绑定属性名,format_money为内部函数名,主要作用为格式化货币。 如果函数有多个参数,使用逗号连接。

2.使用外部函数处理输出结果:

{market_product_id|#hello,':)'} 函数名前加了#号,代表使用外部函数,此处使用了hello,该函数使用前一定要定义。 此处market_product_id的值会传给s变量,即第1个变量。 示例1: function hello(s){ return s+' hello'; } 示例2: function hello(s,v){ return s+'hello'+v; }

3.使用多个函数处理输出结果:

{market_product_id|repeat,'@@'|#hello,':)'} 用|连接即可。

4.使用外部变量:

{id}={#out_abc} 变量前加#

5.进行简单的运算:

{market_product_id * 3 + 12} 在模板中,属性名支持简单的加减乘除运算,复杂的请使用自定义函数处理。

6.在模板中处理子循环:

{list|range,'ID:(id)&nbsp; '} 使用内部函数range,参数为模板内容。但为了区分子模板和主模板,子模板使用小括号“()”代替大括号。

特殊语法:

!号的使用

在模板中使用,例如{!title},输出title的值,以没有!的区别,这里不会把html进行编码,会输出原始的html。

号的使用

在函数名中使用,如果在函数名前加#,则指定这个函数为全局函数,这时这个函数必须是已经定义好的全局函数或是javascript的内部函数。
在变量名中使用,如果果变量名前加#,则指定这个变量为全局变量,这时这个变量必须是已经定义好的全局变量。