DIV CSS 佈局教程網

Bootstrap Table 遇上 KnockoutJS:MVVM 思維打造增刪改查(上篇)
編輯:關於JavaScript     

Bootstrap 把樣式問題一次解決,KnockoutJS 則把「資料與畫面同步」這件苦差事接手過去。兩者搭配,前端要寫的瑣碎程式碼會少掉一大半。本篇先把 KnockoutJS 的底層觀念打牢,下一篇再進到真正的表格增刪改查實作。

為什麼是 KnockoutJS

它是個以 MVVM 模式為核心的輕量級前端框架,v3.4.0 版本壓縮後只有約 22KB。它解決的是最惱人的那件事:資料變了,畫面不會自動跟著變;畫面變了,資料也不會自動更新,於是到處都是手動同步的事件監聽。Knockout 提供雙向綁定,讓開發者把注意力放回資料本身。

MVVM 拆成三層:Model 是資料模型,View 是視圖,ViewModel 則是夾在中間的黏合層,負責把資料模型與 DOM 綁在一起。用過 WPF 或 Silverlight 的人對這套不陌生。

官網:https://knockoutjs.com 原始碼:https://github.com/knockout/knockout

四分鐘上手:最精簡的綁定

從零開始只要四步。第一步,把檔案放進頁面(Knockout 不依賴 jQuery,只有用到 jQuery 的功能時才需要另外引入):

<script src="~/scripts/knockout/knockout-3.4.0.min.js"></script>

第二步,宣告 ViewModel。在 JavaScript 裡,它看起來就是個再普通不過的物件字面量:

var myViewModel = {
    Name: "Lilei",
    profession: "軟體工程師"
};

第三步,在視圖上用 data-bind 標出綁定位置。純文字元素用 text,輸入框則要用 textinput:

<div>
  姓名:<label data-bind="text: Name"></label><br />
  職業:<input type="text" data-bind="textinput: profession" />
</div>

第四步,啟動綁定:

ko.applyBindings(myViewModel);

如果你夠細心,會發現 applyBindings 有第二個參數。它是選填的,用來限定 ViewModel 的作用範圍:

<div>
  姓名:<label id="lb_name" data-bind="text: Name"></label><br />
  職業:<input type="text" data-bind="textinput: profession" />
</div>
ko.applyBindings(myViewModel, document.getElementById("lb_name"));

傳入 lb_name 之後,只有這個標籤上的綁定會生效;若傳入的是 div 這類容器,範圍就擴大到它底下所有子元素。

真正的魔法:監控屬性

做到這裡,畫面上看到的其實只是把一個物件的值倒進 HTML,跟字串拼接沒太大差別。雙向綁定的關鍵在於「監控屬性」,Knockout 有三種:observable、dependentObservable、observableArray。

observable:單一屬性監控

var myViewModel = {
    Name: ko.observable("Lilei"),
    Profession: "軟體工程師"
};
ko.applyBindings(myViewModel);

$(function () {
    $("#txt_testobservable").on("input", function () {
        myViewModel.Name($(this).val());
    });
});

包上 ko.observable() 之後,Name 就從「屬性」變成了「函式」——讀值要 myViewModel.Name(),寫值要 myViewModel.Name('新值')。這一行 myViewModel.Name($(this).val()) 把輸入框的值寫回去,label 立刻同步更新。

你可能會說,用 textchange 事件手動把值塞給 label 也能做到。沒錯,但差別在於:監控屬性讓「任何地方」改動 Name,畫面都會跟著變,不必每個改動點都去幫 label 賦值。JS 只需要盯著 myViewModel.Name() 一個入口。

dependentObservable:讓屬性依賴其他屬性

var myViewModel = {
    Name: ko.observable("Lilei"),
    Profession: ko.observable("軟體工程師")
};

myViewModel.Des = ko.dependentObservable(function () {
    return "本人姓名——" + myViewModel.Name() + ",職業——" + myViewModel.Profession();
});

ko.applyBindings(myViewModel);

Des 同時監看 Name 與 Profession,任一變動,綁定 Description 的元素就自動重算。手動操作 DOM 的麻煩,就這樣被消掉了。

observableArray:監控整個陣列

var deptArr = ko.observableArray([
    { id: 1, Name: '研發部' },
    { id: 2, Name: '行政部' },
    { id: 3, Name: '人事部' }
]);

var viewModel = { deptArr: deptArr };
ko.applyBindings(viewModel);

var i = 4;
$(function () {
    $("#btn_test").on("click", function () {
        deptArr.push({ id: i++, Name: $("#txt_testobservable").val() });
    });
});

搭配 options 綁定,push 一個新元素,下拉選單馬上多一項。

<select data-bind="options: deptArr, optionsText: 'Name'"></select>

要特別注意:監控陣列監的是陣列「本身」的結構變化(增刪元素)。若改成 deptArr[1].Name = "aaa" 這種直接改子物件屬性的寫法,畫面不會有任何反應。要攔住這種變化,得把子物件的屬性也各自包成 ko.observable(),兩者合用才行。

常用的 data-bind 屬性速查

text 與 textinput

text 對應元素的文字內容(近似 innerText),可用在 label、span、div 等任何標籤;textinput 對應 input 的 value。沒有包 observable 就是靜態綁定,包了才是動態。

value 與 valueUpdate

姓名:<input type="text" data-bind="value: Name, valueUpdate: 'keyup'" />

value 是 textinput 更正式的版本,搭配 valueUpdate 可指定「什麼互動才同步回 ViewModel」,常見值有 change、keyup、keypress、afterkeydown。上例代表放開按鍵時才更新。

checked 與 enable / disabled

<input type="text" data-bind="enable: IsMen" />

var myViewModel = {
    Name: ko.observable("Lilei"),
    Profession: ko.observable("軟體工程師"),
    Age: ko.observable(40),
    IsMen: ko.observable(true)
};
ko.applyBindings(myViewModel);
myViewModel.IsMen(false);   // 輸入框變成禁用狀態

checked 用於 checkbox、radio,值型別為布林;enable 控制是否啟用元素,disabled 與它相反,兩者都吃布林值。

html、css、style、attr

html 對應 innerHTML,與 text 的關係如出一轍。css 動態增刪 class:

<div data-bind="css: { testbold: Name() == 'Lilei', testborder: Profession() == 'PHP工程師' }">內容</div>

style 則針對單一樣式屬性;attr 負責增刪標籤屬性(含自訂屬性),用法與 css 綁定類似。

click

<input type="button" value="測試" data-bind="click: ClickFunc" />

var myViewModel = {
    ClickFunc: function () { alert($(event.currentTarget).val()); }
};
ko.applyBindings(myViewModel);

雖然也能寫成 click: function(){ ... } 的匿名函式,但把 JS 邏輯揉進 HTML 裡,一旦判斷條件變複雜就很難維護。除非真的只是臨時測試,否則不建議。

JSON 與 ViewModel 的雙向轉換

前後端溝通多半用 JSON。從後端拿回來的是普通物件,要用 Knockout 的特性就得轉成監控屬性;反过来要送出前,又得轉回普通 JSON。

JSON 轉 ViewModel:手動寫法

var myViewModelJson = {
    DeptName:  ko.observable(),
    DeptLevel: ko.observable(),
    DeptDesc:  ko.observable()
};
ko.applyBindings(myViewModelJson);

// ajax success 內
myViewModelJson.DeptName(oJson.DeptName);
myViewModelJson.DeptLevel(oJson.DetpLevel);
myViewModelJson.DeptDesc(oJson.DeptDesc);

靈活,但欄位一多就是災難。

JSON 轉 ViewModel:用 knockout.mapping

<script src="~/scripts/knockout/knockout-3.4.0.min.js"></script>
<script src="~/scripts/knockout/extensions/knockout.mapping-latest.js"></script>

載入順序不能顛倒,mapping 檔必須排在核心檔之後,否則取不到 ko.mapping。接著:

success: function (data) {
    var vm = ko.mapping.fromJS(data);
    ko.applyBindings(vm);
}

一行搞定。mapping 也能反過來更新既有 ViewModel,把第二個參數傳進去即可:

success: function (data) {
    ko.mapping.fromJS(data, myViewModelJson);
}

ViewModel 轉 JSON

Knockout 自帶兩個方法,不需要 mapping 支援:ko.toJS() 轉成普通 JSON 物件,ko.toJSON() 轉成序列化後的字串。

var oJson1 = ko.toJS(myViewModelJson);
var oJson2 = ko.toJSON(myViewModelJson);

自訂自己的 data-bind

做元件封裝時,常需要寫出 data-bind="myBind: Name" 這種自訂綁定。Knockout 提供了 ko.bindingHandlers:

ko.bindingHandlers.MySelect = {
    init: function (element, valueAccessor, allBindingsAccessor, viewModel) {
        // 初始化:element 是被綁定的 DOM,valueAccessor() 拿得到傳入的參數
    },
    update: function (element, valueAccessor, allBindingsAccessor, viewModel) {
        // 監控屬性變動時的回呼,不需要回呼時可省略
    }
};

宣告完就能在標籤上使用:

<select data-bind="MySelect: $root">
  <option id="1">研發部</option>
  <option id="2">人事部</option>
  <option id="3">行政部</option>
</select>

實戰一:在 init 裡初始化 MutiSelect 外掛。

ko.bindingHandlers.MySelect = {
    init: function (element, valueAccessor) { $(element).multiselect(); },
    update: function () {}
};

$(function () { ko.applyBindings({}); });

實戰二:把參數從 ViewModel 傳進外掛。

ko.bindingHandlers.MySelect = {
    init: function (element, valueAccessor) {
        $(element).multiselect(valueAccessor());
    },
    update: function () {}
};

$(function () {
    var MultiSelect = {
        enableClickableOptGroups: true,
        onChange: function (option, checked) { alert("選擇改變"); }
    };
    ko.applyBindings(MultiSelect);
});

這裡的 valueAccessor 要當函式呼叫才拿得到值,這是 Knockout 為了延遲求值所做的設計。

下一篇

基礎鋪墊比預期長了不少,真正的增刪改查實作就留到《Bootstrap Table 與 KnockoutJS 結合實作增刪改查(下篇)》,敬請期待。

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