Telerik UI for Windows 8 HTML

Starting with Q2 2012, Telerik UI for Windows 8 HTML ships with TypeScript declarations (with types and documentation) for all Telerik controls and utility types. The following table contains information about which versions of Telerik UI for Windows 8 HTML start supporting a newer version of TypeScript. Note that until the 1.0 version of TypeScript is declared, there can be many breaking changes between versions.

Telerik UI version

TypeScript version

Q2 2013(2013.2.611)

0.8.3.1

Q2 2013 SP1(2013.2.716)

0.9.0.1

Q3 2013

0.9.1.1

How to Use Telerik UI for Windows 8 TypeScript Declarations

You can find the TypeScript declaration of Telerik UI for Windows 8 (telerik.d.ts) in:

  • The Telerik UI for Windows 8 HTML QX 201X installation folder. By default, it is ~\Program Files (x86)\Telerik\UI for Windows 8 HTML QX 20XX\js.

  • The js folder in the Dev, Hotfix_Dev and Source downloadable zip archives

  • The \~Telerik.UI\js folder of the Telerik UI for Windows 8 HTML NuGet package.

common-typescript

The Telerik namespace is exposed as an internal TypeScript module of the global module and it depends on the WinJS TypeScript declarations. Therefore, you need to first get them.

Tip

The WinJS declarations are provided and supported by the TypeScript development team and you can find them in the \bin\winjs.d.ts file of the current branch of their CodePlex repository.

In order to use Telerik controls' declarations you need copies and references to both the aforementioned files. For example, suppose default.ts is the file you are working in from the following folder structure:

common-typescript 1

To get it working, add the following two lines of code in the beginning of the file.

JavaScript Copy imageCopy
/// <reference path="../typings/winjs.d.ts" />
/// <reference path="../typings/telerik.d.ts" />

You now have static typing and API IntelliSense for all Telerik controls at development time:

common-typescript 2
common-typescript 3

As of TypeScript 0.9.0.1 you also have event handler IntelliSense: event handler overloading on constants (the event name), detailed event argument types, etc

common-typescript-eventhandlers