kendo-ui的MVVM模式
摘要：
MVVM(Model View ViewModel)是一种帮助开发者将数据从模型分离的设计模式。MVVM的ViewModel负责将数据对象从模型中分离出来，通过这种方式数据就很容易控制数据如何显示在视图上。
创建View-Model对象：
首先我们需要创建一个View-Model对象，他是控制你的数据显示在视图上。
创建对象
var viewModel = kendo.observable({ name: "John Doe", displayGreeting: function() { var name = this.get("name"); alert("Hello, " + name + "!!!"); } });
创建视图
<div id="view"> <input data-bind="value: name" /> <button data-bind="click: displayGreeting">Display Greeting</button> </div>
然后将对象绑定到视图上
kendo.bind($("#view"), viewModel);
如何工作呢？
input元素的value值是通过data-bind属性绑定到viewModel的name字段，这个绑定是双向的，当改变viewModel的name字段值，视图上input的value值也会被改变。当改变视图上input元素的value值，viewModel的name字段也会被改变。
绑定：
元素通过data-bind属性绑定到viewModel，当你想通过一个对象绑定到视图上，你可以像下面这样定义视图模型
<div data-bind="text: person.name"> </div> <script> var viewModel = kendo.observable({ person: { name: "John Doe" } }); kendo.bind($("div"), viewModel); </script>
data-bind还支持的属性有source, html, attr, visible, enabled等，支持多个属性，以逗号分隔。
注意：
绑定不是javascript，像下面这样的绑定就是不对的
<div data-bind="text: person.name.toLowerCase()"></div>
ObservableObject：
kendo.data.ObservableObject是MVVM模式中非常重要的一部分，它支持跟踪变化和通知用户发生变化，所有的视图模型对象都继承它。
创建ObservableObject
var viewModel1 = new kendo.data.ObservableObject( { field1: "value1", field2: "value2" }); var viewModel2 = kendo.observable( { field1: "value1", field2: "value2" });
上面两种方式都可以创建ObservableObject
注意：视图模型必须在定义ObservableObject之后使用，否则无效。
设置与获取属性值：
我们可以通过viewModel对象来获取属性值，如下：
var viewModel = kendo.observable({ name: "John Doe" }); viewModel.set("name", "Jane Doe"); //set the "name" field to "Jane Doe" var name = viewModel.get("name"); alert(name); // shows "Jane Doe"
关键字this：
我们可以通过this来获取视图模型的其他属性值，如下：
<span data-bind="text: fullName"></span> <script> var viewModel = kendo.observable({ firstName: "John", lastName: "Doe", fullName: function() { return this.get("firstName") + " " + this.get("lastName"); } }); kendo.bind($("span"), viewModel); </script>
data-bind属性：
attr：
attr可以用来绑定DOM元素的属性，例如：href、title等，对于多个属性我们可以用对象来绑定，如下：
<img id="logo" data-bind="attr: { src: imageSource, alt: imageAlt }" /> <script> var viewModel = kendo.observable({ imageSource: "http://www.telerik.com/image/kendo-logo.png", imageAlt: "Kendo Logo" }); kendo.bind($("#logo"), viewModel); </script>
显示到视图上就会变成如下：
<img id="logo" src="http://www.telerik.com/image/kendo-logo.png" alt="Kendo Logo"" />
checked：
checked属性使用来选择复选框或者单选框，属性值为true或false，如下：
<input type="checkbox" data-bind="checked: isChecked" /> <script> var viewModel = kendo.observable({ isChecked: false }); kendo.bind($("input"), viewModel); </script>
对于多个复选框，根据value值来决定选中哪一个复选框，属性值是一个数组，如下：
<input type="checkbox" value="Red" data-bind="checked: colors" /> <input type="checkbox" value="Green" data-bind="checked: colors" /> <input type="checkbox" value="Blue" data-bind="checked: colors" /> <script> var viewModel = kendo.observable({ colors: ["Red"] }); kendo.bind($("input"), viewModel); </script>
单选框，如下：
<input type="radio" value="Red" name="color" data-bind="checked: selectedColor" /> <input type="radio" value="Green" name="color" data-bind="checked: selectedColor" /> <input type="radio" value="Blue" name="color" data-bind="checked: selectedColor" /> <script> var viewModel = kendo.observable({ selectedColor: "Green" }); kendo.bind($("input"), viewModel); </script>
注意：单选框应该有相同的name值，checked只适合可以勾选的元素。
click：
click属性将绑定一个方法到视图模型上，当点击这个DOM元素该方法将会被调用。
<div id="view"> <span data-bind="click: showDescription">Show description</span> <span data-bind="visible: isDescriptionShown, text: description"></span> <script> var viewModel = kendo.observable({ description: "Description", isDescriptionShown: false, showDescription: function(e) { // show the span by setting isDescriptionShown to true this.set("isDescriptionShown", true); } }); kendo.bind($("#view"), viewModel); </script> </div>
我们也可以通过events属性来绑定click事件，如下：
<span data-bind="click: clickHandler"></span> <span data-bind="events: { click: clickHandler }"></span>
阻止事件冒泡
我们可以使用stopPropagation来阻止click事件冒泡，如下：
<span data-bind="click: click">Click</span> <script> var viewModel = kendo.observable({ click: function(e) { e.stopPropagation(); } }); kendo.bind($("span"), viewModel); </script>
阻止默认事件
使用preventDefault方法来阻止浏览器默认行为。
<a href="http://example.com" data-bind="click: click">Click</span> <script> var viewModel = kendo.observable({ click: function(e) { // stop the browser from navigating to http://example.com e.preventDefault(); } }); kendo.bind($("a"), viewModel); </script>
custom：
kendo MVVM提供自定义绑定属性，这有利于我们自己做一些扩展。我们可以通过kendo.data.Binder来注册一个属性。
单项绑定
这种自定义属性当视图模型的属性值改变时，DOM元素将被更新，但是当DOM元素改变时并不会更新视图模型属性值。如下：
<script> kendo.data.binders.slide = kendo.data.Binder.extend({ refresh: function() { var value = this.bindings["slide"].get(); if (value) { $(this.element).slideDown(); } else { $(this.element).slideUp(); } } }); var viewModel = kendo.observable({ slideValue: true }); kendo.bind(document.body, viewModel); </script> <div id="target" data-bind="slide: slideValue"> One Big Orange Square. </div>
双向绑定
这种自定义的属性支持双向绑定，即当DOM元素改变时会触发视图模型的改变，当视图模型属性值改变时会触发DOM元素的改变。如下：
<script> kendo.data.binders.numericValue = kendo.data.Binder.extend({ init: function(element, bindings, options) { //call the base constructor kendo.data.Binder.fn.init.call(this, element, bindings, options); var that = this; //listen for the change event of the element $(that.element).on("change", function() { that.change(); //call the change function }); }, refresh: function() { var that = this, value = that.bindings["numericValue"].get(); //get the value from the View-Model $(that.element).val(value); //update the HTML input element }, change: function() { var value = this.element.value; //in this example the View-Model will be updated only if the value of the input is a number if (!isNaN(value)) { this.bindings["numericValue"].set(value); //update the View-Model } } }); //View-Model source var viewModel = kendo.observable({ number: 10 }); kendo.bind(document.body, viewModel); </script> <!-- View source --> <input data-bind="numericValue: number" /> Input value: <span data-bind="text: number" />
组件绑定
这种自定义属性支持当视图模型属性值改变时会触发组件的改变。如下：
//the following example demonstrates how to bind the max value of a NumericTextBox widget kendo.data.binders.widget.max = kendo.data.Binder.extend({ init: function(widget, bindings, options) { //call the base constructor kendo.data.Binder.fn.init.call(this, widget.element[0], bindings, options); }, refresh: function() { var that = this, value = that.bindings["max"].get(); //get the value from the View-Model $(that.element).data("kendoNumericTextBox").max(value); //update the widget } }); <!-- View source --> <input data-role="numerictextbox" id="numeric" data-bind="value: value, max: max" />
自定义属性的方法讲解
init
init类似于构造函数，如果这个函数被重写了，其基本构造函数首先被显示调用。
refresh
refresh负责更新DOM元素。当视图模型的属性值改变时，它会被执行。
change
change负责更新视图模型的属性值。DOM元素发生变化时，它会被执行。
disabled：
disabled是禁用DOM元素，属性值为true或false。适合的DOM元素为：input、select、textarea。当DOM元素的disabled属性值被设置为true时，则他的value值不能被改变。
<div id="view"> <input type="text" data-bind="value: name, disabled: isNameDisabled" /> <button data-bind="click: disableInput">Disable</button> <script> var viewModel = kendo.observable({ isNameDisabled: false, name: "John Doe", disableInput: function() { this.set("isNameDisabled", true); } }); kendo.bind($("#view"), viewModel); </script> </div>
注意：0, null, undefined，""，''都会被当成false。
enable：
与disabled相同，功能相反。
events：
events将视图模型定义的方法绑定到DOM元素上，当对应事件在DOM元素发生时，该方法会被执行。如下：
<div id="view"> <span data-bind="events: { mouseover: showDescription, mouseout: hideDescription }">Show description</span> <span data-bind="visible: isDescriptionShown, text: description"></span> </div> <script> var viewModel = kendo.observable({ description: "Description", isDescriptionShown: false, showDescription: function(e) { // show the span by setting isDescriptionShown to true this.set("isDescriptionShown", true); }, hideDescription: function(e) { // hide the span by setting isDescriptionShown to false this.set("isDescriptionShown", false); } }); kendo.bind($("#view"), viewModel); </script>
html：
html是将视图模型定义的值以html的形式插入到DOM元素内。如下：
<span data-bind="html: name"></span> <script> var viewModel = kendo.observable({ name: "<strong>John Doe</strong>" }); kendo.bind($("span"), viewModel); </script>
结果为
<span><strong>John Doe</strong></span>
注意：并不是所有DOM元素都支持html属性，比如table。他只适合内部没有固定结构的html元素。
invisible：
invisible控制DOM元素是否显示。属性值true或false，当设置为true时，DOM元素将被隐藏，对应css的display属性将被设置为none。如下：
<div id="view"> <div data-bind="invisible: isInvisible">some content </div> <button data-bind="click: show">Show</button> </div> <script> var viewModel = kendo.observable({ isInvisible: true, show: function() { this.set("isInvisible", false); } }); kendo.bind($("#view"), viewModel); </script>
初始div元素是隐藏的，因为isInvisible设置为true，当点击按钮时，isInvisible被设置为false，div元素显示。
source：
source用来渲染DOM元素的模板，模板是通过data-template属性来指定，属性值为模板的id，如果未指定则会根据元素的name值。如果视图模型中的属性值为数组时，会自动循环每一项并渲染模板到DOM元素内。
<ul data-template="ul-template" data-bind="source: products"> </ul> <script id="ul-template" type="text/x-kendo-template"> <li> id: <span data-bind="text: id"></span> name: <span data-bind="text: name"></span> </li> </script> <script> var viewModel = kendo.observable({ products: [ { id: 1, name: "Coffee" }, { id: 2, name: "Tea" }, { id: 3, name: "Juice" } ] }); kendo.bind($("ul"), viewModel); </script>
结果为
<ul> <li> id: <span>1</span> name: <span>Coffee</span> </li> <li> id: <span>2</span> name: <span>Tea</span> </li> <li> id: <span>3</span> name: <span>Juice</span> </li> </ul>
如果数组中不全是对象，则可以使用this代替当前属性值，如下：
<ul data-template="ul-template" data-bind="source: products"> </ul> <script id="ul-template" type="text/x-kendo-template"> <li data-bind="text: this"></li> </script> <script> var viewModel = kendo.observable({ products: [ "Coffee", "Tea", "Juice" ] }); kendo.bind($("ul"), viewModel); </script>
结果为
<ul> <li>Coffee</li> <li>Tea</li> <li>Juice</li> </ul>
给select元素设置source属性：
<select data-text-field="name" data-value-field="id" data-bind="source: products"></select> <script> var viewModel = kendo.observable({ products: [ { id: 1, name: "Coffee" }, { id: 2, name: "Tea" }, { id: 3, name: "Juice" } ] }); kendo.bind($("select"), viewModel); </script>
显示在视图上为
<select> <option value="1">Coffee</option> <option value="2">Tea</option> <option value="3">Juice</option> </select>
style：
style属性用来设置DOM元素的样式，如下：
<span data-bind="style: {color: priceColor, fontWeight: priceFontWeight}, text: price"></span> <script> var viewModel = kendo.observable({ price: 42, priceColor: function() { var price = this.get("price"); if (price <= 42) { return "#00ff00"; } else { return "#ff0000"; } }, priceFontWeight: function() { var price = this.get("price"); if (price <= 42) { return "bold"; } else { return ""; //will reset the font weight to its default value } } }); kendo.bind($("span"), viewModel); </script>
结果为
<span style="color: #00ff00; font-weight: bold">42</span>
注意：对于这种font-weight, font-size, background-color应该使用驼峰格式。
text：
text用来设置元素文本内容，如下：
<span data-bind="text: name"></span> <script> var viewModel = kendo.observable({ name: "John Doe" }); kendo.bind($("span"), viewModel); </script>
结果为
<span>John Doe</span>
value：
value属性用来设置DOM元素的value值，所以他只适合带有value属性的DOM元素，比如input, textarea和select。此属性是双向绑定的，即任何一方改变都会触发另一方的改变。如下：
<div id="view"> <input data-bind="value: inputValue" /> <textarea data-bind="value: textareaValue"></textarea> </div> <script> var viewModel = kendo.observable({ inputValue: "Input value", textareaValue: "Textarea value" }); kendo.bind($("#view"), viewModel); </script>
注意：如果DOM元素改变并不是实时触发视图模型的属性值改变，而是当DOM元素变换结束之后。
我们可以通过data-value-update属性控制什么时候更新视图模型，如下：
<div id="view"> <input data-value-update="keyup" data-bind="value: inputValue" /> </div> <script> var viewModel = kendo.observable({ inputValue: "InputValue" }); kendo.bind($("#view"), viewModel); </script>
上面的代码是当我们在输入框松开键盘之后就更新视图模型。
对于下拉选择，我们可以像下面这样
<select data-role="dropdownlist" data-option-label="Select product..." data-value-primitive="true" data-value-field="id" data-text-field="name" data-bind="value: selectedProductId, source: products"> </select> <script> var viewModel = kendo.observable({ selectedProductId: null, products: [ { id: 1, name: "Coffee" }, { id: 2, name: "Tea" }, { id: 3, name: "Juice" } ] }); kendo.bind($("select"), viewModel); </script>
visible：
与invisible类似，功能相反。
小结：
MVVM解耦了视图与模型，我们只需要在模型中写好逻辑即可。这种模式简化了我们的开发，提高开发效率。input，select，textarea的值用value，插入html用html，文本用text，checkbox和radio用checked。
