Chart JSP Tag Overview

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

Getting Started

Configuration

Below are listed the steps for you to follow when configuring the Kendo UI Chart 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 InternetUsers list as the model.

    @RequestMapping(value = {"/", "/index"}, method = RequestMethod.GET)
    public String index(Model model) {
        model.addAttribute("viewModel", ChartDataRepository.InternetUsers());

        return "/dataviz/bar-charts/local-data";
    }

Step 3 Add a server-bound chart.

    <kendo:chart name="chart">
         <kendo:dataSource data="${viewModel}" />
         <kendo:chart-series>
            <kendo:chart-seriesItem type="bar" field="value" colorField="color" name="United States">
                <kendo:chart-seriesItem-labels format="{0}%" visible="true" />
            </kendo:chart-seriesItem>
         </kendo:chart-series>
         <kendo:chart-categoryAxis>
            <kendo:chart-categoryAxisItem field="year" />
         </kendo:chart-categoryAxis>
    </kendo:chart>

Event Handling

Subscribe to Events

You can subscribe to all events exposed by Kendo UI Chart by the handler name.

<kendo:chart name="chart" dataBound="internetUsersChart_dataBound"
                          seriesClick="internetUsersChart_seriesClick">
     <kendo:dataSource data="${viewModel}" />
     <kendo:chart-series>
        <kendo:chart-seriesItem type="bar" field="value" colorField="color" name="United States">
            <kendo:chart-seriesItem-labels format="{0}%" visible="true" />
        </kendo:chart-seriesItem>
     </kendo:chart-series>
     <kendo:chart-categoryAxis>
    <kendo:chart-categoryAxisItem field="year" />
     </kendo:chart-categoryAxis>
</kendo:chart>

<script>
    function internetUsersChart_dataBound() {
        // Handle the dataBound event
    }

    function internetUsersChart_seriesClick() {
        // Handle the series click event
    }
</script>

Reference

Existing Instances

You are able to reference an existing Chart instance via the jQuery.data(). Once a reference is established, you are able to use the Chart API to control its behavior.

// Put this after your Kendo StockChart tag
<script>
    $(function() {
        // Notice that the Name() of the chart is used to get its client-side instance
        var chart = $("#internetUsersChart").data("kendoChart");
    });
</script>

See Also

In this article