Edit this page

JavaScript Prerequisites

jQuery

The Kendo UI library is based on jQuery. All Kendo UI bundles include the corresponding minified jQuery library in the js directory.

Important

In order for the Kendo UI scripts to work as expected, make sure you include a reference to the jQuery library in the document before the scripts.

Supported jQuery Versions

The current official version of Kendo UI requires jQuery 1.12.3. There are cases when a new jQuery version is released. This new version usually introduces breaking changes and is not compatible with the existing Kendo UI versions. In such cases, it is recommended that you use the previous jQuery version until the next official Kendo UI version which resolves the problem is released. Normally, the jQuery version that is shipped with the Kendo UI service packs is not changed, but is updated in major releases.

The following list provides jQuery compatibility information about the major Kendo UI releases and their corresponding service packs:

Major Releases jQuery Version Comments
Kendo UI 2016.2.504 (R2 2016) 1.12.3 Also compatible with 1.10.x and 2.1.x
Kendo UI 2016.1.112 (Q1 2016) 1.9.1 Also compatible with 1.10.x and 2.1.x
Kendo UI 2015.3.930 (Q3 2015) 1.9.1 Also compatible with 1.10.x and 2.1.x
Kendo UI 2015.2.624 (Q2 2015) 1.9.1 Also compatible with 1.10.x and 2.1.x
Kendo UI 2015.1.318 (Q1 2015) 1.9.1 Also compatible with 1.10.x and 2.1.x
Kendo UI 2014.3.1119 (Q3 2014) 1.9.1 Also compatible with 1.10.x and 2.1.x
Kendo UI 2014.2.716 (Q2 2014) 1.9.1 Also compatible with 1.10.x and 2.1.x
Kendo UI 2014.1.318 (Q1 2014) 1.9.1 Also compatible with 1.10.x and 2.0.x
Kendo UI 2013.3.1119 (Q3 2013) 1.9.1 Also compatible with 1.10.x and 2.0.x
Kendo UI 2013.2.716 (Q2 2013) 1.9.1 -
Kendo UI 2013.1.319 (Q1 2013) 1.9.1 -
Kendo UI 2012.3.1114 (Q3 2012) 1.8.2 -
Kendo UI 2012.2.710 (Q2 2012) 1.7.1 -
Kendo UI 2012.1.322 (Q1 2012) 1.7.1 -
Kendo UI 2011.3.1129 (Q3 2011) 1.7.1 -

Previous Versions Required

Occasionally, a legacy web application might require an older jQuery version with which Kendo UI components are not compatible. In such cases, use a recent jQuery version together with jQuery Migrate. The plug-in restores the jQuery features that have been depreciated and provides for the required backward compatibility.

AngularJS

As of the Kendo UI 2014 Q2 release, Kendo UI widgets support AngularJS integration. To activate the AngularJS directives, install the AngularJS library. Just like jQuery, its minified format is located is in the js directory of the Kendo UI bundle you have downloaded.

Important

To function correctly and unlike jQuery, the Kendo UI distributions do not need AngularJS.

Supported AngularJS Versions

Major Releases AngularJS Version Comments
Kendo UI 2016.2.504 (R2 2016) 1.4.0+ -
Kendo UI 2016.1.112 (Q1 2016) 1.4.0+ -
Kendo UI 2015.3.930 (Q3 2015) 1.4.0+ -
Kendo UI 2015.2.624 (Q2 2015) 1.3.16 -
Kendo UI 2015.1.318 (Q1 2015) 1.3.0 -
Kendo UI 2014.3.1119 (Q3 2014) 1.3.0 -
Kendo UI 2014.2.716 (Q2 2014) 1.2.16 Upgraded to 1.2.21 in subsequent internal builds

Important

Using AngularJS 1.5 is not recommended because of this known issue.

Other

JSZip Library

The JSZip library is a necessary prerequisite for configuring your widgets so as to support the Excel export feature. The Excel export feature was first included in the Kendo UI 2014.3.1119 (Q3 2014) release. However, you need the JSZip library only if you want to support the Excel export feature.

Tag Placement: script

Generally, it is recommended that you place the script tags before the closing body tag, so that the scripts are loaded and executed after the HTML markup. Usually, the Kendo UI widget initialization statements are executed in the document.ready event through a jQuery handler. This means that jQuery must be registered before any Kendo UI widget initialization statements. When using the client-side Kendo UI widgets, you can control the placement of the initialization statements, so that the jQuery script file can be registered at the bottom of the document.

The server-side wrappers for the Kendo UI widgets are self-initialized. This means that each initialization script is rendered right after the HTML markup of the widget. In this case, the Kendo UI scripts can still be registered at the end of the document, but the jQuery script must be registered in the body before the first Kendo UI widget on the document, or in the document head.

See Also

Other articles on getting started with Kendo UI: