這個系列先前介紹過 Bootstrap,而目前手上的專案採用 Asp.net MVC + KnockoutJs + Bootstrap 的組合,於是又接著寫下去。今天要談的是前端 MVVM 類庫 KnockoutJs。
做 .NET 開發的人應該熟悉 WPF 中的 MVVM 模式,KnockoutJs 就是把它帶進瀏覽器的實作。MVVM 的價值在於把業務邏輯與頁面呈現分開,讓前端專案更好維護。
以往寫網頁,JS 與 HTML 混在一起,程式碼裡到處是 DOM 操作,結構一旦變大就難以收拾。有了 MVVM,兩邊得以分離,資料操作只要用 data-bind 語法綁到對應元素上即可,開發速度明顯加快。
嚴格說來,KnockoutJs 更貼近「類庫」而非「框架」。框架通常是個比較重的概念,該包含路由等特性,而 KnockoutJS 並沒有;相比之下,AngularJS 才更適合被稱為 MVVM 框架。
KnockoutJS 的四項主要能力:
宣告式綁定(Declarative Bindings):用簡潔語法把模型資料關聯到 DOM 元素,也就是 data-bind。
依賴追蹤(Dependency Tracking):在模型資料之間建立關聯。例如商品總價等於各項小計之和,這種關係由 computed 函式負責。
介面自動刷新(Automatic UI Refresh):模型狀態改變時,UI 自動更新,由 observable 函式實作。
模板(Templating):快速撰寫複雜且可嵌套的 UI,概念近似 WPF 中的樣板。
1. 單向綁定
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Demo1-單向綁定</title>
<script type="text/javascript" src="knockout-3.4.0.js"></script>
</head>
<body>
<!--單向綁定-->
<div>
<p>First name: <strong data-bind="text: firstName"></strong></p>
<p>Last name: <strong data-bind="text: lastName"></strong></p>
<p>First name: <input data-bind="value: firstName" /></p>
<p>Last name: <input data-bind="value: lastName" /></p>
</div>
<!--JS代碼也就是業務邏輯部分,將業務邏輯與Html代碼分割開-->
<script type="text/javascript">
function ViewModel() {
this.firstName = "Tommy";
this.lastName = "Li";
}
ko.applyBindings(new ViewModel());
</script>
</body>
</html>
2. 雙向綁定
上面這個例子中,改動 input 的值並移開焦點後,上方的文字並不會更新。KnockoutJS 的自動更新不會憑空發生,必須改用 observable 函式包裝:
<!DOCTYPE html>
<html>
<head>
<meta name="viewport" content="width=device-width" />
<title>Demo2-雙向綁定</title>
<script type="text/javascript" src="knockout-3.4.0.js"></script>
</head>
<body>
<!--雙向綁定-->
<div>
<p>First name: <strong data-bind="text: firstName"></strong></p>
<p>Last name: <strong data-bind="text: lastName"></strong></p>
<p>First name: <input data-bind="value: firstName"/></p>
<p>Last name: <input data-bind="value: lastName" /></p>
</div>
<script type="text/javascript">
function ViewModel() {
this.firstName = ko.observable("Tommy");
this.lastName = ko.observable("Li");
}
ko.applyBindings(new ViewModel());
</script>
</body>
</html>
用 computed 函式即可建立依賴關係:
<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>Demo3-依賴跟蹤</title>
<script type="text/javascript" src="knockout-3.4.0.js"></script>
</head>
<body>
<div>
<p>First name: <strong data-bind="text: firstName"></strong></p>
<p>Last name: <strong data-bind="text: lastName"></strong></p>
<p>First name: <input data-bind="value: firstName" /></p>
<p>Last name: <input data-bind="value: lastName"/></p>
<p>Full name: <strong data-bind="text: fullName"></strong></p>
<button data-bind="click: capitalizeLastName">LastName To Upper</button>
</div>
<script type="text/javascript">
function ViewModel() {
this.firstName = ko.observable("Tommy");
this.lastName = ko.observable("Li");
// 依賴跟蹤
this.fullName = ko.computed(function () {
return this.firstName() + " " + this.lastName();
}, this);
// 通過代碼改變observable的值
this.capitalizeLastName = function() {
this.lastName(this.lastName().toUpperCase());
};
}
ko.applyBindings(new ViewModel());
</script>
</body>
</html>
再加一點變化,用宣告式綁定與依賴追蹤做列表:
<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>Demo4-列表綁定</title>
<script type="text/javascript" src="knockout-3.4.0.js"></script>
</head>
<body>
<table>
<thead>
<tr><td>Name</td><td>Amount</td><td>Price</td></tr>
</thead>
<tbody data-bind="foreach: items">
<tr>
<td data-bind="text: product.name"></td>
<td><select data-bind="options:[1,2,3,4,5,6],value: amount"></select></td>
<td data-bind="text: subTotal"></td>
<td><a href="#" data-bind="click: $root.remove">Remove</a></td>
</tr>
</tbody>
</table>
<h3>Order Price: <span data-bind="text: price"></span></h3>
<button data-bind="click: addComputer">Add a Computer</button>
<script type="text/javascript">
var products = [
{ name: "Learnighard 學習筆記", price: 49 },
{ name: "小米Note", price: 999 },
{ name: "宏碁筆記本", price: 4999 }
];
// 訂單類
function Order() {
var self = this;
this.items = ko.observableArray([
new Item(products[0], 1),
new Item(products[1], 2)
]);
// 訂單總價
this.price = ko.computed(function() {
var p = 0;
for (var i = 0; i < self.items().length; i++) {
var item = self.items()[i];
p += item.product.price * item.amount();
}
return p;
}, self);
this.remove = function(item) { self.items.remove(item); };
this.addComputer = function () { self.items.push(new Item(products[2], 1)); };
}
// 訂單項類
function Item(product, amount) {
var self = this;
this.product = product;
this.amount = ko.observable(amount);
// 訂單項總價
this.subTotal = ko.computed(function() {
return self.amount() * self.product.price;
}, self);
}
ko.applyBindings(new Order());
</script>
</body>
</html>
這裡有兩個細節值得注意:computed 的第二個參數傳入 this(或 self),是為了讓運算式內的 this 正確指向 ViewModel;而 foreach 中的 $root 則用來存取最外層的 ViewModel,因此在子層要呼叫 remove 時必須寫成 $root.remove。
寫到這裡應該不難發現,KO 的語法相當直覺。接著看模板的用法。
<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>Demo5-模板綁定</title>
<script type="text/javascript" src="knockout-3.4.0.js"></script>
</head>
<body>
<!--模板綁定,div的內容為personTemplate模板內的標簽-->
<div data-bind="template:'personTemplate'"></div>
<script id="personTemplate" type="text/html">
<p>Name: <strong data-bind="text: name"></strong></p>
<p>Age: <strong data-bind="text: age"></strong></p>
</script>
<script type="text/javascript">
var ViewModel = {
name: ko.observable('Tommy'),
age: ko.observable(28),
makeOlder: function() { this.age(this.age() + 1); }
};
ko.applyBindings(ViewModel);
</script>
</body>
</html>
模板也能搭配 foreach,重複渲染一整份清單:
<!DOCTYPE html>
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>Demo6-模板綁定</title>
<script type="text/javascript" src="knockout-3.4.0.js"></script>
</head>
<body>
<h2>Participants</h2>
Here are the participants:
<div data-bind="template: { name: 'persontemplate', foreach: people }"></div>
<script type="text/html" id="persontemplate">
<h3 data-bind="text: name"></h3>
<p>Age: <span data-bind="text: age"></span></p>
</script>
<script type="text/javascript">
function MyViewModel() {
this.people = [
{ name: 'Tommy', age: 27 },
{ name: 'Frank', age: 33 }
];
}
ko.applyBindings(new MyViewModel());
</script>
</body>
</html>
模板還有更多變化,可參考官方文件的 template-binding 章節,這裡只示範了兩種基本形式。
KnockoutJs 的入門內容就到這裡。它的四項核心能力彼此扣合:observable 負責讓資料可被觀察,computed 負責表達資料之間的關係,宣告式綁定把兩者接上 DOM,模板則負責處理重複的結構。下一篇會用 KO 實際做一個專案,把這些積木組起來。