在我之前的教程中,我介绍了如何使用 ember.object 来定义模型并使用数据集。在本节中,我们将更仔细地了解 ember 如何使用 handlebars 模板框架来定义应用的用户界面。
客户端模板大多数服务器端开发人员习惯于使用模板来定义将动态填充的标记。如果您曾经使用过 asp.net、coldfusion、php 或 rails,那么您肯定知道我在说什么。
javascript 客户端模板最近确实开始流行,特别是因为它专注于构建更多类似桌面的体验。这意味着更多的处理是在客户端完成的,数据主要通过服务器端 api 请求拉取。
我记得不久前 jquery 模板插件首次发布时写过有关客户端模板的文章。近三年后,它仍然是我博客上阅读量最大的帖子,表明人们对客户端模板的兴趣有多么高涨。从那时起,许多其他框架已经发布,提供了丰富的功能和支持社区。 handlebars 是更流行的选项之一,也是 ember 项目选择的框架来满足其模板需求。这是有道理的,因为 handlerbars 是由 ember.js 联合创始人兼核心团队成员 yehuda katz 创建的。但请注意,我不打算在模板框架之间进行比较,我将严格关注 handelbars,因为这是 ember.js 默认使用的。
在之前的文章中,我在代码中展示了一些非常基本的模板:
<script type=text/x-handlebars> <h2><strong>{{firstname}} {{lastname}}</strong></h2></script>
有两件事很突出,那就是脚本标签的类型声明和大括号,它们充当 handlebars 将作用的表达式的分隔符。这是非常典型的语法,我将很快详细讨论,您将在构建 ember 模板时一致地使用它。
语法尽管 handlebars 使用特殊语法,但归根结底,您实际上主要使用标准 html 标记。 handlebars 用于将内容注入到此标记中,以将数据呈现给用户。它通过解析分隔表达式并将其替换为您要求 handlebars 使用的数据来实现此目的。对于 ember,handlebars 提供挂钩,ember 使用它们。该数据通常来自您的控制器(请记住,控制器充当模型的接口)。
任何模板首先需要的是脚本标记定义。大多数人可能已经定义了脚本标签来加载 javascript 库。事实上,您已经这样做了,将 handlebars 加载到您的 ember 项目中:
<script src=js/libs/jquery-1.9.1.js></script><script src=js/libs/handlebars-1.0.0-rc.3.js></script><script src=js/libs/ember-1.0.0-rc.1.js></script><script src=js/app.js></script>
与使用它来定义模板略有不同。首先,我们指定“text/x-handlebars”的 type 属性。浏览器会忽略此 type,但保留文本可供检查,并允许 ember 识别应用程序内的模板。此外,ember 使用名为“data-template-name”的数据属性,ember 可以使用该属性将应用程序的特定部分与模板关联起来。例如,以下声明定义了一个名为“employee”的模板:
<script type=text/x-handlebars data-template-name=employee>...</script>
当您的应用程序启动时,ember 会扫描 dom 中的 type=text/x-handlebars,编译它找到的模板,并将它们存储在 ember 对象的一个属性中,该属性名为 ember.templates 并使用它找出为给定路线呈现的内容。这就是为什么遵循 ember 的命名约定如此重要。在上面的示例中,此模板将自动关联到您在应用程序中创建的员工路线和控制器。同样,我可以'不必过多强调这些命名约定将如何使您的开发变得更加容易。
ember 依赖 url 来确定需要使用的资源和需要渲染的模板。假设您有一个 url 为“/profile”的个人资料页面。您将拥有一个名为 profile 的资源,它将加载该 url 的特定资源(如路由对象),并且您还将拥有一个同名的模板。我们在 ember 系列的第 2 部分中回顾了定义资源和路由对象,因此如果您不确定我正在讨论的内容,请务必跳回那里重新了解一下。
当您访问该 url 时,ember 知道它需要加载这些资源并解析您定义的模板。它通过其命名约定来执行此操作,知道因为您转到“/profile”,所以它需要加载 profile 中定义的资源,并呈现名为 data-template-name=profile 的模板。
路线:配置文件路线控制器: profilecontroller模板:个人资料(注意是小写)再次查看命名约定,您会发现路由、控制器和模板都使用相同的 url 名称绑定在一起,但模板拼写为小写。这使得 ember 能够在幕后管理一切,而无需进行大量接线。
还需要注意的是,如果您声明的模板没有 data-template-name 属性,ember 将假定它是应用程序范围的模板 - 通常用作站点范围模板来创建用户界面元素,例如页眉、页脚和导航。如果您没有为应用程序甚至资源(例如 url)显式定义模板,ember 会自动为您执行此操作,以确保应用程序的稳定性和一致性。
表达式下一步是包含您的标记和用于表示数据的分隔表达式。表达式通过双花括号进行分隔,这使得它们可以通过从控制器传递的数据轻松识别和解析。这是一个例子:
<script type=text/x-handlebars> <h2><strong>{{firstname}} {{lastname}}</strong></h2></script>
在这种情况下,{{firstname}} 和 {{lastname}} 表达式将被 ember 解析并替换为实际数据。此外,ember 设置了观察者,以便当您的数据发生变化时,您的模板会自动更新,并将更新反映给应用程序的用户。
到目前为止,我已经向您展示了一个非常简单的示例,但要点是:
ember 使用特殊的类型属性来定义模板。模板使用标准标记以及分隔表达式,这些表达式在客户端进行解析。这些模板具有 handlebars 的完整功能集。ember 设置观察者来动态更新您的用户界面数据(当用户界面数据发生变化时)。这为您构建用户界面的方式提供了很大的灵活性。让我们继续看看可用的功能。
高级表达式请记住,ember 利用了 handlebars,因此您可以在此处访问其完整的表达式。为了使几乎任何东西变得有用,条件表达式是必须的;车把提供了相当多的选择。
假设我有一个如下所示的 json 数据集:
items: [{ title: tearable cloth simulation in javascript, url: http://codepen.io/stuffit/pen/krawx, id: 5592679, commentcount: 20, points: 127, postedago: 1 hour ago, postedby: nathankp}, { title: netflix now bigger than hbo, url: http://qz.com/77067/netflix-now-bigger-than-hbo/, id: 5592403, commentcount: 68, points: 96, postedago: 2 hours ago, postedby: edouard1234567}
如果我想确保 title 数据可用,我可以使用 #if 表达式添加条件“if”语句:
{{#if item.title}} <li>{{item.title}} - {{item.postedago}} by {{item.postedby}}</li>{{/if}}
这会检查 item.title 是否未定义,并继续处理 title、postedago 和 postedby 数据表达式的后续表达式。
由于该数据集包含多个“记录”,因此可以安全地假设我们可能希望循环 item 的每个元素。这就是 {{#each}} 表达式发挥作用的地方。它允许您枚举对象列表。因此,再次记住模板是标记和 handlebars 表达式的组合,我们可以使用 #each 表达式来循环遍历 ember 模型对象中可用的每个项目。请记住,ember 模型是从控制器派生的,控制器通过 ember 的命名约定与模板关联。
<ul> {{#each item in model}} {{#if item.title}} <li>{{item.title}} - {{item.postedago}} by {{item.postedby}}</li> {{/if}} {{/each}}</ul>
这会渲染出类似于以下内容的内容:
<ul><li>tearable cloth simulation in javascript - 1 hour ago by nathankp</li><li>netflix now bigger than hbo - 2 hours ago by edouard1234567</li><li>fast database emerges from mit class, gpus and student's invention - 33 minutes ago by signa11</li><li> connecting an ipad retina lcd to a pc - 6 hours ago by noonespecial</li></ul>
显着的优势是 ember 隐含的观察者规范,它将在更新时更新您的数据。
如果您的条件表达式需要更复杂,您将需要创建一个计算属性。这允许您基于可以将复杂代码条件应用于数据的方法创建属性。假设我只想显示标题为“javascript 中的可撕裂布料模拟”的数据。我需要设置几件事:
我需要一个计算属性来扫描每个项目并告诉我标题是否匹配我需要创建一个控制器,可供模板中枚举的每个项目使用我需要更新模板,以便它为每个项目使用此控制器
我需要做的第一件事是创建新的控制器,它将包装循环的每个项目并在其中创建计算属性:app.titlecontroller = ember.objectcontroller.extend({ titlematch: function() { return this.get('title') === "tearable cloth simulation in javascript"; }.property()});
查看代码,我们对 ember.objectcontroller 进行子类化以创建控制器。这是控制器,它将包装模板中循环的每个项目。接下来,我们创建一个名为 titlematch 的方法,它使用 get() 方法来拉回当前标题,将其与我定义的文本进行比较,然后返回一个布尔值。最后,调用 ember property() 方法将 titlematch 方法定义为计算属性。
完成此操作后,我们将更新模板的 {{#each}} 表达式,以使用我们创建的新控制器来表示每个项目。这是通过使用 itemcontroller 指令来完成的。需要理解的关键一点是 itemcontroller 是 ember 中的一个关键短语,旨在将控制器与模板的项目关联起来。不要将其与实际的控制器名称混淆(就像我最初所做的那样)。控制器名称分配给 itemcontroller,如下所示:
<ul> {{#each item in model itemcontroller=title}} {{#if titlematch}} <li>{{foo.title}} - {{foo.postedago}} by {{foo.postedby}}</li> {{/if}} {{/each}}</ul>
同样,命名约定规定,在模板中分配名称时,我们使用小写。在本例中,我们将 titlecontroller 分配给 itemcontroller。
现在,当循环每个项目时,计算属性 titlematch 用于评估标题并在匹配时显示数据。
将数据绑定到元素创建动态模板不仅仅是吐出文本。有时,ui 的外观需要受到正在处理的数据的影响。显示图像或建立链接就是很好的例子。
将数据绑定到元素需要使用特殊的 ember 助手来帮助定义属性的上下文,并确保在数据更改时正确更新属性。对于元素属性,{{bindattr}} 帮助器用于填充属性的值。如果我们需要动态指定图像的 url,我们将使用以下语法:
<img {{bindattr src=logourl}} alt=logo>
对于不接收值的属性也可以这样做,例如disabled:
<input type=checkbox {{bindattr disabled=isadministrator}}>
在这种情况下, isadminstrator 可以是基于控制器中的方法的计算属性,或者只是一个普通的对象属性,为您在定义禁用复选框的条件方面提供了很大的灵活性。这种灵活性也适用于定义类名。如果我想使用条件语句来定义是否应将类应用于我的元素,我可以使用以下代码:
<div {{bindattr class=isurgent}}> warning!</div>
根据布尔状态,我的标记将是:
<div {{bindattr class=is-urgent}}> warning!</div>
对于 true 条件,或:
<div> warning!</div>
对于 false 条件。请注意,当我为该类指定 isurgent 时,ember 对该名称进行了 dasher 处理,并将该类呈现为 is-urgent。如果您希望根据结果指定自己的类,可以使用类似于三元语句的条件表达式:
<div {{bindattr class=isurgent:urgent:normal}}>
这将根据 isurgent 的条件值返回该类的 urgent 或 normal。
了解模板模板将成为用户界面的基础,因此花时间阅读 ember 和 handlebars 站点上的文档以充分了解它们的整体功能非常重要。即使您不使用 ember,handlebars 也是一个适合您日常使用的出色框架,并且值得投资学习如何使用它。
gabriel manricks 在 nettuts+ 上编写了一篇关于 handlebars 的精彩教程,您可以使用它来加快框架的速度。
以上就是拥抱余烬:第 4 部分的详细内容。