# Client-side Programming Overview

This help article lists the [ASP.NET AJAX Chart's](https://www.telerik.com/products/aspnet-ajax/html-chart.aspx) public client-side methods that let you access and modify the control's height, width, data source, transitions, etc.; shows how to reference and use the **RadHtmlChart** client-side object (**Examples 1-2**); and provides an example about modifying the data source of **RadHtmlChart** on the client (**Example 3**).

**RadHtmlChart** for ASP.NET AJAX is based on the [Kendo UI Data Visualization Chart Widget](https://demos.telerik.com/kendo-ui/area-charts/index). Thus, it exposes the [client-side API and methods offered by the widget](https://docs.telerik.com/kendo-ui/api/dataviz/chart) and mainly provides a wrapper and API for working with the chart on the server (programmatic creation, data binding, declaring in the markup).

## Public Methods

| **Name**               | **Description**                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **getSVGString**       | Returns the SVG rendering of the control, regardless of the browser. Useful for [exporting scenarios](https://www.telerik.com/products/aspnet-ajax/documentation/knowledge-base/htmlchart-exporting-to-png-and-pdf).                                                                                                                                                                                                      |
| **loadData**           | Invokes a light callback to the server to obtain the **RadHtmlChart** data. This is used when the server-side **InvokeLoadData** property is set to **FromCode** . In this case, the data is not sent to the client at all until this method is called.                                                                                                                                                                   |
| **repaint**            | Redraws the chart. Useful when the chart is in an invisible container that is shown on a certain condition, when a client-side databinding is performed or to replay the initial animation.                                                                                                                                                                                                                               |
| **get_dataSourceJSON** | Gets a stringified JSON object with the data source of a databound **RadHtmlChart** . **Tip:** You can parse this to a JSON object through a jQuery parseJSON method in order to manipulate it as an array.                                                                                                                                                                                                               |
| **get_height**         | Gets the height of the chart.                                                                                                                                                                                                                                                                                                                                                                                             |
| **get_width**          | Gets the width of the chart.                                                                                                                                                                                                                                                                                                                                                                                              |
| **get_transitions**    | Gets a boolean value indicating whether an animation is played when the chart is rendered.                                                                                                                                                                                                                                                                                                                                |
| **set_dataSource**     | Databinds the **RadHtmlChart** to the new data source that is passed as a parameter. This can be a JSON string or an array of JSON objects. The fields in the JSON objects must match the chart's properties – their names are set through the **DataFieldY** , **ColorField** , **NameField** and **ExplodeField** properties. In order to refresh the chart with the new data, the **repaint()** method must be called. |
| **set_height**         | Sets new height to the chart.                                                                                                                                                                                                                                                                                                                                                                                             |
| **set_width**          | Sets new width to the chart.                                                                                                                                                                                                                                                                                                                                                                                              |
| **set_transitions**    | Sets a boolean value indicating whether an animation is played when the chart is rendered.                                                                                                                                                                                                                                                                                                                                |
| **get_kendoWidget**    | Gets a reference to the Kendo Chart widget.                                                                                                                                                                                                                                                                                                                                                                               |

**RadHtmlChart** for ASP.NET AJAX, through the Kendo widget, exposes the [Kendo Chart client-side methods](https://docs.telerik.com/kendo-ui/api/dataviz/chart#methods).

## Get Client-side Object Reference

There are two ways to get a reference to the Kendo Chart widget in order to use its API:

* Use the **get_kendoWidget** method the **RadHtmlChart** client-side object exposes. You can get the **RadHtmlChart** object through the **$find()** MS AJAX method.

  > caption **Example 1:** Get the Kendo Chart object through the get_kendoWidget method.

  ```JavaScript
  var radHtmlChartObject = $find("<%=RadHtmlChart1.ClientID %>"); //the standard script control object
  var kendoChart = radHtmlChartObject.get_kendoWidget(); //the Kendo widget
  ```

* Use the standard Kendo approach for getting the widget through the data-attributes of the DOM element:

  > caption **Example 2:** Get the Kendo Chart object through the data attribute of the DOM object.

  ```JavaScript
  var kendoChart = $telerik._kendo.jQuery("#<%=RadHtmlChart1.ClientID %>").data("kendoChart");//the jQuery selector must get the RadHtmlChart wrapping div element
  ```

> important As of the 2026 Q1 release, Kendo jQuery widget plugins and data are registered on `$telerik._kendo.jQuery` — a different jQuery instance from `$telerik.$`. If you use `$telerik.$` with `.data("kendoXxx")`, it will return `undefined`. Always use `$telerik._kendo.jQuery` when accessing the underlying Kendo widget via the `.data()` method. The recommended approach, however, is to use the `get_kendoWidget()` method shown above.

> note  **RadHtmlChart** is an IScriptControl based on MS AJAX and so it instantiates its client-side object (i.e., the Kendo Chart) during the`Sys.Application.Init`event. This means that the earliest event in which you can reference the chart widget is **Sys.Application.Load** .

## Modify the RadHtmlChart's Data Source on the Client

**Example 3** below demonstrates a way to change the data source of a **RadHtmlChart** using its client-side API. Once you set the desired data source to the control, you have to invoke its **repaint()** method, ensuring that the control will be redrawn with the new data.

> caption Example 3: Client-side change of **RadHtmlChart**'s data source.

```ASP.NET
<script type="text/javascript">
	function OnClientClicked1() {

		var newDataSource = [
		{
			"Data": 35,
			"Fruit": "Apple",
			"Color": "Green",
			"IsExploded": false
		},
		{
			"Data": 20,
			"Fruit": "Orange",
			"Color": "Orange",
			"IsExploded": true
		}]

		   var RadHtmlChart1 = $find('<%=RadHtmlChart1.ClientID %>');

		   //Parsing the current datasource to an array of JavaScript objects and storing it to a variable 
		   var oldDataSource = eval(RadHtmlChart1.get_dataSourceJSON());

		   //Retaining the first Item of the datasource
		   newDataSource[0] = oldDataSource[0];

		   //Set the new datasource      
		   RadHtmlChart1.set_dataSource(newDataSource);

		   //Turning animation on before repainting the chart
		   RadHtmlChart1.set_transitions(true);

		   //Redrawing the chart
		   RadHtmlChart1.repaint();
	}
</script>
<telerik:RadHtmlChart runat="server" ID="RadHtmlChart1" Transitions="false" Width="450"
Height="450">
	<PlotArea>
		<Series>
			<telerik:PieSeries DataFieldY="Data" ColorField="Color" NameField="Fruit"
				ExplodeField="IsExploded">
			</telerik:PieSeries>
		</Series>
	</PlotArea>
</telerik:RadHtmlChart>
<telerik:RadButton RenderMode="Lightweight" runat="server" Text="ChangeDataSource" AutoPostBack="false" OnClientClicked="OnClientClicked1">
</telerik:RadButton>
```

```C#
protected void Page_Load(object sender, EventArgs e)
{
	RadHtmlChart1.DataSource = GetData();
	RadHtmlChart1.DataBind();
}

protected DataTable GetData()
{
	DataTable tbl = new DataTable();
	tbl.Columns.Add(new DataColumn("Data"));
	tbl.Columns.Add(new DataColumn("Fruit"));
	tbl.Columns.Add(new DataColumn("Color"));
	tbl.Columns.Add(new DataColumn("IsExploded"));

	tbl.Rows.Add(new object[] { 50, "Peach", "Yellow", true });
	tbl.Rows.Add(new object[] { 10, "Cherry", "Red", false });

	return tbl;
}
```

```VB
Protected Sub Page_Load(sender As Object, e As EventArgs) Handles Me.Load
	RadHtmlChart1.DataSource = GetData()
	RadHtmlChart1.DataBind()
End Sub

Protected Function GetData() As DataTable
	Dim tbl As New DataTable()
	tbl.Columns.Add(New DataColumn("Data"))
	tbl.Columns.Add(New DataColumn("Fruit"))
	tbl.Columns.Add(New DataColumn("Color"))
	tbl.Columns.Add(New DataColumn("IsExploded"))

	tbl.Rows.Add(New Object() {50, "Peach", "Yellow", True})
	tbl.Rows.Add(New Object() {10, "Cherry", "Red", False})

	Return tbl
End Function
```

## See Also

* [Basic Configuration of the RadHtmlChart](https://www.telerik.com/products/aspnet-ajax/documentation/controls/htmlchart/server-side-programming/basic-configuration)

* [RadHtmlChart Client-side Events Basics](https://www.telerik.com/products/aspnet-ajax/documentation/controls/htmlchart/client-side-programming/events/overview)

* [Kendo Chart Widget First Look](https://demos.telerik.com/kendo-ui/area-charts/index)

* [Kendo Chart Client-side API Reference](https://docs.telerik.com/kendo-ui/api/dataviz/chart)

* [Kendo Chart Client-side Events](https://docs.telerik.com/kendo-ui/api/dataviz/chart#events)

* [Kendo Chart Client-side Methods](https://docs.telerik.com/kendo-ui/api/dataviz/chart#methods)
