## 1???? 創建帶有監控屬性的view model
**Observables**
Knockout是在下面三個核心功能是建立起來的:
1. 監控屬性(Observables)和依賴跟蹤(Dependency tracking)
2. 聲明式綁定(Declarative bindings)
3. 模板(Templating)
?這一節,你講學到3個功能中的第一個。 在這之前, 我們來解釋一下MVVM模式和view model的概念。
?**MVVM and View Models**
Model-View-View Model (MVVM) 是一種創建用戶界面的設計模式。 描述的是如何將復雜的UI用戶界面分成3個部分:
* **model**: 你程序里存儲的數據。這個數據包括對象和業務操作(例如:銀子賬戶可以完成轉賬功能), 并且獨立于任何UI。使用KO的時候,通常說是向服務器調用Ajax讀寫這個存儲的模型數據。
* **view model**: 在UI上,純code描述的數據以及操作。例如,如果你實現列表編輯,你的view model應該是一個包含列表項items的對象和暴露的add/remove列表項(item)的操作方法。
注意這不是UI本身:它不包含任何按鈕的概念或者顯示風格。它也不是持續數據模型 – 包含用戶正在使用的未保存數據。使用KO的時候,你的view models是不包含任何HTML知識的純JavaScript 對象。保持view model抽象可以保持簡單,以便你能管理更復雜的行為。
* **view**: 一個可見的,交互式的,表示view model狀態的UI。 從view model顯示數據,發送命令到view model(例如:當用戶click按鈕的時候) ,任何view model狀態改變的時候更新。
使用KO的時候,你的view就是你帶有綁定信息的HTML文檔,這些聲明式的綁定管理到你的view model上。或者你可以使用模板從你的view model獲取數據生成HTML。
創建一個view model,只需要聲明任意的JavaScript object。例如:
~~~
var myViewModel = {
personName: 'Bob',
personAge: 123
};
~~~
你可以為view model創建一個聲明式綁定的簡單view。例如:下面的代碼顯示personName 值:
~~~
The name is <span data-bind="text: personName"></span>
~~~
**Activating Knockout**
data-bind屬性盡快好用但它不是HTML的原生屬性(它嚴格遵從HTML5語法, 雖然HTML4驗證器提示有不可識別的屬性但依然可用)。由于瀏覽器不識別它是什么意思,所以你需要激活Knockout 來讓他起作用。
激活Knockout,需要添加如下的 代碼塊:
~~~
ko.applyBindings(myViewModel);
~~~
你可以將這個代碼塊放在HTML底部,或者放在jQuery的$函數或者ready 函數里,然后放在頁面上面, 最終生成結果就是如下的HTML代碼:
~~~
The name is <span>Bob</span>
~~~
你可能奇怪ko.applyBindings使用的是什么樣的參數,
* 第一個參數是你想用于聲明式綁定
* 第二個參數(可選),可以聲明成使用data-bind的HTML元素或者容器。例如,?ko.applyBindings(myViewModel, document.getElementById('someElementId'))。它的現在是只有作為someElementId 的元素和子元素才能激活KO功能。 好處是你可以在同一個頁面聲明多個view model,用來區分區域。
**Observables**
現在已經知道如何創建一個簡單的view model并且通過binding顯示它的屬性了。但是KO一個重要的功能是當你的view model改變的時候能自動更新你的界面。當你的view model部分改變的時候KO是如何知道的呢?答案是:你需要將你的model屬性聲明成observable的, 因為它是非常特殊的JavaScript objects,能夠通知訂閱者它的改變以及自動探測到相關的依賴。
例如:將上述例子的view model改成如下代碼:
~~~
var myViewModel = {
personName: ko.observable('Bob'),
personAge: ko.observable(123)
};
~~~
你根本不需要修改view – 所有的data-bind語法依然工作,不同的是他能監控到變化,當值改變時,view會自動更新。
**監控屬性(observables)的讀和寫**
不是所有的瀏覽器都支持JavaScript的 getters and setters (比如IE),,所以為了兼容性,使用ko.observable監控的對象都是真實的function函數。
* 讀取監控屬性(observable)的值,只需要直接調用監控屬性(observable)(不需要參數),例如myViewModel.personName() 將返回'Bob',?myViewModel.personAge()?將返回 123。
* 寫一個新值到監控屬性(observable)上,調用這個observable屬性并當新值作為參數。例如:調用?myViewModel.personName('Mary')將更新name值為'Mary'。
* 給一個model對象的多個屬性寫入新值,你可以使用鏈式語法。例如:?myViewModel.personName('Mary').personAge(50)?將會將name更新為 'Mary' 并且 將age更新為 50.
監控屬性(observables)的特征就是監控(observed),例如其它代碼可以說我需要得到對象變化的通知,所以KO內部有很多內置的綁定語法。所以如果你的代碼寫成data-bind="text: personName", text綁定注冊到自身,一旦personName的值改變,它就能得到通知。
當然調用myViewModel.personName('Mary')改變name的值,text綁定將自動更新這個新值到相應的DOM元素上。這就是如何將view model的改變傳播到view上的。
**監控屬性(Observables)的顯式訂閱**
通常情況下,你不用手工訂閱,所以新手可以忽略此小節。高級用戶,如果你要注冊自己的訂閱到監控屬性(observables),你可以調用它的subscribe 函數。例如:
~~~
myViewModel.personName.subscribe(function (newValue) {
alert("The person's new name is " + newValue);
});
~~~
這個subscribe 函數在內部很多地方都用到的。你也可以終止自己的訂閱:首先得到你的訂閱,然后調用這個對象的dispose函數,例如:
~~~
var subscription = myViewModel.personName.subscribe(function (newValue) { /* do stuff */ });
// ...then later...
subscription.dispose(); // I no longer want notifications
~~~
大多數情況下,你不需要做這些,因為內置的綁定和模板系統已經幫你做好很多事情了,可以直接使用它們。
##2???? 使用依賴監控屬性(Dependent Observables)
如果你已經有了監控屬性firstName和lastName,你想顯示全稱怎么辦? 這就需要用到依賴監控屬性了 – 這些函數是一個或多個監控屬性, 如果他們的依賴對象改變,他們會自動跟著改變。
例如,下面的view model,
~~~
var viewModel = {
firstName: ko.observable('Bob'),
lastName: ko.observable('Smith')
};
~~~
… 你可以添加一個依賴監控屬性來返回姓名全稱:
~~~
viewModel.fullName = ko.dependentObservable(function () {
return this.firstName() + " " + this.lastName();
}, viewModel);
~~~
并且綁定到UI的元素上,例如:
~~~
The name is <span data-bind="text: fullName"></span>
~~~
… 不管firstName還是lastName改變,全稱fullName都會自動更新(不管誰改變,執行函數都會調用一次,不管改變成什么,他的值都會更新到UI或者其他依賴監控屬性上)。
**管理‘this’**
新手可忽略此小節,你只需要安裝上面例子中的代碼模式寫就行了,無需知道/關注這個this。
你可能疑惑ko.dependentObservable的第二個參數是做什么用的(上面的例子中我傳的是viewModel), 它是聲明執行依賴監控屬性的this用的。 沒有它,你不能引用到this.firstName() 和this.lastName()。 老練的JavaScript 開發人員不覺得this怎么樣,但是如果你不熟悉JavaScript,那就對它就會很陌生。(C#和Java需要不需要為set一個值為設置this,但是JavaScript 需要,因為默認情況下他們的函數自身不是任何對象的一部分)。
不幸的是, JavaScript 對象沒有任何辦法能引用他們自身,所以你需要通過myViewModelObject.myDependentObservable = ... 的形式添加依賴監控屬性到view model對象上。 你不能直接在view model里聲明他們,換句話說,你不能寫成下面這樣:
~~~
var viewModel = {
myDependentObservable: ko.dependentObservable(function() {
...
}, /* can't refer to viewModel from here, so this doesn't work */)
}
~~~
… 相反你必須寫成如下這樣:
~~~
var viewModel = {
// Add other properties here as you wish
};
viewModel.myDependentObservable = ko.dependentObservable(function() {
...
}, viewModel); // This is OK
~~~
只要你知道期望什么,它確實不是個問題。J
**依賴鏈**
理所當然,如果你想你可以創建一個依賴監控屬性的鏈。例如:
* 監控屬性items表述一組列表項
* 監控屬性selectedIndexes保存著被用戶選上的列表項的索引
* 依賴監控屬性selectedItems 返回的是selectedIndexes 對應的列表項數組
* 另一個依賴監控屬性返回的true或false依賴于 selectedItems 的各個列表項是否包含一些屬性(例如,是否新的或者還未保存的)。一些UI element(像按鈕的啟用/禁用)的狀態取決于這個值)。
?然后,items或者selectedIndexes 的改變將會影響到所有依賴監控屬性的鏈,所有綁定這些屬性的UI元素都會自動更新。多么整齊與優雅!
**可寫的依賴監控屬性**
新手可忽略此小節,可寫依賴監控屬性真的是太advanced了,而且大部分情況下都用不到。
正如所學到的,依賴監控屬性是通過計算其它的監控屬性而得到的。感覺是依賴監控屬性正常情況下應該是只讀的。那么,有可能讓依賴監控屬性支持可寫么?你只需要聲明自己的callback函數然后利用寫入的值再處理一下相應的邏輯即可。
你可以像使用普通的監控屬性一樣使用依賴監控屬性 – 數據雙向綁定到DOM元素上,并且通過自定義的邏輯攔截所有的讀和寫操作。這是非常牛逼的特性并且可以在大范圍內使用。
**例1:分解用戶的輸入**
返回到經典的“first name + last name = full name” 例子上,你可以讓事情調回來看: 讓依賴監控屬性fullName可寫,讓用戶直接輸入姓名全稱,然后輸入的值將被解析并映射寫入到基本的監控屬性firstName和lastName上:
~~~
var viewModel = {
firstName: ko.observable("Planet"),
lastName: ko.observable("Earth")
};
viewModel.fullName = ko.dependentObservable({
read: function () {
return this.firstName() + " " + this.lastName();
},
write: function (value) {
var lastSpacePos = value.lastIndexOf(" ");
if (lastSpacePos > 0) { // Ignore values with no space character
this.firstName(value.substring(0, lastSpacePos)); // Update "firstName"
this.lastName(value.substring(lastSpacePos + 1)); // Update "lastName"
}
},
owner: viewModel
});
~~~
這個例子里,寫操作的callback接受寫入的值,把值分離出來,分別寫入到“firstName”和“lastName”上。 你可以像普通情況一樣將這個view model綁定到DOM元素上,如下:
~~~
<p>First name: <span data-bind="text: firstName"></span></p>
<p>Last name: <span data-bind="text: lastName"></span></p>
<h2>Hello, <input data-bind="value: fullName"/>!</h2>
~~~
這是一個Hello World 例子的反例子,姓和名都不可編輯,相反姓和名組成的姓名全稱卻是可編輯的。
上面的view model演示的是通過一個簡單的參數來初始化依賴監控屬性。你可以給下面的屬性傳入任何JavaScript對象:
* read — 必選,一個用來執行取得依賴監控屬性當前值的函數。
* write — 可選,如果聲明將使你的依賴監控屬性可寫,別的代碼如果這個可寫功能寫入新值,通過自定義邏輯將值再寫入各個基礎的監控屬性上。
* owner — 可選,如果聲明,它就是KO調用read或write的callback時用到的this。查看“管理this”獲取更新信息。
?**例2:Value轉換器**
?有時候你可能需要顯示一些不同格式的數據,從基礎的數據轉化成顯示格式。比如,你存儲價格為float類型,但是允許用戶編輯的字段需要支持貨幣單位和小數點。你可以用可寫的依賴監控屬性來實現,然后解析傳入的數據到基本 float類型里:
~~~
viewModel.formattedPrice = ko.dependentObservable({
read: function () {
return "$" + this.price().toFixed(2);
},
write: function (value) {
// Strip out unwanted characters, parse as float, then write the raw data back to the underlying "price" observable
value = parseFloat(value.replace(/[^\.\d]/g, ""));
this.price(isNaN(value) ? 0 : value); // Write to underlying storage
},
owner: viewModel
});
~~~
然后我們綁定formattedPrice到text box上:
~~~
<p>Enter bid price: <input data-bind="value: formattedPrice"/></p>
~~~
所以,不管用戶什么時候輸入新價格,輸入什么格式,text box里會自動更新為帶有2位小數點和貨幣符號的數值。這樣用戶可以看到你的程序有多聰明,來告訴用戶只能輸入2位小數,否則的話自動刪除多余的位數,當然也不能輸入負數,因為write的callback函數會自動刪除負號。
**例3:過濾并驗證用戶輸入**
例1展示的是寫操作過濾的功能,如果你寫的值不符合條件的話將不會被寫入,忽略所有不包括空格的值。
再多走一步,你可以聲明一個監控屬性isValid 來表示最后一次寫入是否合法,然后根據真假值顯示相應的提示信息。稍后仔細介紹,先參考如下代碼:
~~~
var viewModel = {
acceptedNumericValue: ko.observable(123),
lastInputWasValid: ko.observable(true)
};
viewModel.attemptedValue = ko.dependentObservable({
read: viewModel.acceptedNumericValue,
write: function (value) {
if (isNaN(value))
this.lastInputWasValid(false);
else {
this.lastInputWasValid(true);
this.acceptedNumericValue(value); // Write to underlying storage
}
},
owner: viewModel
});
~~~
… 按照如下格式聲明綁定元素:
~~~
<p>Enter a numeric value: <input data-bind="value: attemptedValue"/></p>
<div data-bind="visible: !lastInputWasValid()">That's not a number!</div>
~~~
現在,acceptedNumericValue 將只接受數字,其它任何輸入的值都會觸發顯示驗證信息,而會更新acceptedNumericValue。
備注:上面的例子顯得殺傷力太強了,更簡單的方式是在上使用jQuery Validation和number class。Knockout可以和jQuery Validation一起很好的使用,參考例子:[grid editor](http://www.cnblogs.com/TomXu/archive/2011/11/22/2256820.html#_Editable_grid)?。當然,上面的例子依然展示了一個如何使用自定義邏輯進行過濾和驗證數據,如果驗證很復雜而jQuery Validation很難使用的話,你就可以用它。
**依賴跟蹤如何工作的**
新手沒必要知道太清楚,但是高級開發人員可以需要知道為什么依賴監控屬性能夠自動跟蹤并且自動更新UI…
事實上,非常簡單,甚至說可愛。跟蹤的邏輯是這樣的:
1. 當你聲明一個依賴監控屬性的時候,KO會立即調用執行函數并且獲取初始化值。
2. 當你的執行函數運行的時候,KO會把所有需要依賴的依賴屬性(或者監控依賴屬性)都記錄到一個Log列表里。
3. 執行函數結束以后,KO會向所有Log里需要依賴到的對象進行訂閱。訂閱的callback函數是重新運行你的執行函數。然后回頭重新執行上面的第一步操作(并且注銷不再使用的訂閱)。
4. 最后KO會通知上游所有訂閱它的訂閱者,告訴它們我已經設置了新值。
所有說,KO不僅僅是在第一次執行函數執行時候探測你的依賴項,每次它都會探測。舉例來說,你的依賴屬性可以是動態的:依賴屬性A代表你是否依賴于依賴屬性B或者C,這時候只有當A或者你當前的選擇B或者C改變的時候執行函數才重新執行。你不需要再聲明其它的依賴:運行時會自動探測到的。
另外一個技巧是:一個模板輸出的綁定是依賴監控屬性的簡單實現,如果模板讀取一個監控屬性的值,那模板綁定就會自動變成依賴監控屬性依賴于那個監控屬性,監控屬性一旦改變,模板綁定的依賴監控屬性就會自動執行。嵌套的模板也是自動的:如果模板X render模板 Y,并且Y需要顯示監控屬性Z的值,當Z改變的時候,由于只有Y依賴它,所以只有Y這部分進行了重新繪制(render)。
##3???? 使用observable數組
如果你要探測和響應一個對象的變化,你應該用observables。如果你需要探測和響應一個集合對象的變化,你應該用observableArray 。在很多場景下,它都非常有用,比如你要在UI上需要顯示/編輯的一個列表數據集合,然后對集合進行添加和刪除。
~~~
var myObservableArray = ko.observableArray(); // Initially an empty array
myObservableArray.push('Some value'); // Adds the value and notifies observers
~~~
**關鍵點:監控數組跟蹤的是數組里的對象,而不是這些對象自身的狀態。**
簡單說,將一對象放在observableArray 里不會使這個對象本身的屬性變化可監控的。當然你自己也可以聲明這個對象的屬性為observable的,但它就成了一個依賴監控對象了。一個observableArray 僅僅監控他擁有的對象,并在這些對象添加或者刪除的時候發出通知。
**預加載一個監控數組observableArray**
如果你想讓你的監控數組在開始的時候就有一些初始值,那么在聲明的時候,你可以在構造器里加入這些初始對象。例如:
~~~
// This observable array initially contains three objects
var anotherObservableArray = ko.observableArray([
{ name: "Bungle", type: "Bear" },
{ name: "George", type: "Hippo" },
{ name: "Zippy", type: "Unknown" }
]);
~~~
**從observableArray里讀取信息**
一個observableArray其實就是一個observable的監控對象,只不過他的值是一個數組(observableArray還加了很多其他特性,稍后介紹)。所以你可以像獲取普通的observable的值一樣,只需要調用無參函數就可以獲取自身的值了。 例如,你可以像下面這樣獲取它的值:
~~~
alert('The length of the array is ' + myObservableArray().length);
alert('The first element is ' + myObservableArray()[0]);
~~~
理論上你可以使用任何原生的JavaScript數組函數來操作這些數組,但是KO提供了更好的功能等價函數,他們非常有用是因為:
1. 兼容所有瀏覽器。(例如indexOf不能在IE8和早期版本上使用,但KO自己的indexOf 可以在所有瀏覽器上使用)
2. 在數組操作函數方面(例如push和splice),KO自己的方式可以自動觸發依賴跟蹤,并且通知所有的訂閱者它的變化,然后讓UI界面也相應的自動更新。
3. 語法更方便,調用KO的push方法,只需要這樣寫:myObservableArray.push(...)。 比如原生數組的myObservableArray().push(...)好用多了。
下面講解的均是observableArray的讀取和寫入的相關函數。
**indexOf**
indexOf 函數返回的是第一個等于你參數數組項的索引。例如:myObservableArray.indexOf('Blah')將返回以0為第一個索引的第一個等于Blah的數組項的索引。如果沒有找到相等的,將返回-1。
**slice**
slice函數是observableArray相對于JavaScript 原生函數slice的等價函數(返回給定的從開始索引到結束索引之間所有的對象集合)。 調用myObservableArray.slice(...)等價于調用JavaScript原生函數(例如:myObservableArray().slice(...))。
**操作observableArray**
observableArray 展現的是數組對象相似的函數并通知訂閱者的功能。
**pop, push, shift, unshift, reverse, sort, splice**
所有這些函數都是和JavaScript數組原生函數等價的,唯一不同的數組改變可以通知訂閱者:
????myObservableArray.push('Some new value')?在數組末尾添加一個新項
????myObservableArray.pop()?刪除數組最后一個項并返回該項
????myObservableArray.unshift('Some new value')?在數組頭部添加一個項
????myObservableArray.shift()?刪除數組頭部第一項并返回該項
????myObservableArray.reverse()?翻轉整個數組的順序
????myObservableArray.sort()?給數組排序
??????? 默認情況下,是按照字符排序(如果是字符)或者數字排序(如果是數字)。
??????? 你可以排序傳入一個排序函數進行排序,該排序函數需要接受2個參數(代表該數組里需要比較的項),如果第一個項小于第二個項,返回-1,大于則返回1,等于返回0。例如:用lastname給person排序,你可以這樣寫:myObservableArray.sort (function (left, right) {return left.lastName == right.lastName? 0: (left.lastName
?????myObservableArray.splice()?刪除指定開始索引和指定數目的數組對象元素。例如myObservableArray.splice(1, 3)?從索引1開始刪除3個元素(第2,3,4個元素)然后將這些元素作為一個數組對象返回。
更多observableArray 函數的信息,請參考等價的[JavaScript數組標準函數](http://www.w3schools.com/jsref/jsref_obj_array.asp)。
**remove***和removeAll*
observableArray 添加了一些JavaScript數組默認沒有但非常有用的函數:
????myObservableArray.remove(someItem)?刪除所有等于someItem的元素并將被刪除元素作為一個數組返回
????myObservableArray.remove(function(item) { return item.age ?刪除所有age屬性小于18的元素并將被刪除元素作為一個數組返回
????myObservableArray.removeAll(['Chad', 132, undefined])?刪除所有等于'Chad', 123, or undefined的元素并將被刪除元素作為一個數組返回
**destroy***和destroyAll(注:通常只和和Ruby on Rails開發者有關)*
destroy和destroyAll函數是為Ruby on Rails開發者方便使用為開發的:
????myObservableArray.destroy(someItem)?找出所有等于someItem的元素并給他們添加一個屬性_destroy,并賦值為true
????myObservableArray.destroy(function(someItem) { return someItem.age ?找出所有age屬性小于18的元素并給他們添加一個屬性_destroy,并賦值為true
????myObservableArray.destroyAll(['Chad', 132, undefined])?找出所有等于'Chad', 123, 或undefined 的元素并給他們添加一個屬性_destroy,并賦值為true
那么,_destroy是做什么用的?正如我提到的,這只是為Rails 開發者準備的。在Rails 開發過程中,如果你傳入一個JSON對象,Rails 框架會自動轉換成ActiveRecord對象并且保存到數據庫。Rails 框架知道哪些對象以及在數據庫中存在,哪些需要添加或更新, 標記_destroy為true就是告訴框架刪除這條記錄。
注意的是:在KO render一個foreach模板的時候,會自動隱藏帶有_destroy屬性并且值為true的元素。所以如果你的“delete”按鈕調用destroy(someItem)?方法的話,UI界面上的相對應的元素將自動隱藏,然后等你提交這個JSON對象到Rails上的時候,這個元素項將從數據庫刪除(同時其它的元素項將正常的插入或者更新)。