RadTimeline Object

Updated on Mar 2, 2026

This article lists the client-side API of RadTimeline and how to use it.

To use the API, you must first get a reference to the control's client-side object. For example:

JavaScript

var timelineObject = $find("<%=RadTimeline1.ClientID %>");

RadTimeline is a server-side wrapper over the Kendo UI Timeline Widget. Thus, it exposes the API of the underlying Kendo widget. To get a reference to the Kendo widget instance, you can do either of the following:

• Use the get_kendoWidget() method of the MS AJAX wrapper:

  JavaScript

    var timelineObject  = $find("<%=RadTimeline1.ClientID %>"); //the standard script control object
    var kendoTimeline = timelineObject.get_kendoWidget(); //the Kendo widget

• Get the Kendo Widget in its usual way. Make sure to use the $telerik._kendo.jQuery reference that has the Kendo widget data:

  JavaScript

    var kendoTimeline = $telerik._kendo.jQuery("#<%=RadTimeline1.ClientID %>").data("kendoTimeline"); //the jQuery selector must get the RadTimeline1 wrapper span element

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.

In addition to using the Kendo method directly, you can also use their wrappers that follow the MS AJAX convention through the RadTimeline client object.

Table1: Client-side methods exposed by the MS AJAX RadTimeline object

Name	Parameters	Return Type	Description
collapse	object	none	Collapses an event in vertical mode. See the underlying collapse method for more details on its behavior.
expand	object	none	Expands an event in vertical mode. See the underlying expand method for more details on its behavior.
dispose	none	none	Disposes the Timeline client-side object (calls its underlying Kendo widget's destroy method). Once you call it, you will not be able to use the widget or control.
get_clientDataSource	none	RadClientDataSource	Returns a reference to the underlying RadClientDataSource control.
get_kendoWidget	none	object	Returns a reference to the underlying Kendo Timeline widget.
get_items	none	jQuery collection	Returns a jQuery collection of the DOM elements of the visible Timeline events.
get_dataItems	none	collection	Returns a collection of the data items available in the underlying data source.
get_orientation	none	Number	Returns the orienation of the timeline axis. The possible return values are 0 = Vertical and 1 = Horizontal
next	none	none	Switches to the next portion of events with animation in horizontal mode.
open	object	none	Opens event details in horizontal mode.
previous	none	none	Switches to the previous portion of events with animation in horizontal mode.
rеpaint	none	none	Redraws the Timeline widget.

See Also

• Live Demo - RadTimeline Client-side API

• RadTimeline Client-side Events