ListView JSP Tag Overview
The ListView JSP tag is a server-side wrapper for the Kendo UI ListView widget.
The ListView is part of Telerik UI for JSP, a
professional grade UI library with 90+ components for building modern and feature-rich applications. To try it out sign up for a free 30-day trial.
Getting Started
Configuration
Below are listed the steps for you to follow when configuring the Kendo UI Grid 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(Locale locale, Model model) {
model.addAttribute("products", product.getList());
return "web/listview/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 ListView.
<kendo:listView name="listView" template="template" pageable="true">
<kendo:dataSource pageSize="12" data="${products}">
</kendo:dataSource>
</kendo:listView>
Step 5 Add the ListView item template.
<script type="text/x-kendo-tmpl" id="template">
<div class="product">
<img src="../../resources/web/foods/#=productId#.jpg" alt="#=productName# image" />
<h3>#=productName#</h3>
<p>#=kendo.toString(unitPrice, "c")#</p>
</div>
</script>
Event Handling
Subscribe to Events
You can subscribe to all events exposed by Kendo UI ListView by the handler name.
<kendo:listView name="listView" template="template" pageable="true"
dataBound="listView_dataBound" change="listView_change">
<kendo:dataSource pageSize="12" data="${products}">
</kendo:dataSource>
</kendo:listView>
<script>
function listView_dataBound() {
//Handle the dataBound event
}
function listView_change() {
//Handle the change event
}
</script>
Reference
Existing Instances
You are able to reference an existing ListView instance via the jQuery.data()
. Once a reference is established, you are able to use the ListView API to control its behavior.
//Put this after your Kendo ListView tag declaration
<script>
$(function() {
// Notice that the name attribute of the grid is used to get its client-side instance
var listview = $("#listView").data("kendoListView");
});
</script>