【Knockout.js 学习体验之旅】（3）模板绑定

最新推荐文章于 2024-11-05 15:31:54 发布

weixin_30701521

最新推荐文章于 2024-11-05 15:31:54 发布

阅读量127

点赞数

文章标签：前端 javascript ViewUI

原文链接：http://www.cnblogs.com/qieguo/p/5579888.html

版权

本文是【Knockout.js 学习体验之旅】系列文章的第3篇，所有demo均基于目前knockout.js的最新版本（3.4.0）。小茄才识有限，文中若有不当之处，还望大家指出。

目录：

【Knockout.js 学习体验之旅】（1）ko初体验

【Knockout.js 学习体验之旅】（2）花式捆绑

【Knockout.js 学习体验之旅】（3）模板绑定

模板引擎

页面是由数据和HTML组件构成的，如何将数据嵌入到HTML组件里面呢？一个比较好的选择是使用模板技术。

回顾下第一篇（【Knockoutjs 学习体验之旅】（1）ko初体验）开头的总价计算：

  1 <!--HTML Code-->
  2 <div class="counter">
  3     Price: <input type="text" data-bind="{value: price, valueUpdate: 'afterkeydown'}" placeholder="请输入单价" /><br />
  4     Account: <input type="text" data-bind="textInput: account" placeholder="请输入个数" /><br />
  5     sum: <span data-bind="text: sum"></span>
  6 </div>

这就是一个简单的组件，他有自己的内部结构，有自己的事件处理机制。假如我需要使用很多个这样的组件，那肯定不会是将上面的HTML代码复制 n 遍插入到不同的地方吧，况且单纯复制还不行，还要将变量区分开呢！如果是在一个列表里面，那可以用 foreach 来做，如果是要用在不同的容器内，那就要使用模板引擎技术了。

模板技术并不是什么高深的东西，有基于字符串拼接技术的，有基于 DOM 节点的，还有混合着的。更具体的介绍可以看一看这个轮子哥的文章 http://www.tuicool.com/articles/qMJ77r，楼主就不班门弄斧了。knockout.js 也是基于DOM节点的模板技术，编译之后 view 与 data 还是保持绑定关系，可以简单方便地更新数据到 view 层。另外你也可以将 knockout.js 链接到第三方的模板引擎，如 jquery.tmpl 和 Underscore等模板引擎。

下面简单讲讲ko中模板绑定的使用，第三方的集成引用不在本文讨论范围内。

knockout.js 的模板绑定

先看一个例子：

  1 <h2>Participants</h2> Here are the participants:
  2 <div data-bind="template: { name: 'person-template', data: buyer }"></div>
  3 <div data-bind="template: { name: 'person-template', data: seller }"></div>
  4 
  5 <!--模板-->
  6 <script type="text/html" id="person-template">
  7     <h3 data-bind="text: name"></h3>
  8     <p>Credits: <span data-bind="text: credits"></span></p>
  9 </script>
 10 
 11 <script type="text/javascript">
 12     function MyViewModel() {
 13         this.buyer = { name: 'Franklin', credits: 250 };
 14         this.seller = { name: 'Mario', credits: 5800 };
 15     }
 16     ko.applyBindings(new MyViewModel());
 17 </script>

使用方法：HTML元素中使用 data-bind 绑定用到的模板，在 js 中定义相应的数据并应用该绑定。可以看到上面的"person-template"被引用了两次，一次使用的是buyer的数据，另一次使用了seller数据。下面简单说说模板绑定中用到的参数：

name — 指定你要渲染的模板片段，跟模板脚本中的 id 相对应。
nodes — 直接传递一个DOM节点数组作为模板使用。传递的DOM节点数列应该是不被监控的，因为渲染过程中会对这个节点数列进行复制赋值等操作。而且如果这个节点数组有父级节点的话也会被移除。当我们传递了一个非空的name值时，nodes选项会被忽略，所以很少会用到这个属性。
data — 用来作为渲染数据的对象。如果你忽略整个参数，KO将查找foreach参数，或者是应用整个view model对象。
if — 与上一篇中的 if 作用类似，只有当 if 后的表达式为真时才会渲染模板，用于防止一个空可观察对象在模板被填充之前被绑定。
foreach — 按照“foreach”模式渲染模板。
as — 结合foreach使用的时候，指定每项渲染数据的别名，主要是用于定义数据范围方便在嵌套绑定里面使用。
afterRender, afterAdd, or beforeRemove — 渲染时的回调函数。

下面简单简单介绍一下几种用法。

一些例子

使用 foreach 渲染 ViewModel中的所有数据

  1 <h2>Participants</h2>
  2 Here are the participants:
  3 <div data-bind="template: { name: 'person-template', foreach: people }"></div>
  4 
  5 <script type="text/html" id="person-template">
  6     <h3 data-bind="text: name"></h3>
  7     <p>Credits: <span data-bind="text: credits"></span></p>
  8 </script>
  9 
 10  function MyViewModel() {
 11      this.people = [
 12          { name: 'Franklin', credits: 250 },
 13          { name: 'Mario', credits: 5800 }
 14      ]
 15  }
 16  ko.applyBindings(new MyViewModel());

这个例子跟上面的例子效果是一样的，使用 foreach 会将所有数据都渲染到模板中。区别就在于HTML的层级，使用data指定的时候，每一份数据渲染到对应的容器中；使用foreach的时候所有数据都被绑定到了一个容器内。上一篇中也介绍了foreach的用法，用不用模板都能得到一样的效果。回忆一下foreach的写法：

  1 <div data-bind="foreach: people">
  2     <h3 data-bind="text: name"></h3>
  3     <p>Credits: <span data-bind="text: credits"></span></p>
  4 </div>

as 在嵌套绑定中的使用

  1 <ul data-bind="template: { name: 'seasonTemplate', foreach: seasons, as: 'season' }"></ul>
  2 
  3 <script type="text/html" id="seasonTemplate">
  4     <li>
  5         <strong data-bind="text: name"></strong>
  6         <ul data-bind="template: { name: 'monthTemplate', foreach: months, as: 'month' }"></ul>
  7     </li>
  8 </script>
  9 
 10 <script type="text/html" id="monthTemplate">
 11     <li>
 12         <span data-bind="text: month"></span>
 13         is in
 14         <span data-bind="text: season.name"></span>
 15     </li>
 16 </script>
 17 
 18 <script>
 19     var viewModel = {
 20         seasons: ko.observableArray([
 21             { name: 'Spring', months: [ 'March', 'April', 'May' ] },
 22             { name: 'Summer', months: [ 'June', 'July', 'August' ] },
 23             { name: 'Autumn', months: [ 'September', 'October', 'November' ] },
 24             { name: 'Winter', months: [ 'December', 'January', 'February' ] }
 25         ])
 26     };
 27     ko.applyBindings(viewModel);
 28 </script>

上面这种多层的绑定中，要在下级绑定层次中要引用上层的话，就可以使用 as 定义的别名了。当然层次简单的时候，用$parent也是可以的，用 as 会更加清晰，不会纠结在层次关系中。

注意：as 后接的别名应该用引号引起来，因为这里我们是命名一个变量，而不是读取一个已经存在的变量。

动态决定使用哪个模板

  1 <ul data-bind='template: { name: displayMode, foreach: employees }'> </ul>
  2 <script id="active" type='text/html'>
  3     <li><span data-bind='text: name'></span>uses the "active" template!</li>
  4 </script>
  5 <script id="inactive" type='text/html'>
  6     <li><span data-bind='text: name'></span>uses the "inactive" template!</li>
  7 </script>
  8 
  9 <script>
 10     var viewModel = {
 11         employees: ko.observableArray([{
 12             name: "Kari",
 13             active: ko.observable(true)
 14         }, {
 15             name: "Brynn",
 16             active: ko.observable(false)
 17         }, {
 18             name: "Nora",
 19             active: ko.observable(false)
 20         }]),
 21         displayMode: function(employee) {
 22             // Initially "Kari" uses the "active" template, while the others use "inactive"
 23             return employee.active() ? "active" : "inactive";
 24         }
 25     };
 26     // ... then later ...
 27     viewModel.employees()[1].active(true);
 28     // Now "Brynn" is also rendered using the "active" template.
 29     ko.applyBindings(viewModel);
 30 </script>

上面这个例子有 active 和 inactive 两个模板，ul 元素的 name 没有直接指定模板 id ，而是通过一个函数返回模板 id，达到了选择不同模板的目的。

吐槽一下：官方的文档相当省，模板脚本都省掉了。。。博客园的汤姆大叔，居然也就那样搬下来了，纯翻译的让人无语。

Mapping插件

模板技术可以简单地将数据和表现分离，采用前端渲染技术时，后台只要将模型数据发给客户端即可，前端将获取到的数据渲染输出。目前为止都是手动将获取到的数据写入 ViewModel 中，而 Mapping 插件就是帮你自动完成创建 ViewModel 的好工具。对比一下手动创建和使用 Mapping 插件两种方式：

手动创建：

  1 // setup
  2 var viewModel = {
  3     serverTime: ko.observable(),
  4     numUsers: ko.observable()
  5 }
  6 // update:
  7 var data = getDataUsingAjax();  // your method to get data from server
  8 viewModel.serverTime(data.serverTime);
  9 viewModel.numUsers(data.numUsers);

Mapping插件

  1 var data = getDataUsingAjax();  // your method to get data from server
  2 var viewModel = ko.mapping.fromJS(data);
  3 ko.mapping.fromJS(data, viewModel);

假如从服务器中获取的数据比较多的话，使用Mapping的确可以减少很多代码量。使用Mapping之后，data对象的所有属性都被设置成可观察对象，所有数组都被设置成可观察对象数组，数组中的顺序依然被保存。改变data对象的属性或者增减数组项目就可以引起绑定更新事件。Mapping插件还有很多高级用法，不过除非非Mapping插件不可的情况，没必要对一个插件投入太多精力去学习，搞太多还不如手写算了。