Edit this page

JavaScript Prerequisites

Kendo UI is a jQuery-based library that also supports AngularJS integration.

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. Usually, each newly released jQuery version introduces breaking changes and is not compatible with the existing Kendo UI versions. In such cases, use the previous jQuery version until the next official Kendo UI version that resolves the issue 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 table provides a list of the jQuery versions that are compatible with the major Kendo UI releases and their corresponding service packs.

Major Releases jQuery Version Comments
Kendo UI 2017.1.118 (R1 2017) 1.12.3 Also compatible with 1.10.x, 2.2.x and 3.1.1
Kendo UI 2016.3.1118 (R3 2016 SP2) 1.12.3 Also compatible with 1.10.x, 2.2.x and 3.1.1
Kendo UI 2016.3.914 (R3 2016) 1.12.3 Also compatible with 1.10.x and 2.2.x
Kendo UI 2016.2.504 (R2 2016) 1.12.3 Also compatible with 1.10.x and 2.2.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 -

Required Previous Versions

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 the jQuery Migrate plug-in. It restores the jQuery features that have been depreciated and provides for the required backward compatibility.

AngularJS

As of the Kendo UI 2014 Q2 release, the 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 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 2017.1.118 (R1 2017) 1.4*, 1.5*, 1.6* -
Kendo UI 2016.3.914 (R3 2016) 1.4*, 1.5* Kendo UI provides limited ngModel support for AngularJS 1.5*.
Kendo UI 2016.2.504 (R2 2016) 1.4*, 1.5* Kendo UI provides limited ngModel support for AngularJS 1.5*.
Kendo UI 2016.1.112 (Q1 2016) 1.4*, 1.5* Kendo UI provides limited ngModel support for AngularJS 1.5*.
Kendo UI 2015.3.930 (Q3 2015) 1.4*, 1.5* Kendo UI provides limited ngModel support for AngularJS 1.5*.
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* and Kendo UI version older than R1 2017 is recommended only with the Kendo UI k-ng-model directive, because the ng-model directive does not reflect the model value.

Other

JSZip Library

The JSZip library is a necessary prerequisite for your widgets to support the Excel export feature as well as the import of Excel files in the Kendo UI Spreadsheet. The Excel export feature was first included in the Kendo UI 2014.3.1119 (Q3 2014) release. Include the JSZip library only if you wish to provide the Excel export or import fromFile() functionalities.

The script Tag Placement

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 such cases, the Kendo UI scripts can still be registered at the end of the document while 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: