Knockoutjs实战开发：创建自定义绑定(Creating custom bindings)

在使用Knockoutjs时我们并不仅仅限于使用内建的绑定，比如：click、value等，我们可以创建自己的绑定规则。Knockoutjs为我们提供了非常灵活的支持，能够让我们自己去处理非常复杂的业务并且构造出可重用性的绑定。例如我们可以创建交互式的组件，比如表格、网格等。下面我们就来看看怎么一步步创建自定义绑定。

一、等级我们的绑定(Registering your binding)

我们可以通过ko.bindingHandlers来进行绑定。

ko.bindingHandlers.yourBindingName = { 
    init: function(element, valueAccessor, allBindingsAccessor, viewModel, bindingContext) { 
        // This will be called when the binding is first applied to an element 
        // Set up any initial state, event handlers, etc. here 
    }, 
    update: function(element, valueAccessor, allBindingsAccessor, viewModel, bindingContext) { 
        // This will be called once when the binding is first applied to an element, 
        // and again whenever the associated observable changes value. 
        // Update the DOM element based on the supplied values here. 
    } 
};

接着我们就可以在DOM元素中使用我们自定义的绑定了。

<div data-bind="yourBindingName: someValue"> </div>

注：在实际使用中你不用同时提供init和update两个方法，在使用时你只需要提供其中的一个也可以。
下面我们就介绍一下这两个函数。

（1）、update

当你所绑定的组件的值改变时，会自动调用update回调函数，并且传递一下的参数：

  （a）、element：被绑定的DOM element

  （b）、valueAccessor：这是一个JavaScript函数，在这个函数中你可以得到你所绑定的当前元素的属性的值。

  （c）、allBindingsAccessor：通过此JavaScript函数，我们可以得到绑定到此DOM element上的所有属性的值。

  （d）、viewModel：将试图模型对象传递给ko.applyBindings。如果在一个嵌套的元素中使用的话，此参数代表的是当前的数据项，比如：在with:person中，此参数代表person。

  （e）、bindingContext：一个包含对这个元素可用的上下文的对象，这个对象中包含了一些特殊的属性，比如：$parent、$parents、$root等。

我们之前曾经使用visible来控制一个绑定是否显示，此时我们可以通过自定义绑定实现动态的效果，比如出现和消失时都采用滑动的效果，我们则可以这样定义自己的方法：

ko.bindingHandlers.slideVisible = { 
    update: function(element, valueAccessor, allBindingsAccessor) { 
        // First get the latest data that we're bound to 
        var value = valueAccessor(), allBindings = allBindingsAccessor(); 
          
        // Next, whether or not the supplied model property is observable, get its current value 
        var valueUnwrapped = ko.utils.unwrapObservable(value);  
          
        // Grab some more data from another binding property 
        var duration = allBindings.slideDuration || 400; // 400ms is default duration unless otherwise specified 
          
        // Now manipulate the DOM element 
        if (valueUnwrapped == true)  
            $(element).slideDown(duration); // Make the element visible 
        else 
            $(element).slideUp(duration);   // Make the element invisible 
    } 
};

在这里我们使用了jQuery的slideDown和slideUp函数。
现在我们就可以使用自己的绑定功能了：

<div data-bind="slideVisible: giftWrap, slideDuration:600">You have selected the option</div> 
<label><input type="checkbox" data-bind="checked: giftWrap" /> Gift wrap</label> 
  
<script type="text/javascript"> 
    var viewModel = { 
        giftWrap: ko.observable(true) 
    }; 
    ko.applyBindings(viewModel); 
</script>

（2）、init
通过init函数我们可以在实例DOM元素的时候去做一些事情，我们经常在以下两种情况使用init函数：

（a）、为DOM elements设置初始状态。

（b）、注册事件处理程序，这样当用户点击绑定的DOM elements时就会触动对应的事件，我们也可以对其作出反映。

我们可以为上例增加一个init函数，当页面初次加载时我们可以控制是否显示组件：

ko.bindingHandlers.slideVisible = { 
    init: function(element, valueAccessor) { 
        var value = ko.utils.unwrapObservable(valueAccessor()); // Get the current value of the current property we're bound to 
        $(element).toggle(value); // jQuery will hide/show the element depending on whether "value" or true or false 
    }, 
    update: function(element, valueAccessor, allBindingsAccessor) { 
        // Leave as before 
    } 
};

二、在DOM事件后修改可见值。
前面我们已经介绍了如何使用update，这样当一个DOM元素更新时我们可以作出对应的更新，但是我们怎么定义到某个具体的值呢，此时我们就可以使用如下的方法：

ko.bindingHandlers.hasFocus = { 
    init: function(element, valueAccessor) { 
        $(element).focus(function() { 
            var value = valueAccessor(); 
            value(true); 
        }); 
        $(element).blur(function() { 
            var value = valueAccessor(); 
            value(false); 
        });            
    }, 
    update: function(element, valueAccessor) { 
        var value = valueAccessor(); 
        if (ko.utils.unwrapObservable(value)) 
            element.focus(); 
        else
            element.blur(); 
    } 
};

此时我们就可以在UI进行使用了：

<p>Name: <input data-bind="hasFocus: editingName" /></p> 
  
<!-- Showing that we can both read and write the focus state --> 
<div data-bind="visible: editingName">You're editing the name</div> 
<button data-bind="enable: !editingName(), click:function() { editingName(true) }">Edit name</button> 
  
<script type="text/javascript"> 
    var viewModel = { 
        editingName: ko.observable() 
    }; 
    ko.applyBindings(viewModel); 
</script>