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。