Chart JSP Tag Overview
The Chart JSP tag is a server-side wrapper for the Kendo UI Chart widget.
The Chart 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 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>