AutoComplete JSP Tag Overview
The AutoComplete JSP tag is a server-side wrapper for the Kendo UI AutoComplete widget.
Getting Started
The Basics
There are two ways to bind a Kendo UI AutoComplete:
-
server
—The data is serialized to the client. No Ajax requests are going to be made. -
ajax
—The AutoComplete is going to make Ajax requests to get the data. For more information on this type of binding, refer to the AutoComplete API reference article on Ajax binding.
Configuration
Below are listed the steps for you to follow when configuring the Kendo UI AutoComplete for binding to data, passed as a model attribute in Spring MVC.
Step 1 Make sure you followed all the steps from the introductory article on Telerik UI for JSP.
Step 2 Create a new action method and pass the Products table to the View.
@RequestMapping(value = {"index"}, method = RequestMethod.GET)
public String index(Model model) {
model.addAttribute("products", product.getList());
return "web/autocomplete/index";
}
Step 3 Add the Kendo UI taglib
mapping to the page.
<%@taglib prefix="kendo" uri="https://www.telerik.com/kendo-ui/jsp/tags"%>
Step 4 Add a server-bound AutoComplete.
<kendo:autoComplete name="productAutoComplete" dataTextField="productName">
<kendo:dataSource data="${products}"></kendo:dataSource>
</kendo:autoComplete>
Event Handling
Subscribe to Events
You can subscribe to all events exposed by Kendo UI AutoComplete by the handler name.
<kendo:autoComplete name="productAutoComplete" dataTextField="productName" change="autocomplete_change">
<kendo:dataSource data="${products}">
</kendo:dataSource>
</kendo:autoComplete>
<script>
function autocomplete_change() {
//Handle the change event
}
</script>
Reference
Existing Instances
You are able to reference an existing AutoComplete instance via the jQuery.data()
. Once a reference is established, you are able to use the AutoComplete API to control its behavior.
//Put this after your Kendo AutoComplete tag declaration
<script>
$(function() {
// Notice that the Name() of the autocomplete is used to get its client-side instance
var autocomplete = $("#productAutoComplete").data("kendoAutoComplete");
});
</script>