Kendo UI for jQuery使用教程：方法和事件

Kendo UI目前最新提供Kendo UI for jQuery、Kendo UI for Angular、Kendo UI Support for React和Kendo UI Support for Vue四个控件。Kendo UI for jQuery是创建现代Web应用程序的最完整UI库。

所有Kendo UI小部件都提供可用于在运行时查询或修改其状态的方法和事件。

获取Widget实例

使用jQuery数据方法
使用getKendo <WidgetName>方法

jQuery数据方法

The Kendo UI widgets是jQuery插件，获取对窗口小部件实例的引用常用方法是使用jQuery数据方法并将插件名称作为字符串传递。

<p>Animal: <input id="animal" /></p>
<script>
  $(function() {
  // create a new widget instance
  $("#animal").kendoAutoComplete({ dataSource: [ "Ant", "Antilope", "Badger", "Beaver", "Bird" ] });
// retrieve the widget instance
  var autoComplete = $("#animal").data("kendoAutoComplete");
console.log(autoComplete);
  });
  </script>

getKendo方法

要获取对窗口小部件实例的引用，您还可以使用getKendo <WidgetName>方法。请注意，返回所选DOM元素的jQuery约定也适用于窗口小部件初始化插件方法。这意味着插件方法（例如kendoAutoComplete（））不返回窗口小部件实例，而是返回使用该方法的jQuery选择器。

<p>Animal: <input id="animal" /></p>
<script>
  $(function() {
  // create a new widget instance
  $("#animal").kendoAutoComplete({ dataSource: [ "Ant", "Antilope", "Badger", "Beaver", "Bird" ] });
// retrieve the widget instance
  var autoComplete = $("#animal").getKendoAutoComplete();
console.log(autoComplete);
  });
  </script>

使用方法

在窗口小部件实例可用后，您可以使用标准JavaScript方法语法调用其方法。 API参考部分中提供了窗口小部件方法和方法参数的完整列表和示例。如果返回窗口小部件实例的代码返回undefined，则窗口小部件尚未初始化。例如，如果在document.ready处理程序中创建窗口小部件但是从先前执行的代码引用窗口小部件实例，则可能发生此类问题。

<p>Animal: <input id="animal" /></p>
<script>
  $(function() {
  $("#animal").kendoAutoComplete({ dataSource: [ "Ant", "Antilope", "Badger", "Beaver", "Bird" ] });
var autoComplete = $("#animal").data("kendoAutoComplete");
// focus the widget
  autoComplete.focus();
  });
  </script>

处理Widget事件

每个小部件根据其特定功能公开不同的事件。例如，AutoComplete小部件会触发change，close，dataBound等。您可以在窗口小部件初始化期间或窗口小部件初始化之后传递事件处理程序。使用Kendo UI小部件的事件时，还可以使用事件处理程序参数，阻止事件和取消绑定事件。

初始化期间绑定事件

每次触发事件时，都会执行在窗口小部件初始化期间附加的事件处理程序。要仅执行一次处理程序，请在使用一种方法进行窗口小部件初始化后附加它。

<p>Animal: <input id="animal" /></p>
<script>
  $(function() {
$("#animal").kendoAutoComplete({
  dataSource: [ "Ant", "Antilope", "Badger", "Beaver", "Bird" ],
  change: function(e) {
  console.log("change event handler");
  }
  });
});
  </script>

初始化后绑定事件

所有Kendo UI小部件都提供绑定和一种方法。这两种方法都将事件处理程序附加到现有的窗口小部件实例，但是附加一个事件处理程序的处理程序只会执行一次。

<p>Animal: <input id="animal" /></p>
<script>
  $(function() {
$("#animal").kendoAutoComplete({
  dataSource: [ "Ant", "Antilope", "Badger", "Beaver", "Bird" ]
  });
// ...
var autocomplete = $("#animal").data("kendoAutoComplete");
// Attach an event handler that will be executed each time the event is fired.
  autocomplete.bind("change", function(e) {
  console.log("change event handler");
  });
// Attach an event handler that will be executed only the first time the event is fired.
  autocomplete.one("open", function(e) {
  console.log("open event handler");
  });
});
  </script>

使用事件处理程序参数

每个Kendo UI小部件都将一个参数传递给事件处理程序 - 即所谓的“事件对象”。通常，它有一个或多个字段，其中包含事件的特定信息。所有事件对象都有一个sender字段，该字段提供对触发事件的窗口小部件实例的引用。不支持将其他自定义事件参数传递给处理程序，API参考部分中提供了窗口小部件事件的完整列表和示例以及事件对象中的字段。

<p>Animal: <input id="animal" /></p>
<script>
  $(function() {
$("#animal").kendoAutoComplete({
  dataSource: [ "Ant", "Antilope", "Badger", "Beaver", "Bird" ],
  open: function(e) {
  var autocomplete = e.sender;
  }
  });
});
  </script>

预防事件

通过调用事件对象的preventDefault方法可以防止某些窗口小部件事件。事件预防的效果特定于每个事件，并在API参考中记录。

<p>Animal: <input id="animal" /></p>
<script>
  $(function() {
  $("#animal").kendoAutoComplete({
  dataSource: [ "Ant", "Antilope", "Badger", "Beaver", "Bird" ]
  });
var autoComplete = $("#animal").data("kendoAutoComplete");
// prevent the autocomplete from opening the suggestions list
  autoComplete.bind('open', function(e) {
  e.preventDefault();
  });
  });
  </script>

从事件中解除绑定

要取消绑定特定事件，请保持对事件处理函数的引用，并使用它调用unbind方法。请注意，在没有任何参数的情况下调用unbind方法会从事件中取消绑定所有事件处理程序。

<p>Animal: <input id="animal" /></p>
<button id="unbindButton">Unbind event</button>
<script>
  $(function() {
  var handler = function(e) { console.log(e); };
  $("#animal").kendoAutoComplete({ dataSource: [ "Ant", "Antilope", "Badger", "Beaver", "Bird" ] });
var autoComplete = $("#animal").data("kendoAutoComplete");
autoComplete.bind("open", handler);
$("#unbindButton").on("click", function() {
  autoComplete.unbind("open", handler);
  });
  });
  </script>