DIV CSS 佈局教程網

Knockout.js 環境搭建與第一個雙向綁定範例
編輯:關於JavaScript     

要在專案中引入 Knockout.js,第一步自然是把環境跑起來。本文記錄搭建過程與一個最小驗證範例。

安裝與引入

到 knockoutjs.com 下載最新版本(本文使用 knockout-2.2.0.js),然後在 html 文件中引入:

<script type="text/javascript" src="knockout-2.2.0.js"></script>

到這裡就可以開始寫 Knockout 的程式了。

Hello World

<script type="text/javascript" src="knockout-2.2.0.js"></script>

<span data-bind="text:helloWorld"></span>

<script type="text/javascript">
var AppViewModel = {
  helloWorld: 'Hello World !!'
};
ko.applyBindings(AppViewModel);
</script>

用瀏覽器打開這個 html,就能看到「Hello World!!」。

逐行說明

<span data-bind="text:helloWorld"></span> 定義了一個 span,並用 data-bind 屬性把 helloWorld 綁定上去,於是 span 的內容就等同該變數的值。

script 中定義了 AppViewModel 物件並賦予 helloWorld 屬性,然後呼叫 ko.applyBindings() 將它激活。這個方法是關鍵:少了它,前面所有的 data-bind 宣告都不會生效,頁面上什麼也看不到。

一個踩到的坑:腳本位置

最初我把 script 放在 span 之前,結果頁面一片空白:

<script type="text/javascript" src="knockout-2.2.0.js"></script>
<script type="text/javascript">
var AppViewModel = {
  helloWorld: 'Hello World !!'
};
ko.applyBindings(AppViewModel);
</script>

<span data-bind="text:helloWorld"></span>

原因其實不難推斷:ko.applyBindings() 在執行時,會從 document 中尋找所有帶 data-bind 的元素並進行綁定。此時 span 尚未被解析進 DOM,Knockout 找不到任何綁定目標,於是什麼也沒做。等到 span 出現時,綁定已經結束,不會再回頭處理。

這不是 Knockout 的 bug,而是所有「在載入時掃描 DOM 並附加行為」的庫共通的前提:腳本必須在目標元素之後執行。

三種正確解法

解法一:把 script 移到 body 底部,也就是範例一的做法,最簡單直觀。

解法二:包在 DOM ready 事件裡,這在頁面結構複雜時更可靠:

<span data-bind="text:helloWorld"></span>

<script type="text/javascript">
$(document).ready(function () {
  var AppViewModel = { helloWorld: 'Hello World !!' };
  ko.applyBindings(AppViewModel);
});
</script>

解法三:明確指定綁定範圍。applyBindings 的第二個參數可以限定搜尋的父節點,適合頁面中存在多個獨立 view model 的情況:

ko.applyBindings(AppViewModel, document.getElementById('myContainer'));

從 Hello World 往前一步

上面這個範例只用了最基礎的單向文字綁定。Knockout 真正的價值在於observable——只有把屬性包成 observable,值變動時 UI 才會自動更新:

<input data-bind="value: name" />
<p>你好,<span data-bind="text: name"></span></p>

<script type="text/javascript">
var AppViewModel = {
  name: ko.observable('世界')
};
ko.applyBindings(AppViewModel);
</script>

在輸入框打字,下方文字會即時同步。這才是宣告式綁定框架的核心賣點——手動操作 DOM 的程式碼全部消失。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved