企业🤖AI智能体构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
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节点。