上一篇提到 ko 的 data-bind="XX:OO" 除了綁定 text、value,還能綁定 visible、style 等外觀屬性,click、textInput 等事件,甚至控制程式流程。以下依「表現類、流程類、交互類」三種分類整理。
包含 visible、text、html、css、style、attr。除了 css 指的是 class 之外,其餘都很直觀。要注意 style 中的屬性名要與 JS 一致,也就是去掉連字號改為駝峰式。
<!--HTML code-->
<div data-bind="visible: shouldShowMessage">
You will see this message only when "shouldShowMessage" holds a true value.
</div>
<div>Today's message is: <span data-bind="text: myMessage"></span></div>
<div data-bind="html: details"></div>
<div data-bind="css: { profitWarning: currentProfit() < 0 }">CSS class binding test</div>
<div data-bind="style: { color: currentProfit() < 0 ? 'red' : 'black' }">CSS style binding test</div>
<a data-bind="attr: { href: url, title: urltitle }">Report</a>
// js code
var viewModel = {
shouldShowMessage: ko.observable(true),
myMessage: ko.observable(),
details: ko.observable(),
currentProfit: ko.observable(150000),
url: ko.observable("year-end.html"),
urltitle: ko.observable("Report including final year-end statistics")
};
ko.applyBindings(viewModel);

XXOO 裡除了單一屬性,也可以傳 JSON 物件做組合綁定:
<div data-bind="{ visible: shouldShowMessage, text: myMessage,
css: { profitWarning: currentProfit() < 0 } }">
You will see this message only when "shouldShowMessage" holds a true value.
</div>

實務提醒:很多表現類屬性並不需要動態變化,這時可以在 viewModel 中直接賦值集中管理,但不要把它設為 observable,以免浪費訂閱效能。
var viewModel = {
shouldShowMessage: ko.observable(true),
myMessage: '這段文字不需要動態更新'
};
包含 foreach、if、ifnot、with 與較進階的 component。if/ifnot 與 visible 相似,差別是 if 會直接把元素從 DOM 移除,visible 只是隱藏;with 的效果等同 JS 的 with,會延長作用域鏈,簡單說就是在變數前加了前綴。

<p>測試 foreach 綁定</p>
<ul data-bind="foreach: people">
<li>
No.<span data-bind="text: $index"></span>
people's name: <span data-bind="text: name"></span>
<a href="#" data-bind="click: $parent.removePeople">RemovePeople</a>
<a href="#" data-bind="click: remove">Remove</a>
</li>
</ul>
<input type="button" data-bind="click: addPeople" value="Add" />
var listModel = function () {
var that = this; // 先保存 this,addPeople 內部 this 會改變
this.people = ko.observableArray([
{ name: "Mark Zake", remove: function () { that.people.remove(this); } },
{ name: "James Lebo", remove: function () { that.people.remove(this); } },
{ name: "Green Deny", remove: function () { that.people.remove(this); } }
]);
this.addPeople = function () {
that.people.push({
name: new Date().toDateString(),
remove: function () { that.people.remove(this); }
});
};
this.removePeople = function () { that.people.remove(this); };
};
ko.applyBindings(new listModel());
這裡最容易搞混的是 DOM 節點與 ViewModel 的層次對應。在 ul 上套用 foreach,每個 li 就對應 people 的每個子項;對應起來之後,剩下的照 JS 作用域規則理解即可。li 內部要呼叫外層的 removePeople 得用 $parent,要呼叫自身的 remove 則不用——此時 this 就是當前那筆資料。$index、$parent 這類變數按字面意思理解即可。
用 ko 最重要的理由就是處理動態交互的 UI。
語法 data-bind="click: clickHandler",clickHandler 不必是 ViewModel 的函式,只要能引用到即可。三點要注意:
參數傳遞:ko 預設把當前元件作為第一個參數傳入,這裡要注意綁定上下文——在 with 環境中,傳回的會是 with 的元件而非當前元件。需要 event 就放在第二個參數,需要更多參數則用函式包一層:
<button data-bind="click: function(data, event) {
myFunction('param1', 'param2', data, event)
}">Click me</button>
預設行為:ko 預設阻止預設行為(例如連結跳轉)。若一定要保留,在 handler 中 return true。
事件冒泡:ko 預設允許冒泡,可用 data-bind="click: clickHandler, clickBubble: false" 關閉。
<div>
<div data-bind="event: { mouseover: enableDetails, mouseout: disableDetails }">
Mouse over me
</div>
<div data-bind="visible: detailsEnabled">Details</div>
</div>
<script type="text/javascript">
var viewModel = {
detailsEnabled: ko.observable(false),
enableDetails: function () { this.detailsEnabled(true); },
disableDetails: function () { this.detailsEnabled(false); }
};
ko.applyBindings(viewModel);
</script>
主要用於表單驗證。ko 會攔住預設的提交動作,轉進 submit 綁定的函式;需要真正送出時 return true。之所以不用 click,是因為 submit 天生就是處理提交事件設計的,還能接受 Enter 鍵,click 則不行。
兩者外觀相似,但更推薦 textInput,因為它是專門處理輸入事件的新綁定。用 value 時輸入後必須把焦點移開才會更新,textInput 則是即時更新。

value 也能靠 data-bind="{ value: price, valueUpdate: 'afterkeydown' }" 達到類似效果,但瀏覽器相容性不如 textInput。
<p>Your country:
<select data-bind="options: availableCountries, optionsText: 'countryName',
value: selectedCountry, optionsCaption: 'Choose..."></select>
</p>
<div data-bind="visible: selectedCountry">
You have chosen a country with population
<span data-bind="text: selectedCountry() ? selectedCountry().countryPopulation : 'unknown'"></span>.
</div>
<script type="text/javascript">
var Country = function (name, population) {
this.countryName = name;
this.countryPopulation = population;
};
var viewModel = {
availableCountries: ko.observableArray([
new Country("UK", 65000000),
new Country("USA", 320000000),
new Country("Sweden", 29000000)
]),
selectedCountry: ko.observable() // 預設不選
};
ko.applyBindings(viewModel);
</script>
用 options 綁定選項、value 綁定選中項。因為選項是 JS 物件,需要 optionsText 指定顯示哪個屬性;optionsCaption 是未選任何項時的預設文字。若是多選列表,value 就不管用了,要改用 selectedOptions 綁定成陣列。
enable/disable、hasFocus、checked、uniqueName 都很簡單。uniqueName 用來自動產生表單控件的唯一 name——沒有 name 的欄位不會被表單提交,所以這個綁定偶爾能救命。官網有個很實用的 hasFocus 範例:
Name:
Name: Bert Bertington
點擊姓名變成可編輯、失焦後變回文字,用 ko 寫起來非常短。
把這些綁定組合起來,就能做出交互豐富的 UI 頁面。最重要觀念是:綁定的對象是函式(observable),所以可以直接在 HTML 裡對它做運算與判斷,很多時候 JS 的結構因此能寫得更簡單。