ListView JSP Tag Overview

The ListView JSP tag is a server-side wrapper for the Kendo UI ListView widget.

Telerik UI for JSP DevCraft image

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>

See Also

In this article