DIV CSS 佈局教程網

 DIV+CSS佈局教程網 >> 網頁腳本 >> JavaScript入門知識 >> 關於JavaScript >> Knockout自定義綁定創建方法
Knockout自定義綁定創建方法
編輯:關於JavaScript     

概述

除了上一篇列出的KO內置的綁定類型(如value、text等),你也可以創建自定義綁定。

注冊你的binding handler

ko.bindingHandlers.yourBindingName = {
  init: function(element, valueAccessor, allBindings, 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, allBindings, viewModel, bindingContext) {
    // This will be called once when the binding is first applied to an element,
    // and again whenever any observables/computeds that are accessed change
    // Update the DOM element based on the supplied values here.
  }
}; 

接下來你就可以在任意dom元素上使用的自定義綁定了:

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

注意:你不必在你的handler裡把init和update的callback都提供,可以提供任意一個。

update callback

顧名思義,當你的監控屬性observable更新的時候,ko會自動調用你的update回調。

它有以下參數:

    element:使用這個綁定的dom元素;

    valueAccessor  : 通過調用valueAccessor()可以獲得當前綁定的model屬性值,調用ko.unwrap(valueAccessor())能夠更方便的獲取observable的值和普通值;

    allBindings : 綁定到這個dom元素上的model的所有屬性值,例如調用callBindings.get('name') 返回綁定的name屬性值(不存在返回undefined),或者調用allBindings.has('name')判斷name是否綁定到了當前的dom中;

    viewModel  : 在Knockout.3x中以棄用,可用bindingContext.$data或者bindingContext.$rawData來獲取當前的viewModel;

   bindingContext  : 綁定上下文,可調用bindingContext.$data、 bindingContext.$parent, bindingContext.$parents等獲取數據;

接下來看一個例子,你也許希望使用visible綁定來控制元素的可見性,並且加上動畫效果,這時你可以創建你的自定義綁定:

ko.bindingHandlers.slideVisible = {
  update: function(element, valueAccessor, allBindings) {
    // First get the latest data that we're bound to
    var value = valueAccessor();
    // Next, whether or not the supplied model property is observable, get its current value
    var valueUnwrapped = ko.unwrap(value);
    // Grab some more data from another binding property
    var duration = allBindings.get('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
  }
}; 

然後你可以這樣使用這個自定義綁定:

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

init callback

ko將為每個使用綁定的dom元素調用你的init函數,它有兩個主要用途:

(1)為dom元素設置初始化狀態;

(2)注冊一些事件處理程序,例如:當用戶點擊或者修改dom元素時,你可以改變監控屬性的狀態;

ko將使用和update回調完全相同一組參數。

繼續前面的例子,你也許想讓slideVisible在頁面第一次顯示的時候就設置該元素的可見性狀態(沒有任何動畫效果),而動畫效果是在以後改變的時候執行,你可以按照下面的方式來做:

ko.bindingHandlers.slideVisible = {
  init: function(element, valueAccessor) {
    var value = ko.unwrap(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, allBindings) {
    // Leave as before
  }
}; 

giftWrap被初始化定義為false(ko.observable(false)),關聯的DIV會在初始化的時候隱藏,之後用戶點擊checkbox時才讓DIV顯示。

你現在已經知道如何使用update回調了,當observable值改變的時候你可以更新dom元素。我們現在可以用另外的方法來做,比如當用戶有某個action操作時,也能引起你的observable值更新,例如:

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.unwrap(value))
      element.focus();
    else
      element.blur();
  }
}; 

現在你可以通過元素的“focusedness”綁定來讀寫你的observable值了。

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

以上內容是小編給大家分享的Knockout自定義綁定創建方法,希望大家喜歡。

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