要在專案中引入 Knockout.js,第一步自然是把環境跑起來。本文記錄搭建過程與一個最小驗證範例。
到 knockoutjs.com 下載最新版本(本文使用 knockout-2.2.0.js),然後在 html 文件中引入:
<script type="text/javascript" src="knockout-2.2.0.js"></script>
到這裡就可以開始寫 Knockout 的程式了。
<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'));
上面這個範例只用了最基礎的單向文字綁定。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 的程式碼全部消失。