avalon.js怎么把变量js 添加属性到属性

稍为复杂一点的网站都是多个前端工程师合作而成,因此分工是必需的。简单一点的分工就是一个人负责一个频道,某个页面是由一个人全部做的;但如果涉及到一个页面非常复杂,需要多个人同时动工呢?于是到模板的出场时间了。
模板有两种,一种是嵌入到页面内的模板,一种是独立成子页面的模板。这两种avalon都支持。前者通常是使用type为浏览器无法识别的MIME类型的script标签,display:none的textarea标签或noscript标签(0.94后支持,建议使用它)作为模板容器,最近HTML5出了一个新的template标签,大家也不妨用一用。一般情况下,它是用于放置弹出层的内容。另一个模板,则需要通过AJAX请求来加载它们,它们适用范围更广,并且重用性更好。
对于页面内的模板,我们可以使用ms-include=”expr”绑定,对于独立于页面的模板,我们可以使用ms-include-src=”expr”绑定。ms-include要求对应一个ID(换言之,作为模板容器的script等标签必须指定ID),ms-include-src要求对应一个路径。需要注意的是ms-include或ms-include-src的属性值默认都是对应VM的一个属性,当作是一个变量,如果想直接使用字符串,那么需要使用双重引号。
&!DOCTYPE html&
&meta http-equiv="content-type" content="text/ charset=UTF-8" /&
&script src="avalon.js"&&/script&
var model = avalon.define({
$id: "test",
content: "引入内部模板",
name: "司徒正美",
eee: "lala",
change: function() {
model.eee = model.eee === "lala" ? "hehe" : "lala"
&body ms-controller="test"&
&script type="avalon" id="tpl"&
here, {{ 3 + 6 * 5
&script type="avalon" id="lala"&
&strong&{{name}}&/strong&!!!
&script type="avalon" id="hehe"&
&em&{{content}}&/em&!!!
&p&{{content}}&button ms-click="change" type="button"&切换子模板&/button&&/p&
&div ms-include="'tpl'"&&/div&&!--注意这里--&
&div ms-include="eee"&&/div&
ms-include与ms-include-src的属性值可以添加插值表达式,见下面例子,不过注意需要打开服务器,因为用到AJAX请求。
有四个页面,一个主页面与三个独立的子模板,它们都放在一起,内容分别如下。
include.html
&!DOCTYPE html&
&meta http-equiv="X-UA-Compatible" content="IE=Edge" /&
&meta http-equiv="Content-Type" content="text/ charset=UTF-8"&
&title&ms-include&/title&
&script src="../avalon.js"&&/script&
var model = avalon.define({
$id: "test",
url: "Template1",
name: "司徒正美",
password: '',
array: [1, 2, 3, 4, 5, 6, 7],
add: function(e) {
if (this.value && e.which == 13) {//this为input元素
var a = this.value
model.array.push(a)
this.value = "";
&h3 style='text-align: center'&ms-include&/h3&
&div ms-controller="test"&
&select ms-duplex="url"&
&option&Template1&/option&
&option&Template2&/option&
&option&Template3&/option&
&div ms-include-src="include{{url}}.html"&&/div&
includeTemplate1.html
&h1&这是模板1&/h1&
&p&生成于{{ new Date | date("yyyy MM dd:HH:mm:ss")}}&/p&
&p&生成于{{ "" | date("yyyy MM dd:HH:mm:ss")}}&/p&
&p&生成于{{ "" | date("yyyy MM dd:HH:mm:ss")}}&/p&
&p&生成于{{ "01-10-2000" | date("yyyy MM dd:HH:mm:ss")}}&/p&
&p&生成于{{ "07 04,2000" | date("yyyy MM dd:HH:mm:ss")}}&/p&
&p&生成于{{ "3 14,2000" | date("yyyy MM dd:HH:mm:ss")}}&/p&
&p&生成于{{ 9 | date("yyyy MM dd:HH:mm:ss")}}&/p&
&p&生成于{{ "9" | date("yyyy MM dd:HH:mm:ss")}}&/p&
&p&值得注意的是,new Date可传的格式类型非常多,但不是所有浏览器都支持这么多,详看&a href="/date-formats.html"&这里&/a&。&/p&
includeTemplate2.html
&script type="avalon" id='form'&
&p&姓名:&input ms-duplex="name"&{{name}}&/p&
&p&密码:&input type="password" ms-duplex="password"/&{{password}}&/p&
&form ms-include="'form'" style='border:1px solid #666;background:padding:20px'&
includeTemplate3.html
&ul ms-each-el="array"&
&li &第 {{$index+1}} 个元素: {{el}} &span ms-click="$remove"&点我删除&/span&&/li&
&p&添加新元素 ,然后回车&input ms-keypress="add"&&/p&
如果大家想在模板加载后,加工一下模板,可以使用data-include-loaded来指定回调的名字。
如果大家想在模板扫描后,隐藏loading什么的,可以使用data-include-rendered来指定回调的名字。
&!DOCTYPE html&
&title&ms-include相关实验&/title&
&meta http-equiv="Content-Type" content="text/ charset=UTF-8"&
&meta http-equiv="X-UA-Compatible" content="IE=edge" /&
&script src="avalon.js"&
avalon.define("test", function(vm) {
vm.render = function(){
console.log("render")
&body ms-controller="test" &
&div ms-include-src="'temp.html'" data-include-rendered='render'&&/div&
&!DOCTYPE html&
&title&TODO supply a title&/title&
&meta charset="UTF-8"&
&meta name="viewport" content="width=device-width"&
console.log("----------")
&div&include content&/div&
最后我们看avalon.templateCache,所有ms-include-src加载的模板都会缓存在这里,从而有效地减少请求数。并且这个东西还有一个额外的好处,我们的JS与CSS最终会压缩合并,对于这些模板我们也想把它们合并到JS文件里面,它就有用武之地了。这也是我们在第一节看到的那样,把requirejs加载回来的模板都放在avalon.templateCache里,与ms-include-src一起使用了。
&!DOCTYPE html&
&title&avalon.templateCache的应用&/title&
&meta charset="UTF-8"&
&meta name="viewport" content="width=device-width"&
&script src="avalon.js"&&/script&
avalon.templateCache["aaa.html"] = "&strong&dddddddddddd&/strong&"
avalon.templateCache["bbb.html"] = "&em&&/em&"
var model = avalon.define({
$id: "test",
adjust: function(tmpl) {
return tmpl +"
"+ (new Date - 0)
aaa: "aaa.html",
change: function() {
model.aaa = model.aaa === "aaa.html" ? "bbb.html" : "aaa.html"
&body ms-controller="test"&
&div ms-include-src="aaa" data-include-loaded="adjust"&&/div&
&button type="button" ms-click="change"&点我切换模板&/button&前端神器avalonJS入门(二) - 推酷
前端神器avalonJS入门(二)
本章开始搭配requireJS来使用avalon,开始之前,我们可以对avalon进行精简改造。
avalon源码里有自己的AMD加载器和DOMReady模块,使用requireJS来加载各依赖脚本的话,使用其配套插件DOMReady来ready执行会更合适,而且avalon的AMD模块也多余了。故我们可以把这俩块代码咔嚓掉。
只需要在源码里搜索“AMD”和“DOMReady”就能找到位于尾部的这俩模块,删掉它们可以节省400多行代码 (大约是第4358行到4777行) :
要注意的是avalon的DOMReady模块里带了自扫描机制,它能在DOMReady后自动执行avalon.scan()来扫描和执行文档中的avalon功能属性:
所以我们删掉源码中DOMReady模块的话,之后编写avalon脚本应当在最后手动加上一句 avalon.scan() 或 avalon.scan(document.getElementById(&XX&)) ,前者会扫描整个文档,后者只会扫描所选DOM内区域,我个人是推荐使用后者。
其实在第一篇的时候就有提过这个问题了,只是没细说:
删掉avalon自带的AMD和DOMReady模块后,还有一个小地方也建议修改下 (非必须项) ,它是avalon内置的调试方法,为不干扰后续自己的脚本调试,可以把它注释掉。
方法是直接在源码搜索“console”,大约在46行的位置注释掉log()方法里的调试代码即可:
本章要用到的脚本除了精简后的avalonJS,还需要requireJS及其插件DomReady.js (后续篇章还会用到css.js来按需加载样式文件) 。
你可以在我的Github上直接下载本章的Demo(晚上更新到Github并提供连接,现在在公司不方便),也省去了搜罗上述脚本的过程。
我们依旧拿上一篇的选项卡来做本章示例即可,本章主要介绍的仅为如何在使用requireJS的基础上使用avalon:
我们本章示例的文件系统可以是这样的:
其中的js/page文件夹下的 index.js 作为 index.html 页面的脚本入口(requireJS的main入口)。js/tool文件夹下则存放要用到的工具。这样还蛮简洁直观的对吧。
在 index.html 页面里,我们仅需引入配置了入口的requireJS文件即可:
&script src=&js/tool/require.js& type=&text/javascript& data-main=&js/page/index&&&/script&
然后加入我们上一篇avalon文章中写好的内容,整体是这样的:
&!DOCTYPE html&
&head lang=&en&&
&meta charset=&UTF-8&&
&title&初玩阿瓦隆&/title&
&script src=&js/tool/require.js& type=&text/javascript& data-main=&js/page/index&&&/script&
&script type=&text/javascript&&
//这里给后端提供数据接口
var conf = {
gg:[{&id&:&1&,&title&:&公告文章标题1&},{&id&:&2&,&title&:&公告文章标题2&},{&id&:&3&,&title&:&公告文章标题3&},{&id&:&4&,&title&:&公告文章标题4&}],
bd:[{&id&:&1&,&title&:&媒体报道文章标题1&},{&id&:&2&,&title&:&媒体报道文章标题2&},{&id&:&3&,&title&:&媒体报道文章标题3&},{&id&:&4&,&title&:&媒体报道文章标题4&}]
&div ms-controller=&list&&
&span ms-mouseover=&changeUl(1)&&公告&/span&
&span ms-mouseover=&changeUl(0)&&媒体报道&/span&
&a ms-href=&'#!/'+ more_name&&{{more_text}}&/a&
&li ms-repeat=&infoList&&
&a ms-href=&'#!/'+ more_name + '/' + el.id& ms-title=&el.title&&{{el.title}}&/a&
主页面写好了,我们再看看requireJS的入口脚本 js/page/index.js 怎么写。
首先是配置我们要调用到的文件(比如avalonJS和domReadyJS):
require.config({
baseUrl: 'js/',
//相对于index.html页面文件的地址
//这里配置的地址,都是相对于上方的baseUrl的
avalon: 'tool/avalon',
domReady:'tool/domReady'
avalon: { exports: &avalon& }
其中的baseUrl是当前config的全局路径,后面paths里定义的路径都是相对于baseUrl的,baseUrl的好处就是如果路径很长的话,可以拿它当前缀变量。例如上述代码paths里定义avalon的地址是 &tool/avalon&,实际运行的时候会给它加上前缀baseUrl(当然也会加上省略的后缀名.js)变成 &js/tool/avalon.js&。
shim指的是给非严格AMD标准的文件加上一层“壳”,增强代码健壮性。
接着就是我们对avalon脚本的常规调用了:
require(['avalon',&domReady!&], function() {
var vm = avalon.define({
$id: &list&,
more_name: &gg&,
more_text: &更多公告&,
gg:conf.gg,
bd:conf.bd,
infoList:conf.gg,
changeUl:function(flag){
vm.more_name = &gg&;
vm.more_text = &更多公告&;
vm.infoList = vm.
vm.more_name = &bd&;
vm.more_text = &更多报道&;
vm.infoList = vm.
avalon.scan();
require(['依赖文件1',&依赖文件2&], function() {
来处理模块依赖,然后注意domReadyJS的模块引用写法是“domReady!”,即在最后加了一个感叹号,表示优先使用其作为DOMReady处理模块。
整理一下,我们的 js/page/index.js 文件最终是这样的:
require.config({
baseUrl: 'js/',
//相对于index.html页面文件的地址
//这里配置的地址,都是相对于上方的baseUrl的
avalon: 'tool/avalon',
domReady:'tool/domReady'
avalon: { exports: &avalon& }
require(['avalon',&domReady!&], function() {
var vm = avalon.define({
$id: &list&,
more_name: &gg&,
more_text: &更多公告&,
gg:conf.gg,
bd:conf.bd,
infoList:conf.gg,
changeUl:function(flag){
vm.more_name = &gg&;
vm.more_text = &更多公告&;
vm.infoList = vm.
vm.more_name = &bd&;
vm.more_text = &更多报道&;
vm.infoList = vm.
avalon.scan();
运行index.html,会发现一切顺利:
本章就先简单介绍在requireJS下如何使用avalon,下一篇avalon文章打算给大家介绍非常了得的东西——avalon的前端路由。
已发表评论数()
请填写推刊名
描述不能大于100个字符!
权限设置: 公开
仅自己可见
正文不准确
标题不准确
排版有问题
主题不准确
没有分页内容
图片无法显示
视频无法显示
与原文不一致属性操作是DOM操作很大的一块,它包括类名操作,表单元素的value属性操作,元素固有属性的管理,元素自定义属性的管理,某些元素的一些布尔属性的操作。大多数情况下,元素属性的值是字符串类型,我们称之为字符串属性,但有一些属性的是布尔,也存在是数字类型、节点引用的情况。当前jQuery处理它们就是搞了N个钩子对象,才摆平它们。为了收拾它们也设置N多绑定,其中类名部分交由ms-class、 ms-hover、 ms-active处理,这些其他章节介绍;表单元素的value属性之前也说过,可以用ms-value、ms-duplex;剩下还有ms-checked、 ms-selected、 ms-readonly、
ms-disabled、
ms-enabled、 ms-value、 ms-title、 ms-alt、 ms-href、 ms-src、 ms-attr-☆ 11个。其他前五个为布尔属性绑定,后五个为字符串属性绑定,最后一个为通用属性绑定。不过 后来, 随着如何判定固有属性的技术的发掘,它们最终全部由ms-attr-☆实现。
在IE下,需要对属性进行区分,如果是固有属性使用elem[name] =
value赋值;是自定义属性,则直接使用elem.setAttribute(name,
value);标准浏览器没有这么麻烦,全部使用elem.setAttribute(name,
value),比如elem.setAttribute("value", "xxx")会自动同步到elee.value = "xxx"。
下面是其源码:
if (boolMap[attrName]) {
var bool = boolMap[attrName]
if (typeof elem[bool] === "boolean") {
return elem[bool] = !!val //处理布尔属性
if (!W3C && propMap[attrName]) {//旧式IE下需要进行名字映射
attrName = propMap[attrName]
var isInnate = true
if (val === false) || (val === null) || (val === void 0) {
return elem.removeAttribute(attrName)
if (window.VBArray && !isInnate) {
//IE下需要区分固有属性与自定义属性
//固有属性及VML元素必须使用中括号方式赋值
//SVG元素必须用setAttribute赋值
if (isVML(elem)) {
isInnate = true
} else if(window.SVGElement && !(elem instanceof SVGElement)) {
var attrs = elem.attributes || {}
var attr = attrs[attrName]
isInnate = attr ? attr.expando === false : attr === null
if (isInnate) {
elem[attrName] = val
elem.setAttribute(attrName, val)
有关如何判定自定义属性或固有属性,及其详细推导过程,可以看的第十章。
&!DOCTYPE html&
&title&ms-attr-*&/title&
&meta charset="UTF-8"&
&meta name="viewport" content="width=device-width"&
&script src="avalon.js"&&/script&
avalon.define("ms-attr-*", function(vm) {
vm.aaa = true
vm.click = function() {
vm.aaa = !vm.aaa
vm.bbb = "@@@"
vm.ccc = "&&&"
vm.active = "active"
background:
.readonly{
&form method="get" action="aaa.html" ms-controller="ms-attr-*"&
&input ms-enabled="aaa" name="a1" value="12345"/&
&input ms-disabled="aaa" name="a2" value="67890"/&
&input ms-readonly="aaa" name="a3" ms-class="readonly: aaa" value="readonly" /&
&input ms-checked="aaa" type="checkbox" value="checkbox" name="a4"/&
&select name="a5"&
&option&222&/option&
&option ms-selected="aaa"&555&/option&
&input ms-attr-value="其他内容
{{ccc}}" name="a6" value="改"/&
&input ms-attr-value="'其他内容 '+ccc" name="a7" value="改" /&
&input ms-value="其他内容
{{ccc}}" name="a8" value="改"/&
&button type="button" ms-click="click" ms-attr-class="active"&
&input type="submit" value="提交" /&
&svg width="100" height="100"&
&circle ms-attr-cx="50" cy="50" r="40" stroke="green" stroke-width="4" fill="yellow" /&
ms-enabled是ms-disabled的相反面,它根据表达式的值是否为真移除disabled属性。
的ms-attr绑定无比强大,不用像jQuery那么需要用户判定是使用attr还是prop方法,使用自行处理。当前位置: →
→ 迷你MVVM框架 avalonjs 入门教程
迷你MVVM框架 avalonjs 入门教程
& 作者及来源: 司徒正美 - 博客园 &
&收藏到→_→:
摘要: 迷你MVVM框架 avalonjs 入门教程
"迷你MVVM框架 avalonjs 入门教程"::
8.1. 路由定义
8.2. 参数定义
8.3. 业务处理
定义模板变量标识标签
10.1. http请求
10.2. 广义回调管理
11.1. 上下文绑定
11.2. 对象处理
11.3. 类型判定
12.1. 日志
12.2. 缓存
12.3. 计时器
12.4. 表达式函数化
12.5. 模板单独使用
自定义模块和服务
13.1. 模块和服务的概念与关系
13.2. 定义模块
13.3. 定义服务
13.4. 引入模块并使用服务
附加模块 ngresource
14.1. 使用引入与整体概念
14.2. 基本定义
14.3. 基本使用
14.4. 定义和使用时的占位量
/angular.html
关于avalon
avalon是一个迷你的mvvm框架,虽然从发布到现在,它臌胀了不少,但它现在还是比knockout小许多。avalon开发 一直遵循三个原则:1,复杂即错误,2,优于算法,3,出奇制胜。这三大原则保证avalon具有良好的维护性,扩展性,与众不同。
简单说一下其他三大mvvm的实现思路:
knockout:最早冒出来的
mvvm库,通过转换vm中所有要监听的东西为函数,然后执行它们,得到某一时刻中,一共有多少函数被执行,将它们放到栈中,最底的就是最先被执行的,它上面的就是此函数所依赖的函数,从而得到依赖关系。
然后设计一个观察者模式,从上面的依赖检测中,将依赖函数作为被依赖者(最先执行的那个的)的订阅者,以后我们对被依赖者进行赋值时,就会通先订阅者更新自身,从而形成一个双向绑定链。
并且,knockout会将视图中的绑定属性进行转换,分解出求值函数与视图刷新函数,视图刷新函数依赖于求值函数,而求值函数亦依赖于我们vm中的某些属性(这时,它们都转换为函数),在第一次扫描时,它们会加入对应属性的订阅者列队中,
从而vm中的某个属性改变,就会自动刷新视图。评价:实现非常巧妙,是avalon0.1-0.3的重要学习对象,但将属性变成一个函数,让人用点不习惯,许多用法都有点笨笨的。
虽然是一个轻盈的库,但扩展性不强,里面的实现异常复杂,导致能参与源码的人太少。
ember : 一个大而全的框架,包罗万象。一开始是使用object.defineproperty+观察者实现,但ie8的问题,让它不得不启用上帝setter, 上帝getter。没有自动收集依赖的机制,没有监控数组,计算属性需要自己指定依赖。vm可继承。
vm与视图的双向绑定依赖于其强大无比上万行的handlebars 模板。听说是外国目前最好用的mv*框架。因为作者既是 的核心成员,也是rails的核心成员,虽然由于兼容问题没实现自动收集依赖,但框架的其他方面做得非常易上手,人性化。
评价:太大了,优缺点同python的django框架。
angular: google组织开发的框架,体现其算法至上的时候到了。里面一共有两个parser, 一个是ngsanitize/sanitize. 下的html parser, 一个是ng/parse. (它要配合compile. 使用)的  parser。第一个parser负责绑定抽取,第二个负责从ctrl函数,工厂函数,服务函数及$watch回调中分解出无数setter, getter,
确认它们的依赖关系,放进观察者模式中。它的观察者无比强大,由于它的vm能继承,于是通过继承链实现四通发达的消息广播。它还实现了一个基于lru的缓存,因为google最喜欢以空间换时间了,另一方面说明它要缓存的东西太多了,非常吃内存。
公司内部用angular实现的grid,200行在pc中就拖不动了。它还用到许多时髦的东东,如html5 history api, 迷你版q promise。内部是极其复杂。
不过最大的问题是,它是基于parser,静态编译,这意思着什么呢?不抗压缩!为此,它此文来自: 马开东博客
转载请注明出处 网址:
引进了ioc,官网上给出的简单例子其实在项目完全不可用,我们需要使用另一种更复杂的写法,方便编泽器从它们得到不被压缩的部分,
让它在压缩情况也能正常运行。由于基于编译,许多行为都不是即时的,可预见的。用户写的那些控制器函数,都是为编译做准备。由于基于编译,它不得不要求我们对具有兼容问题的一些全局函数, 进行屏蔽,用它的给出的服务替代它们,如
window对应$window, document对应$document, location对应$location, settimout对应$timeout……如果不遵循这规则,它可能运行不了,你需要手动使用$digest手动触发。
评价:乍一看入门非常容易,其实相反。条条框框太多,适合那些一直与java搏斗的人士。对于那些接受过 洗礼的人来说,用着用着会造反的……
现在的avalon是我在完全消化了knockout发展起来的,准确来说,是0.4版,通过object.defineproperties与vbscript实现了与普通对象看起来没什么两样的vm,vm里面充满了访问器属性,而访问器属性肯定对应一个setter,一个getter,
我们就在setter, getter中走knockout的老路,实现自动收集依赖,然后放进一个简单的观察者模式中,从而实现双向绑定。将绑定属性分解为求值函数与视图刷新函数,早前,avalon也与knockout一样使用一个简单的parser,然后通过with实现,
0.82一个新的parser 上此文来自: 马开东博客
转载请注明出处 网址:
马,同样的迷你,但生成的求值函数,更方便依赖收集,并且没有with语句,性能更佳。angular也不是一无是处,我也从它那里抄来了{{}}插值表达式,过滤器机制,控制器绑定什么的。
avalon在内部使用了许多巧妙的设计,因此能涵盖angular绝对大多数功能,但体积却非常少。此外,在性能上,现在除了chrome外,它都比knockout快,angular则是最慢的。
在 端上,avalon这个优势会被大大放大化的。
关于avalon的几点:
配套着ajax,动画,,加载器,拖放等模块与功能
avalon会自动同步视图,不用操作dom,因此写出的业务代码比 更少,从而维护性更好
迷你mvvm框架在github的仓库/rubylouvre/avalon, 如果你要兼容ie6,那么下其中的avalon. , 如果你只打算兼容ie10与标准浏览器,那么下avalon.mobile. 。
官网地址http://rubylouvre.github.io/mvvm/
开始的例子
我们从一个完整的例子开始认识 avalon :
&!doctype html&
&title&&/title&
&meta http-equiv="content-type" content="text/ charset=utf-8"&
&script src="avalon. "&&/script&
&div ms-controller="box"&
&div style=" background: #a9ea00;" ms-css-width="w" ms-css-height="h"
ms-click="click"&&/div&
&p&{{ w }} x {{ h }}&/p&
&p&w: &input type="text" ms-duplex="w" data-duplex-event="change"/&&/p&
&p&h: &input type="text" ms-duplex="h" /&&/p&
avalon.define("box", function(vm) {
vm.w = 100;
vm.h = 100;
vm.click = function() {
vm.w = parsefloat(vm.w) + 10;
vm.h = parsefloat(vm.h) + 10;
上面的代码中,我们可以看到在 中,没有任何一行操作dom的代码,也没有选择器,非常干净。在html中, 我们发现就是多了一些以ms-开始的绑定属性与{{}}插值表达式,有的是用于渲染样式,
有的是用于绑定事件。在ms-duplexl中,我们会发现它会反过来操作vm,vm的改变也会影响视图的其他部分。
不过上面的代码并不完整,它能工作,是因为框架默认会在domready时扫描dom树,将视图中的绑定属性与{{}}插值表达式抽取出来,转换为求值函数与视图刷新函数。
上面的 代码相当于:
avalon.ready(function() {
avalon.define("box", function(vm) {
vm.w = 100;
vm.h = 100;
vm.click = function() {
vm.w = parseint(vm.w) + 10;
vm.h = parseint(vm.h) + 10;
avalon.scan()
avalon.scan是一个非常重要的 ,它有两个可选参数,第一个是扫描的起点元素,默认是html标签,第2个是vm对象。
avalon.scan = function(elem, vmodel) {
elem = elem || root
var vmodels = vmodel ? [].concat(vmodel) : []
scantag(elem, vmodels)
我们是通过avalon.define函数返回一个视图对象vm,并且avalon.define(vmname, function(vm){})中的vm并不等于vm,工厂函数中的vm是用于转换为vm的。生成的vm比用户指定的属性还多了许多属性。
默认的,除了函数外,其他东西都转换为监控属性,计算属性与监控数组。如果不想让它转换,可以让此属性以 $开头,框架就不会转换它们。
    如果实在不方便改名,又不想被转换,比如是一个 对象或一个dom节点,如果转换,肯定拖死框架,我们可以放到vm.$skiparray = [propname1, propname2]中去,这样也忽略转换。视图里面,我们可以使用ms-controller, ms-important指定一个vm的作用域。此外,在ms-each, ms-with中,它们会创建一个临时的vm,用于放置$key, $val, $index, $last, $first,
$remove等变量或 。
另外,avalon不允许在vm定义之后,再追加新属性与 ,比如下面的方式是错误的:
var vm = avalon.define("test", function(vm) {
vm.test1 = '点击测试按钮没反应 绑定失败';
vm.one = function() {
vm.test1 = '绑定成功';
//这里有两个错误,
//1在命名上没有区分avalon.define的返回值与它回调中的参数,
//2one 的定义位置不对(这是考虑到兼容ie6-8,要求所有浏览器保持行为一致)
此外,不要在avalon.define 里面执行函数或 ,因此框架会对define执行了两次,第1次用于取得用户对vm对象(factory的传参)的设置,第2次用于重置里面的vm对象为真正的vm。看源码:
avalon.define = function(name, factory) {
if (typeof name !== "string") {
avalon.error("必须指定id")
if (typeof factory !== "function") {
avalon.error("factory必须是函数")
var scope = {
$watch: noop
factory(scope) //得到所有定义
var model = modelfactory(scope) //偷天换日,将scope换为model
stoprepeatassign = true
factory(model)
stoprepeatassign = false
model.$id = name
return vmodels[name] = model
因此下面的写法会执行两次alert
function check(){ alert("!!!!!!!!!!!")}
var model = avalon.define("xxx", function(vm){
check()//这个 不应该写在这里,请放在avalon.define外面
vm.array = [1,2,3]
如果vm中的某函数是作为事件回调而存在,如ms-click=aaa, aaa的vm请替换为avalon.define返回的变量,确保能正确运行。
var model = avalon.define("xxx", function(vm){
vm.percent = 10
vm.aaa = function(){
model.percent ++;
所有定义好的vm都会储放在avalon.vmodels中!
我们再看看如何更新vm中的属性(重点):
var model = avalon.define("update", function(vm) {
vm.aaa = "str"
vm.bbb = false
vm.ccc = 1223
vm.time = new date
vm.simplearray = [1, 2, 3, 4]
vm.objectarray = [{name: "a"}, {name: "b"}, {name: "c"}, {name: "d"}]
vm.object = {
vm.simplearray = [1, 2, 3, 4]
vm.objectarray = [{name: "a", value: "aa"}, {name: "b", value: "bb"}, {name: "c", value: "cc"}, {name: "d", value: "dd"}]
vm.object = {
settimeout(function() {
//如果是更新简单数据类型(string, boolean, number)或date类型
model.aaa = "这是字符串"
model.bbb = true
model.ccc =
var date = new date
model.time = new date(date.setfullyear(2005))
settimeout(function() {
//如果是数组,注此文来自: 马开东博客
转载请注明出处 网址:
意保证它们的元素的类型是一致的
//只能全是字符串,或是全是布尔,不能有一些是这种类型,另一些是其他类型
//这时我们可以使用set 来更新(它有两个参数,第一个是index,第2个是新值)
model.simplearray.set(0, 1000)
model.simplearray.set(2, 3000)
model.objectarray.set(0, {name: "xxxxxxxxxxxxxxxx", value: "xxx"})
settimeout(function() {
model.objectarray[1].name = "5555"
settimeout(function() {
//如果要更新对象,直接赋给它一个对象,注意不能将一个vm赋给它,可以到vm的$model赋给它(要不会在ie6-8中报错)
model.object = {
aaaa: "aaaa",
bbbb: "bbbb",
cccc: "cccc",
dddd: "dddd"
&div ms-controller="update"&
&div&{{aaa}}&/div&
&div&{{bbb}}&/div&
&div&{{ccc}}&/div&
&div&{{time | date("yyyy - mm - dd mm:ss")}}&/div&
&ul ms-each="simplearray"&
&li&{{el}}&/li&
&select ms-each="objectarray"&
&option ms-value="el.value"&{{el.name}}&/option&
&ol ms-with="object"&
&li&{{$key}}
{{$val}}&/li&
这里还有个例子,大家认真看看。
当我们要用ajax与后端交互时,如果直接把vm传上去太大了,这时我们需要把它对应的纯数组的 对象。在vm中有个叫$model的属性,这是一个对象,就是数据模型m了。当我们更改vm时,框架就会自动同步m
绑定属性与动态模板
在开始之前,我们看一下静态模板是怎么工作的:
我之前写了一个叫e 的静态模板引擎:
&script type="tmpl" id="table_tmpl"&
&&= title() &&
&table border=1&
&&- for(var i=0,tl = @trs.length,i&i++){
&&- tr = @trs[i]; -&&
&td&&&= tr.; &&&/td& &td&&&= tr. &&&/td& &td&&&= tr.sex || "男" &&&/td&
&&# 怎么可能不支持图片 &&
&img src="&&= @href &&"&
它是以一个script标签做容器,里面的整个叫模板。模板里面有许多以 && 与 &&划分出来的区块,用于插入 代码,以@开头的变量是对应于数据包中的某个属性。
几乎所有静态模板的实现原理都是一样的,将这个模板变成一个函数,然后里面分成静态部分与动态部分,静态部分就是上面的htnml部分,转换为一个个字符串,动态部分就是插入的 代码,
它们基本上原封不动地成为的逻辑。然后我们传入一个对象给这个函数,最后得到一个符合html格式的字符串,最后用它贴到页面上某个位置就行了。
静态模板有几个缺点,首先它容易混入大量的 逻辑,对于菜鸟来说,他们特别喜欢在里面放入越来越多 代码。这个在 p年代,已经证明是bad practice。为此出现了logic-less的 mustache。
其次,它更新视图总是一大片一大片地处理,改动太大。最后,是由于第2点引发的问题,它对事件绑定等不友好,因为一更新,原来的节点都被消灭了,需要重新绑定。幸好, 普及了事件代理,这问题才没有
暴露出来。
再次,字符串模块没有对样式的操作,流程的操作进行封装,没有计算属性,监控数组的东西,很容易诱导用户在页面上写大量业务逻辑,导致代码无法维护。
下面就是一个php+原生 +jq的例子:
再看动态模板,几乎所有mvvm框架都用动态模板(当然也有例外,如ember )。动态模板以整个dom树为容器,它通过扫描方式进行第一次更新视图。
在静态模板,通过&& 与 &&划分的部分,转换为绑定属性与{{}}插值表达式(这是一种文本绑定,在avalon中,我们可以通过|html过滤器,转换html绑定)
这样就有效阻止用户在页面上写逻辑。虽然动态模板也支持ms-if, ms-each等表示逻辑关系的绑定,但它的值最复杂也只能是一个表达式。
在绑定属性中,属性名用于指定操作行为,如切换类名,控制显示,循环渲染,绑定事件,数据填充什么的,而属性值是决定这些操作是否执行,与渲染结果。
由于双向绑定的关系,它不像静态模板那样,每次都要自己将数据包放进函数,得到结果,然后innerhtml刷新某个区域。它是在用户为vm的某个属性进行重新赋值,将视图中对应的某个文本节点,
特性节点或元素节点的值进行重刷。因此不会影响事件绑定。
在avalon中,这些视图刷新函数都有个element属性,保持对应的元素节点,每次同步时,都会检测此元素节点是否在dom树,不在dom树就取消订阅此刷新函数,节约内存,防止无效操作。
因此,你们可以看区别了吧。绑定属性与插值表达式就是对应静态模板中的 逻辑部分,由于只允许为表达式或单个属性值,复杂度被控制了,强制用户将它们转移到vm中。
vm作为一个数据源,对应静态模板的数据包,并且多了一个自动触发功能,进化成一个消息中心。
&p ms-controller="test" ms-click="click"&{{ a }}&/p&
avalon.define("test", function(vm) {
vm.a = '123';
vm.click = function() {
vm.a = new date - 0
作用域绑定(ms-controller, ms-important)
avalon提供ms-controller, ms-important来指定vm在视图的作用范围。其他ms-*绑定属性或{{}}插值表达式,必须置于它们的作用域范围才能生效。比如有两个vm,它们都有一个firstname属性,在div中,如果我们用
ms-controller="vm1", 那么对于div里面的{{firstname}}就会解析成vm1的firstname中的值。
注意,avalon每扫描一个元素时,会移除对应的绑定属性或同名类名。这个特性非常有用,假如我们在页面使用了大量{{}}插值表达式,网速慢时,就会被用户看到,认为是乱码了。为了预防这种情况, 我们可以在样式中定义.ms-controller, [ms-controller]{ display:none},那么当元素被扫描后,它们才会安全显示出来。
有关它们的详细用法,可见这里。
模板绑定(ms-include)
如果单是把dom树作为一个模板远远不够的,比如有几个地方,需要重复利用一套html结构,这就要用到内部模板或外部模板了。
内部模板是,这个模板与目标节点是位于同一个dom树中。我们用一个mime不明的script标签或者noscript标签(0.94后支持,建议使用它)保存它,然后通过ms-include="id"引用它。
&meta http-equiv="content-type" content="text/ charset=utf-8" /&
&script src="avalon. "&&/script&
avalon.define("test", function(vm) {
vm.xxx = "引入内部模板"
&script type="avalon" id="tpl"&
here, {{ 3 + 6 * 5
&div ms-controller="test"&
&p&{{xxx}}&/p&
&div ms-include="'tpl'"&&/div&
注意,ms-include的值要用引号括起,表示这只是一个字符串,这时它就会搜索页面的具有此id的节点,取其innerhtml,放进ms-include所在的元素内部。否则这个tpl会被当成一个变量,
框架就会在vm中检测有没有此属性,有就取其值,重复上面的步骤。如果成功,页面会出现here, 2的字样。
如果大家想在模板加载后,加工一下模板,可以使用data-include-loaded来指定回调的名字。
如果大家想在模板扫描后,隐藏loading什么的,可以使用data-include-rendered来指定回调的名字。
下面是它们的实现
var vmodels = data.vmodels
var rendered = getbindingcallback(elem.getattribute("data-include-rendered"), vmodels)
var loaded = getbindingcallback(elem.getattribute("data-include-loaded"), vmodels)
function scantemplate(text) {
if (loaded) {
text = loaded.apply(elem, [text].concat(vmodels))
avalon.innerhtml(elem, text)
scannodes(elem, vmodels)
rendered && checkscan(elem, function() {
rendered.call(elem)
外部模板,通常用于多个页面的复用,因此需要整成一个独立的文件。这时我们就需要通过ms-include-src="src"进行加载。
比如有一个html文件tmpl.html,它的内容为:
&div&这是一个独立的页面&/div&
&div&它是通过ajax的get请求加载下来的&/div&
然后我们这样引入它
ms-include-src="'tmpl.html'"&&/div&
有关它的高级的例子可见这里利用ms-include与监控数组实现一个树
注意,ms-include-src需要后端支持,因为用到同域的ajax请求。
数据填充(ms-text, ms-html)
这分两种:文本绑定与html绑定,每种都有两个实现方式
avalon.define("test", function(vm) {
vm.text = "&b& 1111
&div ms-controller="test"&
&div&&em&用于测试是否被测除&/em&xxxx{{text}}yyyy&/div&
&div&&em&用于测试是否被测除&/em&xxxx{{text|html}}yyyy&/div&
&div ms-text="text"&&em&用于测试是否被测除&/em&xxxx yyyy&/div&
&div ms-html="text"&&em&用于测试是否被测除&/em&xxxx yyyy&/div&
默认情况下,我们是使用{{
}} 进行插值,如果有特殊需求,我们还可以配置它们:
avalon.config({
interpolate:[""]
注意,大家不要用&, & 作为插值表达式的界定符,因为在ie6-9里可能转换为注释节点,详见这里
类名切换(ms-class, ms-hover, ms-active)
avalon提供了多种方式来绑定类名,有ms-class, ms-hover, ms-active, 具体可看这里
事件绑定(ms-on)
avalon通过ms-on-click或ms-click进行事件绑定,并在ie对事件对象进行修复,具体可看这里
avalon并没有像 设计一个近九百行的事件,连事件回调的执行顺序都进行修复(ie6-8,attachevent添加的回调在执行时并没有按先入先出的顺序执行),只是很薄的一层封装,因此性能很强。
ms-dblclick
ms-mouseout
ms-mouseover
ms-mousemove
ms-mouseenter
ms-mouseleave
ms-mouseup
ms-mousedown
ms-keypress
ms-keydown
ms-animation
&!doctype html&
&meta charset="utf-8"&
&title&有关事件回调传参&/title&
&script src="avalon. " type="text/javascript"&&/script&
avalon.ready(function() {
var a = avalon.define("simple", function(vm) {
vm.firstname = "司徒"
vm.lastname = "正美"
vm.array = ["aaa", "bbb", "ccc"]
vm.argsclick = function(e, a, b) {
alert(a+ "
vm.loopclick = function(a) {
avalon.scan();
&fieldset ms-controller="simple"&
&legend&例子&/legend&
&div ms-click="argsclick($event, 100, firstname)"&点我&/div&
&div ms-each-el="array" &
&p ms-click="loopclick(el)"&{{el}}&/p&
&/fieldset&
另外,这里有一些结合ms-data实现事件代理的技巧,建议事件绑定接口支持事件代理,最简单就是table上可以绑定td的点击事件
显示绑定(ms-visible)
avalon通过ms-visible="bool"实此文来自: 马开东博客
转载请注明出处 网址:
现对某个元素显示隐藏控制,它用是style.display="none"进行隐藏。
插入绑定(ms-if)
这个功能是抄自knockout的,ms-if="bool",同样隐藏,但它是将元素移出dom。这个功能直接影响到css :empty伪类的渲染结果,因此比较有用。
&!doctype html&
&meta http-equiv="content-type" content="text/ charset=utf-8" /&
&title&ms-if&/title&
&script t src="avalon. "&&/script&
&body ms-controller="test"&
&ul ms-each-item="array"&
&li ms-click="$remove" ms-if="$index % 2 == 0"&{{ item }} --- {{$index}}&/li&
&script type="text/javascript"&
avalon.define('test', function(vm) {
vm.array = "a,b,c,d,e,f,g".split(",")
这里得介绍一下avalon的扫描顺序,因为一个元素可能会存在多个属性。总的流程是这样的:
ms-skip --& ms-important --& ms-controller --& ms-if -->
ms-repeat --& ms-if-loop --& ...--&ms-each --& ms-with --& ms-duplex
首先跑在最前面的是 ms-skip,只要元素定义了这个属性,无论它的值是什么,它都不会扫描其他属性及它的子孙节点了。然后是 ms-important, ms-controller这两个用于圈定vm的作用域的绑定属性,它们的值为vm的$id,它们不会影响avalon继续扫描。接着是ms-if,由于一个页面可能被当成子模块,被不同的vm所作用,那么就会出现有的vm没有某个属性的情况。比如下面的情况:
&!doctype html&
&meta http-equiv="content-type" content="text/ charset=utf-8" /&
&title&ms-if&/title&
src="avalon. "&&/script&
&body ms-controller="test"&
&h1&{{aaa}}&/h1&
&ul ms-if="array" ms-each-item="array"&
&li ms-click="$remove" ms-if="$index % 2 == 0"&{{ item }} --- {{index}}&/li&
&script type="text/javascript"&
avalon.define('test', function(vm) {
vm.aaa = "array不存在啊"
如果没有ms-if做代码防御,肯定报一大堆错。
接着是 ms-repeat绑定。出于某些原因,我们不想显示数组中的某些元素,就需要让ms-if拖延到它们之后才起作用,这时就要用到ms-if-loop。
&!doctype html&
&meta http-equiv="content-type" content="text/ charset=utf-8" /&
&title&ms-if&/title&
src="avalon. "&&/script&
&body ms-controller="test"&
&h1&{{aaa}}&/h1&
&li ms-repeat="array" ms-if-loop="el"&{{ el }}&/li&
&li&它总在最后&/li&
&script type="text/javascript"&
avalon.define('test', function(vm) {
vm.array = ["aaa", "bbb", null, "ccc"]
之后就是其他绑定,但殿后的总是ms-duplex。从ms-if-loop到ms-duplex之间的执行顺序是按这些绑定属性的首字母的小写的ascii码进行排序,比如同时存在ms-attr与ms-visible绑定,那么先执行ms-attr绑定。如果我们想绑定多个类名,用到ms-class, ms-class-2, ms-class-3, ms-class-1,那么执行顺序为ms-class, ms-class-1, ms-class-2, ms-class-3。如果我们要用到绑定多个点击事件,需要这样绑定:ms-click, ms-click-1, ms-click-2……更具体可以查看源码中的scantag, scanattr 。
双工绑定(ms-duplex)
这功能抄自angular,原名ms-model起不得太好,姑且认为利用vm中的某些属性对表单元素进行双向绑定。
这个绑定,它除了负责将vm中对应的值放到表单元素的value中,还对元素偷偷绑定一些事件,用于监听用户的输入从而自动刷新vm。具体如下:
ms-duplex="prop"
当元素为text, pass , textarea时,要求prop为一个字符串,当我们改动它的内容时,avalon就会将此元素的value值赋给prop(在默认情况下,是使用input事件进行绑定,即每改动一个字符,都会进行同步,大家也可以指定data-duplex-event="change",改用change事件进行绑定)
当元素为radio时,要求prop为一个布尔, 当我们改动它的内容时,avalon就会将此元素的checked值(布尔)赋给prop
当元素为checkbox时,要求prop为一个数组, 当我们改动它的内容时,avalon就会将此元素的value值push进prop
当元素为select时,要求prop为一个字符串或数组(视multiple的值), 当我们选中它的某一个项时,avalon就会将此option元素的value值或text值(没有value时)push进prop。
ms-duplex-text="prop"
只能用于radio,用于模拟text控件的行为, 要求prop为一个字符串,当我们选中某一个radio时,avalon就会将此元素的value值赋给prop 用于实现多选一
ms-duplex-radio="prop"
只能用于checkbox,用于模拟radio控件的行为, 要求prop为一个布尔,当我们选中某一个checkbox时,avalon就会将此元素的checked值(布尔)赋给prop 多用于实现grid中的全选/全不选功能
ms-duplex-bool="prop"
只能用于radio, 要求prop为一个布尔,并且元素的value为“true”或“false”,当我们选中某一个radio时,avalon就会将此元素的value转换为布尔,赋给对应的prop。
注意:ms-duplex与ms-checked不能在同时使用于一个元素节点上。
注意:如果表单元素同时绑定了ms-duplex=xxx与ms-click或ms-change,而事件回调要立即得到这个vm.xxx的值,input[type=radio]是存在问题,它不能立即得到当前值,而是之前的值,需要在回调里面加个settimeout。
ms-duplex-text, ms-duplex-radio与ms-duplex的用法,大家可以通过这个页面进行学习。
&!doctype html&
&title&ms-duplex&/title&
&meta http-equiv="content-type" content="text/ charset=utf-8"&
&div ms-controller="box"&
&li&&input type="checkbox" ms-click="checkall" ms-checked="checkallbool"/&全选&/li&
&li ms-repeat="arr" &&input type="checkbox" ms-value="el" ms-duplex="selected"/&{{el}}&/li&
&script src="avalon. " &&/script&
var model = avalon.define("box", function(vm) {
vm.arr = ["1", '2', "3", "4"]
vm.selected = ["2", "3"]
vm.checkallbool = vm.arr.length === vm.selected.length
vm.checkall = function() {
if (this.checked) {
vm.selected = vm.arr
vm.selected.clear()
model.selected.$watch("length", function(n) {
model.checkallbool = n === model.arr.size()
对于非radio, checkbox, select的控件,我们可以通过data-duplex-changed来指定一个回调,传参为元素的value值,this指向元素本身,要求必须有返回值。
&!doctype html&
&meta http-equiv="content-type" content="text/ charset=utf-8" /&
&title&data-duplex-changed&/title&
&script src="avalon. "&&/script&
&body ms-controller="duplex"&
&input ms-duplex="username" data-duplex-changed="callback"&
&script type="text/javascript"&
avalon.define('duplex', function(vm) {
vm.username = "司徒正美"
vm.callback = function(val){
avalon.log(val)
avalon.log(this)
return this.value = val.slice(0, 10)//不能超过10个字符串
样式绑定(ms-css)
用法为ms-css-name="value"
&div ms-css-width="aaa"&&/div&
数据绑定(ms-data)
用法为ms-data-name="value", 用于为元素节点绑定html5 data-*属性。
布尔属性绑定
这主要涉及到表单元素几个非常重要的布尔属性,即disabed, readyonly, selected , checked,
分别使用ms-disabled, ms-enabled, ms-readonly, ms-checked, ms-selected。ms-disabled与ms-enabled是对立的,一个true为添加属性,另一个true为移除属性。
字符串属性绑定
这主要涉及到几个非常常用的字符串属性,即href, src, alt, title, value,
分别使用ms-href, ms-src, ms-alt, ms-title, ms-value。它们的值的解析情况与其他绑定不一样,如果值没有{{}}插值表达式,那么就当成vm中的一个属性,并且可以与加号,减号混用,
组成表达式,如果里面有表达式,整个当成一个字符串。
&a ms-href="aaa + '.html'"&xxxx&/a&
&a ms-href="{{aaa}}.html"&xxxx&/a&
属性绑定(ms-attr)
ms-attr-name="value",这个允许我们在元素上绑定更多种类的属性,如classname, tabindex, name, colspan什么的。
数组循环绑定(ms-each)
用法为ms-each-xxx="array", 其中xxx可以随意改,如item, el, 它是用于在子元素中进行引用。array对应vm中的一个普通数组或一个监控数组。监控数组拥有原生数组的所有 ,并且比了set, remove, removeat, removeall, ensure与 clear
。详见这里。
ms-each与ms-repeat的不同之处在于,前者循环它的孩子,后者循环它自身。
注意,ms-each, ms-repeat会生成一个新的代理vm对象放进当前的vmodels的前面,这个代理对象拥有el, $index, $first, $last, $remove, $outer, $itemname等属性。另一个会产生vm对象的绑定是ms-widget。
el: 不一定叫这个名字,比如说ms-each-item,它就变成item了。默认为el。指向当前元素。
$first: 判定是否为监控数组的第一个元素
$last: 判定是否为监控数组的最后一个元素
$index: 得到当前元素的索引值
$outer: 得到外围循环的那个元素。
$itemname: 保存el(或item, elem)这个名字。
$remove:这是一个 ,用于移除此元素
我们还可以通过data-each-rendered, data-repeat-rendered来指定这些元素都插入dom被渲染了后执行的回调,this指向元素节点,有一个参数表示为当前的操作,是add, del, move, index还是clear
&!doctype html&
&title&&/title&
&meta http-equiv="content-type" content="text/ charset=utf-8"&
&script src="avalon. "&&/script&
.id2013716 {
width: 200
var a = avalon.define("array", function(vm) {
vm.array = ["1", "2", "3", "4"]
settimeout(function() {
a.array.set(0, 7)
var b = avalon.define("complex", function(vm) {
vm.array = [{name: "xxx", sex: "aaa", c: {number: 2}}, {name: "yyy", sex: "bbb", c: {number: 4}}]//
settimeout(function() {
b.array[0].c.number = 9
b.array[0].name = "1000"
settimeout(function() {
a.array.push(5, 6, 7, 8, 9)
settimeout(function() {
a.array.unshift("a", "b", "c", "d")
settimeout(function() {
a.array.shift()
b.array[1].name = 7
settimeout(function() {
a.array.pop()
settimeout(function() {
a.array.splice(1, 3, "x", "y", "z")
b.array[1].name = "5000"
&fieldset class="id2013716" ms-controller="array"&
&legend&例子&/legend&
&ul ms-each-el="array"&
&li&数组的第{{$index+1}}个元素为{{el}}&/li&
&p&size: &b style="color:red"&{{array.size()}}&/b&&/p&
&/fieldset&
class="id2013716" ms-controller="complex"&
&legend&例子&/legend&
&ul ms-each-el="array"&
&li&{{el.name+" "+el.sex}}它的内容为 number:{{el.c.number}}&/li&
&/fieldset&
给ms-repeat绑定的数组赋值时,data-repeat-rendered的回调会执行很多很多次,但我们可以通过它的第一个传参进行识别
对象循环绑定(ms-with)
语法为 ms-with="obj" 子元素里面用$key, $val分别引用键名,键值。另我们可以通过指定data-with-sorted回调,规定只输出某一部分建值及它们的顺序。
&!doctype html&
&title&&/title&
&meta http-equiv="content-type" content="text/ charset=utf-8"&
&script type='text/javascript' src="avalon. "&&/script&
var a = avalon.define("xxx", function(vm) {
vm.obj = {
aaa: "xxx",
bbb: "yyy",
ccc: "zzz"
vm.first = "司徒正美"
settimeout(function() {
a.obj.aaa = ""
a.first = "清风火忌"
settimeout(function() {
a.obj.bbb = "8888888"
&body ms-controller="xxx"&
&div ms-with="obj"&
&div&{{$key}} {{$val}}&/div&
&div ms-with="obj"&
&div&{{$key}} {{$val}}&/div&
&div ms-with="obj"&
&div&{{$key}} {{$val}}&/div&
有关ms-each, ms-repeat, ms-with更高的用法,如双重循环什么的,可以看这里
循环绑定(ms-repeat)
ms-repeat是ms-each, ms-with的改良版,它只用一个元素就能循环数组与对象。你没有看错,它兼顾ms-each, ms-with的功能。当表达式得出的是数组,那么它就循环,生成的代理对象拥有$index, $first, $last, $remove等属性与 , 当表达式得出的是对象,那么它就循环对象,生成的代理对象拥有$key, $val属性。(此绑定许多功能抄住angular的ng-repeat)
&!doctype html&
&meta charset="utf-8"&
&title&&/title&
&body ms-controller="page"&
&h3&ms-each实现数组循环&/h3&
&div ms-each="arr"&
{{$index}} &button ms-click="$remove"&{{el}} 点我删除&/button&
&h3&ms-repeat实现数组循环&/h3&
&table border="1" width="800px" style="background:blueviolet"&
&td ms-repeat="arr"&
{{$first}} {{$last}}
&h3&ms-repeat实现数组循环&/h3&
&li ms-repeat="arr"&&button ms-click="$remove"&测试{{$index}}&/button&{{el}}&/li&
&h3&ms-repeat实现对象循环&/h3&
&li ms-repeat="object"&{{$key}}:{{$val}}&/li&
&h3&ms-with实现对象循环&/h3&
&ol ms-with="object"&
&li&{{$key}}:{{$val}}&/li&
&h3&通过指定data-with-sorted规定只输出某一部分建值及它们的顺序,只能循环对象时有效&/h3&
&ol ms-with="bigobject" data-with-sorted="order" title='with'&
&li&{{$key}}:{{$val}}&/li&
&ol title='repeat'&
&li ms-repeat="bigobject" data-with-sorted="order"&{{$key}}:{{$val}}&/li&
&h3&ms-repeat实现数组双重循环&/h3&
&table border="1" style="background:yellow" width="400px"&
&tr ms-repeat="dbarray"&&td ms-repeat-elem="el.array"&{{elem}}&/td&&/tr&
&h3&ms-each实现数组双重循环&/h3&
&table border="1" style="background:green" width="400px"&
ms-each="dbarray"&
&tr ms-each-elem="el.array"&&td&{{elem}}&/td&&/tr&
&h3&ms-with实现对象双重循环,并通过$outer访问外面的键名&/h3&
&div ms-repeat="dbobjec"&{{$key}}:&strong ms-repeat="$val"&{{$key}}&{{$val}} &span style="font-weight: normal"&{{$outer.$key}}&/span&|&&/strong&&/div&
&script src="avalon. "&&/script&
var model = avalon.define('page', function(vm) {
vm.arr = ["a", "b", "c", "d", "e", "f", "g", "h"]
vm.object = {
"kkk": "vvv", "kkk2": "vvv2", "kkk3": "vvv3"
vm.aaa = {
aaa2: "vvv2",
aaa21: "vvv21",
aaa22: "vvv22"
vm.bigobject = {
title: 'xxx',
name: '777',
width: 30,
align: 'center',
sortable: true,
cols: "cols3",
url: 'data/stockquote. on',
method: 'get',
remotesort: true,
sortname: 'secucode',
sortstatus: 'asc'
vm.order = function() {
return ["name", "sortstatus", "sortname", "method", "align"]
vm.dbobjec = {
aaa2: "vvv2",
aaa21: "vvv21",
aaa22: "vvv22"
bbb2: "ccc2",
bbb21: "ccc21",
bbb22: "ccc22"
vm.dbarray = [
array: ["a", "b", "c"]
array: ["e", "f", "d"]
settimeout(function() {
model.object = {
model.bigobject = {
title: 'yyy',
method: 'post',
name: '999',
width: 78,
align: 'left',
sortable: false,
cols: "cols5",
url: 'data/xxx. on',
remotesort: false,
sortname: 'failure',
sortstatus: 'bbb'
ui绑定(ms-widget)
它的格式为ms-widget="uiname, id?, optsname?"
uiname,必选,一定要全部字母小写,表示组件的类型
id 可选 这表示新生成的vm的$id,方便我们从avalon.vmodels[id]中获取它操作它,如果它等于$,那么表示它是随机生成,与不写这个效果一样,框架会在uiname加上时间截,生成随机id
optname 可选, 配置对象的名字。指在已有的vm中定义一个对象(最好指定它为不可监控的外),作为配置的一部分(因为每个ui都有它的默认配置对象,并且我们也可以用data- uiname? -xxx来做更个性化的处理 )。如果不指optname默认与uiname同名。框架总是找离它(定义ms-widget的那个元素节点)最近的那个vm来取这个配置项。如果这个配置项里面有widget+"id"这个属性,那么新生成的vm就是用它作为它的$id
下面是一个完整的实例用于教导你如何定义使用一个ui。
首先,以amd规范定义一个模块,文件名为avalon.testui. ,把它放到与avalon. 同一目录下。内容为:
define(["avalon"], function(avalon) {
必须 在avalon.ui上注册一个函数,它有三个参数,分别为容器元素,data, vmodels
avalon.ui["testui"] = function(element, data, vmodels) {
//将它内部作为模板,或者使用文档碎片进行处理,那么你就需要用appendchild 添加回去
var innerhtml = element.innerhtml
//由于innerhtml要依赖许多widget后来添加的新属性,这时如果被扫描肯定报“不存在”错误
//因此先将它清空
avalon.clearhtml(element)
var model = avalon.define(data.testuiid, function(vm) {
avalon.mix(vm, data.testuioptions)//优先添加用户的配置,防止它覆盖掉widget的一些 与属性
vm.value = 0; // 给input一个个默认的数值
vm.plus = function(e) { // 只添加了这个plus
model.value++;
avalon.nexttick(function() {
//widget的vm已经生成,可以添加回去让它被扫描
element.innerhtml = innerhtml
avalon.scan(element, [model].concat(vmodels))
return model//必须返回新vm
avalon.ui["testui"].defaults = {
aaa: "aaa",
bbb: "bbb",
ccc: "ccc"
return avalon//必须返回avalon
然后页面这样使用它
&!doctype html&
&meta charset="utf-8"/&
&script src="avalon. "&&/script&
require("avalon.testui", function() {
avalon.define("test", function(vm) {
vm.$opts = {
name: "这是控件的内容"
avalon.scan()
&div ms-controller="test" ms-widget="testui,ddd,$opts" &
&input ms-duplex="value" /&
&button type="button" ms-click="plus"&clickme&/button&
这是一个位于vm的 ,用于监听vm的某人属性的变化,回调中有两个传参,新属性值与旧属性值,里面的this指向vm,详见这里。
avalon从angular中抄来管道符风格的过滤器,但有点不一样。
它只能用于{{}}插值表达式。如果不存在参数,要求直接跟|filter,如果存在参传,则要用小括号括起,参数要有逗号,这与一般的函数调用差不多,如|truncate(20,"……")
avalon自带以下几个过滤器
没有传参,用于将文本绑定转换为html绑定
对长字符串进行截短,truncate(number, truncation), number默认为30,truncation为“...”
驼峰化处理
对类似于html格式的字符串进行转义,把尖括号转换为& &
对数字添加货币符号,以及千位符, currency(symbol)
对数字进行各种格式化,这与与php的number_format完全兼容, number(decimals, dec_point, thousands_sep),
decimals 可选,规定多少个小数位。
dec_point 可选,规定用作小数点的字符串(默认为 . )。
thousands_sep 可选,规定用作千位分隔符的字符串(默认为 , ),如果设置了该参数,那么所有其他参数都是必需的。
对日期进行格式化,date(formats)
'yyyy': 4 digit representation of year (e.g. ad 1 => 0001, ad 2010 => 2010)
'yy': 2 digit representation of year, padded (00-99). (e.g. ad 2001 => 01, ad 2010 => 10)
'y': 1 digit representation of year, e.g. (ad 1 => 1, ad 199 => 199)
'mmmm': month in year (january-december)
'mmm': month in year (jan-dec)
'mm': month in year, padded (01-12)
'm': month in year (1-12)
'dd': day in month, padded (01-31)
'd': day in month (1-31)
'eeee': day in week,(sunday-saturday)
'eee': day in week, (sun-sat)
'hh': hour in day, padded (00-23)
'h': hour in day (0-23)
'hh': hour in am/pm, padded (01-12)
'h': hour in am/pm, (1-12)
'mm': minute in hour, padded (00-59)
'm': minute in hour (0-59)
'ss': second in minute, padded (00-59)
's': second in minute (0-59)
'a': am/pm marker
'z': 4 digit (+sign) representation of the timezone offset (-)
format string can also be one of the following predefined localizable formats:
'medium': equivalent to 'mmm d, y h:mm:ss a' for en_us locale (e.g. sep 3, :08 pm)
'short': equivalent to 'm/d/yy h:mm a' for en_us locale (e.g. 9/3/10 12:05 pm)
'fulldate': equivalent to 'eeee, mmmm d,y' for en_us locale (e.g. friday, september 3, 2010)
'longdate': equivalent to 'mmmm d, y' for en_us locale (e.g. september 3, 2010
'mediumdate': equivalent to 'mmm d, y' for en_us locale (e.g. sep 3, 2010)
'shortdate': equivalent to 'm/d/yy' for en_us locale (e.g. 9/3/10)
'mediumtime': equivalent to 'h:mm:ss a' for en_us locale (e.g. 12:05:08 pm)
'shorttime': equivalent to 'h:mm a' for en_us locale (e.g. 12:05 pm)
生成于{{ new date | date("yyyy mm dd:hh:mm:ss")}}
生成于{{ "" | date("yyyy mm dd:hh:mm:ss")}}
生成于{{ "" | date("yyyy mm dd:hh:mm:ss")}}
生成于{{ "01-01-2000" | date("yyyy mm dd:hh:mm:ss")}}
生成于{{ "03 04,2000" | date("yyyy mm dd:hh:mm:ss")}}
生成于{{ "3 4,2000" | date("yyyy mm dd:hh:mm:ss")}}
生成于{{ 9 | date("yyyy mm dd:hh:mm:ss")}}
生成于{{ "9" | date("yyyy mm dd:hh:mm:ss")}}
值得注意的是,new date可传的格式类型非常多,但不是所有浏览器都支持这么多,详看这里
多个过滤器一起工作
&div&{{ prop | filter1 | filter2 | filter3(args, args2) | filter4(args)}}&/div&
如果想自定义过滤器,可以这样做
avalon.filters.myfilter = function(str, args, args2){//str为管道符之前计算得到的结果,默认框架会帮你传入,此 必须返回一个值
/* 具体逻辑 */
amd 加载器
avalon装备了amd模范的加载器,这涉及到两个全局
require与define
require(deps, callback)
deps 必需。string|array。依赖列表,可以是具体路径或模块标识,如果想用字符串表示多个模块,则请用“,”隔开它们。
必需。function。回调,当用户指定的依赖以及这些依赖的依赖树都加载执行完毕后,才会安全执行它。
一个模块标识就是一个字符串,通过它们来转换成到对应 文件或css文件的路径。
有关模块标识的common 规范,可以见
具体约定如下:
每个模块标识的字符串组成只能是合法url路径,因此只能是英文字母,数字,点号,斜扛,#号。
如果模块标识是
以"./"开头,则表示相对于它的父模块的目录中找。
如果模块标识是
以"../"开头,则表示相对于它的父模块的父目录中找。
如果模块标识不以点号或斜扛开始,则有以下三种情况
如果此模块标识在
$.config.alias存在对应值,换言之某一模块定义了一个别名,则用此模块的具体路径加载文件。
如果此模块标识
以http://、https://、file:/// 等协议开头的绝对路径,直接用它加载文件。
否则我们将在引入框架种子模块(avalon. )的目录下寻找是否有同名 文件,然后指向它。
对于 模块,它可以省略后缀名,即“. ”可有可无;但对于css需要使用css!插件机制。
框架种子模块的目录保存于
$.config.base属性中。
ready!是占位符,用于表示dom树是否加载完毕,不会进行路径转换。
如果想禁止使用avalon自带的加载器,可以在第一次调用require 之前,执行如下代码:
&!doctype html&
&meta http-equiv="content-type" content="text/ charset=utf-8"&
&script src="require. "&&/script&
&script src="avalon.mobile. "&&/script&
avalon.config({loader: false})
alert(require)
avalon.define("xxx", function(vm){
vm.aaa = "司徒正美"
&body ms-controller="xxx" &
&div&{{aaa}}&/div&
与 更好的集成,比如一些旧,直接在页面引入 库与其大量 插件,改成动态加载方式成本非常大。怎么样才能与 和平共存,亦能让amd加载发挥作呢?先引入 库,
然后将avalon.modules.
加个预设值(exports:
用于shim机制, state: 2 表明它已经加载完毕)就行了。
&!doctype html&
&title&&/title&
&meta http-equiv="content-type" content="text/ charset=utf-8"&
&script src=" . " type="text/javascript"&&/script&
&script src="avalon. " type="text/javascript"&&/script&
&div ms-controller="main" ms-click="click"&
&a href="#" &点击我&/a&
&script type="text/javascript"&
avalon.modules.
require(' ,ready!', function($) {
avalon.log('加载jq了啊……')
$.ajaxsetup({
headers: {ajaxrequest: true},
beforesend: function(o) {
avalon.log(typeof o)
avalon.log(typeof o.id)
complete: function(data) {
avalon.log('ajax 成功执行啦,阿门!')
$('body').bind("click", function(e) {
alert("document");
avalon.log(typeof e.target.$vmodel)
$.post('./h. ', {}, function(res) {
avalon.log(typeof res)
&!doctype html&
&title&&/title&
&meta http-equiv="content-type" content="text/ charset=utf-8"&
&!--&这里没有东西&/--&
&script src="avalon. " type="text/javascript"&&/script&
&div ms-controller="main" ms-click="click"&
&a href="#" &点击我&/a&
&script type="text/javascript"&
/* 0.982之前可以
avalon.config({
exports: " ",//这是原来 库的,必须写上
src: " . "
//下面是兼容require 的 ,推荐使用这个
avalon.config({
: "/ajax/libs/ /1.9.1/ .min. "
exports: " "//这是原来 库的,必须写上
require(' ,ready!', function($) {
avalon.log('加载jq了啊……')
$.ajaxsetup({
headers: {ajaxrequest: true},
beforesend: function(o) {
avalon.log(typeof o)
avalon.log(typeof o.id)
complete: function(data) {
avalon.log('ajax 成功执行啦,阿门!')
$('body').bind("click", function(e) {
alert("document");
avalon.log(typeof e.target.$vmodel)
$.post('./h. ', {}, function(res) {
avalon.log(typeof res)
加载单个模块。
// 由于lang. 与mass. 是位于同一目录下,可以省略./
require("lang", function(lang) {
alert(lang.string.touppercase("aa"))
加载多个模块。需要注意的是,涉及dom操作时必须要待到dom树建完才能进入,因此我们在这里指定了一个标识,叫"ready!", 它并不一个模块,用户自定义模块,也不要起名叫"ready!"。
require(" ,node,attr,ready!", function($) {
alert($.fn.attr + "");
alert($.fn.prop + "");
加载多个模块,使用字符串数组形式的依赖列表。
require([" ", "css", "ready!"], function($, css) {
$("# _require_ex3").toggle();
加载css文件。
require([" ", "ready!", "css!http//sdfds.xdfs.css"], function($) {
$("# _require_ex3").toggle();
使用别名机制管理模块的链接。
var path = location.protocol + "//" + location.host + "/doc/scripts/loadtest/"
/* 0.982之前可以
require.config({
"aaa": path + "aaa. ",
"bbb": path + "bbb. ",
"ccc": path + "ccc. ",
"ddd": path + "ddd. "
//下面是兼容require 的 ,推荐使用这个
require.config({
"aaa": path + "aaa. ",
"bbb": path + "bbb. ",
"ccc": path + "ccc. ",
"ddd": path + "ddd. "
require("aaa,bbb,ready", function(a, b, $) {
var parent = $("#loadasync2")
parent.append(a);
parent.append(b);
$("#asynctest2").click(function() {
require("ccc,ddd", function(c, d) {
parent.append(c);
parent.append(d);
加载不按规范编写的 文件,可以让你不用改 的源码就加载它。相当于其他加载器的shim插件。
与别名机制不同的是,现在它对应一个对象,src为完整路径,deps为依赖列表,exports为其他模块引用它时,传送给它们的参数
!function() {
var path = "http://files./shuicaituya/"
require.config({
path + " . "
deps: [], //没有依赖可以不写
exports: " "
require(" ", function($) {
alert("回调调起成功");
如果你想用其他amd加载器,最好的办法还是建议直接打开源码,拉到最底几行,把加载器禁用了!
avalon.config({
loader: false//原来是true!!!!!!!!!!1
define 用于定义一个模块,格式为:
define( id?, deps?, factory )
可选。string。模块id。它最终会转换一个url,放于 $.modules中。
可选。string|array。依赖列表。
必需。function|object。模块工厂。它的参数列参为其依赖模块所有返回的值,如果某个模块没有返回值,则对应位置为undefined
注意, define 不能写在script标签的innerhtml中,只能写在 文件里。
加载不按规范编写的 文件,可以让你不用改 的源码就加载它。相当于其他加载器的shim插件。
与别名机制不同的是,现在它对应一个对象,src为完整路径,deps为依赖列表,exports为其他模块引用它时,传送给它们的参数
没有依赖不用改
define("aaa", function() {
没有依赖不用改
define("bbb", function() {
define("ccc", ["$aaa"], function(a) {
return 10 + a
//ddd/ddd.
define("ddd", ["$ddd"], function(c) {
return c + 100
avalon与sea , /rubylouvre/avalon/issues/313
它需要依赖于另一个独立的组件mmrouter,用法请见这里
ajax可以使用 或mmrequest, mmrequest体积更少,覆盖
ajax模块的90%功能,并且在现代浏览器中使用了xmlhttprequest2实现,性能更佳。
通过ajax加载新数据到已存在的vm中
var model = avalon.define("test", function(vm){
vm.ajaxdata = {} //这是一个占位符
vm.arraydata = [1,2,3,4]
type: "get",
url: "xxx",
success: function(data){
var newdata = fn(data) //fn是你自己定义一个 ,对data进行扁平化,最好变成一重的对象
//如果你的vm.ajaxdata如果是个空对象,可以直接赋值
model.ajaxdata = newdata
//如果它不是一个空对象,那么需要使用avalon.mix,先已有的数据,新的数据,全部拷贝到一个全新的空对象中,再赋值
newdata = avalon.mix({}, model.ajaxdata.$model, newdata )//这是关键,防止影响原来的$model
// model.ajaxdata = newdata
model.arraydata.push.apply(model.arraydata, data.newdata)//添加更多元素
model.arraydata =
data.newdata//直接替换
提交vm中的数据到后台,要小心死循环,详见这里
文件上传要用mmrequest的upload
avalon现在有三个扩展点,一是在avalon.fn上添加新的,这是用于处理dom的,二是在avalon.bindinghandlers与 avalon.bindingexecutors上添加新的绑定(ms-xxx),三是在avalon.filters添加新的过滤器。
添加就不用多说,建议尽可能返回this,实现链式操作,this[0]为它包含的元素节点。
添加过滤器也很简,翻看源码看看lowercase如何实现就行了。
添加新绑定难一点,框架bindinghandlers要求对应的处理函数有两个参数,data与vmodels, data拥有如下几个属性:
element: 绑定了ms-xxx的元素,如&div ms-xxx-yyy='zzz'&innerhtml&/div&,ms-xxx绑定所在的div元素。
value:是指mx-xxx绑定的这个特性节点的值,即上面的zzz。
param:是指mx-xxx绑定名以“-”分开几截,除了最前面的两部分外的东西,如这里的“yyy”。
vmodels是指,从dom树最顶点到添加此绑定的元素所路过的ms-controller的值(它们都对应一个vm)。注意,ms-each, ms-with也产生vm。
bindinghandlers里的函数用于初始化绑定,它会对绑定属性做一些分解,放进parseexprproxy中,parseexprproxy会再调用parseexpr,将它转换为求值函数,放进行对应vm属性的subscribers数组内(操作方为re tersubscriber)。
bindingexecutors里的的函数为真正的视图刷新函数,每当vm发生改变后,都会被执行(操作方为notifysubscribers)。
现在avalon拥有如此多绑定:
animationend
mouseenter
mouseleave
搜索此文相关文章:
入门教程此文来自: 马开东博客
网址: 站长QQ
迷你MVVM框架 avalonjs 入门教程_博客园相关文章
博客园_总排行榜
博客园_最新
博客园_月排行榜
博客园_周排行榜
博客园_日排行榜

我要回帖

更多关于 js 对象属性名是变量 的文章

 

随机推荐