DIV CSS 佈局教程網

Knockoutjs 學習系列(二):各種綁定寫法整理
編輯:關於JavaScript     

上一篇提到 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。

click 綁定

語法 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" 關閉。

event 綁定

<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>

submit 綁定

主要用於表單驗證。ko 會攔住預設的提交動作,轉進 submit 綁定的函式;需要真正送出時 return true。之所以不用 click,是因為 submit 天生就是處理提交事件設計的,還能接受 Enter 鍵,click 則不行。

value 與 textInput

兩者外觀相似,但更推薦 textInput,因為它是專門處理輸入事件的新綁定。用 value 時輸入後必須把焦點移開才會更新,textInput 則是即時更新。

value 也能靠 data-bind="{ value: price, valueUpdate: 'afterkeydown' }" 達到類似效果,但瀏覽器相容性不如 textInput。

options 與 selectedOptions

<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 的結構因此能寫得更簡單。

官方教學:https://knockoutjs.com/documentation/introduction.html

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