Javascript代码可以运行在两种环境:客户端(浏览器),和服务端(服务器上的Node.js容器)。 在API 参考中,我们会指出每个函数是否可以在客户端,或是服务端,或是Anywhere(客户端和服务端)被调用。
**模板**
在Meteor中,视图定义在 模板 。模板就是包含动态数据的HTML代码段。你可以通过javascript给模板插入数据,或是监听模板事件。
**用HTML定义模板**
模板定义在.html文件中,可以放在项目任何位置,除了server,public,private文件夹
每个.html文件可以包含任意数量的顶级元素:`<head>,<body>`或是`<template>`。`<head>,<body>`标签里的代码会附加到HTML页面中对应的标签, `<tempalte>`标签里的代码可以用`{{> templateName}}`引入,如下面的例子所示。模板可以引入多次—模板的主要目的之一就是避免重复手写相同的HTML。
~~~
<!-- add code to the <head> of the page -->
<head>
<title>兄弟会!</title>
</head>
<!-- add code to the <body> of the page -->
<body>
<h1>Hello!</h1>
{{> xiongdihui}}
</body>
<!-- define a template called xiongdihui -->
<template name="xiongdihui">
<p>Welcome to 兄弟会!</p>
</template>
~~~
{{ ... }}是Spacebars语法,Meteor使用Spacebars给HTML增加功能。如上所示,利用它你可以引入模板。 使用Spacebars,你可以显示从 helpers 中获取的数据。Helpers 用javascript来写,既可以是简单值,也可以是函数。
给nametag模板定义一个叫做name的helper(在javascript里):
~~~
Template.nametag.helpers({
name: "Ben Bitdiddle"
});
~~~
nametag 模板本身 (在HTML里):
~~~
<!-- In an HTML file, display the value of the helper -->
<template name="nametag">
<p>My name is {{name}}.</p>
</template>
~~~
Spacebars还有几个方便使用的控制结构,可以使视图更加动态:
{{#each data}} ... {{/each}} - 循环data里的每一项,每一项都会显示一次#each块里的HTML。
{{#if data}} ... {{else}} ... {{/if}} - 如果data为true,显示第一个块,反之,显示第二个块。
{{#with data}} ... {{/with}} - 设置内部HTML的数据上下文,然后显示。
每一个嵌套的#each或#with块都有自己的 数据上下文 ,数据上下文是一个对象,它的属性在块内部可以用作helper。例如:#with块,它的数据上下文就是跟在它后面,}}之前的变量值。#each块,循环到的元素会作为当前数据上下文。
例如,people helper 的值为:
~~~
Template.welcomePage.helpers({
people: [{name: "Bob"}, {name: "Frank"}, {name: "Alice"}]
});
~~~
然后你可以用一个<p>标签列表显示每一个人的姓名:
~~~
{{#each people}}
<p>{{name}}</p>
{{/each}}
~~~
或是用上面的"nametag"模板代替 <p>标签:
~~~
{{#each people}}
{{> nametag}}
{{/each}}
~~~
记住:helper可以是简答值,也可以是函数。例如,要显示登录用户的用户名,你可以定义一个叫做username的helper:
~~~
// in your JS file
Template.profilePage.helpers({
username: function () {
return Meteor.user() && Meteor.user().username;
}
});
~~~
现在,每次使用username helper的时候,都会调用上面的helper函数来确定用户名:
~~~
<!-- in your HTML -->
<template name="profilePage">
<p>Profile page for {{username}}</p>
</template>
Helper可以接收参数。例如,
Template.post.helpers({
commentCount: function (numComments) {
if (numComments === 1) {
return "1 comment";
} else {
return numComments + " comments";
}
}
});
~~~
参数放在大括号里,helper名之后:
`<p>There are {{commentCount 3}}.</p>`
上面定义的helper都关联到特定的模板,可以用Template.registerHelper定义所有模板都能用的helper。
关于Spacebars更详细的文档参见[README](http://meteor.fanxiao2.net)。后面的Session, Tracker,Collections, 和 Accounts小节会有如何给模板添加动态数据的讨论。
传给Template.myTemplate.events的事件map,用事件描述符作为key,事件处理函数作为value。事件处理函数接收两个参数:事件对象和模板实例。事件处理函数中通过this获取数据上下文。
假设有下面的模板:
~~~
<template name="example">
{{#with myHelper}}
<button class="my-button">My button</button>
<form>
<input type="text" name="myInput" />
<input type="submit" value="Submit Form" />
</form>
{{/with}}
</template>
~~~
调用 Template.example.events 给模板增加事件处理器:
~~~
Template.example.events({
"click .my-button": function (event, template) {
alert("My button was clicked!");
},
"submit form": function (event, template) {
var inputValue = event.target.myInput.value;
var helperValue = this;
alert(inputValue, helperValue);
}
});
~~~
key的前半部分是要捕获的事件名称。几乎支持所有的DOM事件,常见的有:click, mousedown, mouseup, mouseenter, mouseleave, keydown, keyup, keypress, focus, blur, 和 change。
key的后半部分是CSS选择器,用来指明要监听的元素。几乎支持所有JQuery支持的选择器.
无论何时,选定元素上触发了监听的事件时,对应的事件处理函数就会被调用,参数为:DOM 事件对象和模板实例。详细信息参见 [Meteor手册](http://meteor.fanxiao2.net)
用这个方法注册的函数会在Template.myTemplate模板的每个实例第一次插入到页面的时候调用一次。
这个回调函数可以用来集成那些不适应Meteor自动视图渲染机制,并且需要在每次HTML插入到页面时进行初始化的第三方库。 你可以在onCreated 和 onDestroyed回调中执行对象初始化或是清理工作。
例如,要使用HighlightJS库高亮codeSample模板中所有`<pre>`元素,你可以传递如下回调函数给Template.codeSample.onRendered:
~~~
Template.codeSample.onRendered(function () {
hljs.highlightBlock(this.findAll('pre'));
});
~~~
在回调函数中,this指向一个template instance对象实例,`that is unique to this inclusion of the template and remains across re-renderings`.可以使用方法this.find 和 this.findAll来获取模板渲染后的HTML DOM节点。