模板
模板
在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>My website!</title>
</head>
<!-- add code to the <body> of the page -->
<body>
<h1>Hello!</h1>
{{> welcomePage}}
</body>
<!-- define a template called welcomePage -->
<template name="welcomePage">
<p>Welcome to my website!</p>
</template>
{{ ... }}是Spacebars语法，Meteor使用Spacebars给HTML增加功能。如上所示，利用它你可以引入模板。 使用Spacebars，你可以显示从 helpers 中获取的数据。Helpers 用javascript来写，既可以是简单值，也可以是函数。
Template.myTemplate.helpers(helpers)
Client
Specify template helpers available to this template.
Arguments
helpers Object
Dictionary of helper functions by name.
给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 on GitHub。后面的Session, Tracker,Collections, 和 Accounts小节会有如何给模板添加动态数据的讨论。
Template.myTemplate.events(eventMap)
Client
Specify event handlers for this template.
Arguments
eventMap Event Map
Event handlers to associate with this template.
传给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 事件对象和模板实例。详细信息参见Event Maps section
Template.myTemplate.onRendered
Client
Register a function to be called when an instance of this template is inserted into the DOM.
Arguments
callback Function
A function to be added as a callback.
用这个方法注册的函数会在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节点。
如果你对这篇内容有疑问，欢迎到本站社区发帖提问 参与讨论，获取更多帮助，或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱，如果其他用户或者作者回复了您的评论，将不能在第一时间通知您！
发布评论