A Gif Guide to Getting Started with Kendo UI_870x220

A visual guide using animated GIFs to installing, setting up and building your first app with Kendo UI for Angular by Tara Manicsic.

Using Kendo UI components in your Angular application helps you make a robust application quickly with succinct code. When you’re working on a deadline, like during hackathon, or just a regular stressful deadline, like getting work to a client on time, coding faster is better. Having succinct, easy-to-read code is great when you’re working in a team or even just to future you. After all, you probably can’t even remember what you had for lunch yesterday (me either).

Okay, let’s get going.

Get Your Environment Ready

It is best to work with the latest stable version of Node & npm.

nvm install stable // to update to the latest stable version

// or if you want to keep you modules

nvm install stable --reinstall-packages-from=6.4.0
npm i npm -g // to update npm

node & npm update

Get Your Project Created

From the directory where you want your project to live, use the Angular CLI to create a new project. First, install the Angular CLI.
angular cli install

Then we just need to ask the CLI to create our new project and use the -ng4 flag to make sure we’re using version 4 of Angular (like all the cool kids πŸ€™).

* update: with the release of 1.0 you no longer need the -ng4 flag, new projects will automatically be using Angular v4 (thanks CLI team 😍)

ng new ATTACK -ng4

new angular project

Ahhh, a fresh new project. To make sure everything is hunky dory, serve up the project and head to http://localhost:4200/ to take a look.

ng serve

Serve it up

In the words of Angular CLI contributor, @Brocco, BAM!

a site is born

Get git…ing

Personally, I find that this is the perfect time to create a git repository and push the fresh project up.

cd ATTACK/ // move into your project directory
git init
git remote add origin <your repo's url>

Get going with git

Add all the things, then push.

git status // check all the files that need added
git add . // 😱
git commit -m 'initial commit'
git push origin master

I usually stay away from git add . because it can be dangerous but in this case we’re only sending up the initial files so πŸ‘Œ

git add & push

Now we have a reference point to when all things were good πŸ˜‡. I’ll make a commit to this repo with every new step we take. Just look for the πŸ™ to find the links to the new commits.

πŸ™ initial commit

Get the Progress NPM Registry

Get Access

If you haven’t worked with Kendo UI components you will want to set up an account here in order to access our registry. All of our component modules are distributed npm packages that live in our private registry but you just need your Progress Telerik account credentials to access them πŸ‘.

Once you’re set up, we can log in to the Progress registry.

npm login --registry=https://registry.npm.telerik.com/ --scope=@progress

If you get an error like this your credentials are not correct or you may not have activated your account. Check your email πŸ“§ for an activation link.

Login Error

Once you’re all set you should have this lovely ‘Logged in…’ message to greet you 😍

logged in

Get the Chart Component

To use the Kendo UI components for your Angular project you will take the same steps, no matter which component you use:

  • npm install the component’s module
  • import the module & import the component directive in your module.ts file
  • incorporate it into your template html file

Here we’ll look at the chart πŸ“Š component so we can also look at some data binding. You can check out all the available components HERE.

Get the Module

First, you will want to install the module for our chart component and save it to your app’s dependencies with the -S flag.

npm i -S @progress/kendo-angular-charts @progress/kendo-angular-intl @progress/kendo-drawing hammerjs

You will see warnings like shown below but they are not detrimental to your project.

installing the module

Get the Code in πŸ‘©‍πŸ’»

Inside your app.module.ts file you want to add the code to import the chart module, import the ‘hammerjs’ dependency and import the directive into your app module.

src/app/app.module.ts

import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { FormsModule } from '@angular/forms';
import { HttpModule } from '@angular/http';
import { ChartsModule } from '@progress/kendo-angular-charts';
import 'hammerjs';

import { AppComponent } from './app.component';

@NgModule({
  declarations: [
    AppComponent
  ],
  imports: [
    BrowserModule,
    FormsModule,
    ChartsModule,
    HttpModule
  ],
  providers: [],
  bootstrap: [AppComponent]
})
export class AppModule { }

add the code

If you’re like me and like to be safe rather than sorry, feel free to run ng serve again to make sure your app is golden β˜€οΈ.

πŸ™ install & import commit

Get Styled

In order for your app to look awesome with very minimal effort you can add the Kendo UI default theme. Again, you just need to install it with npm i then include it in your .angular-cli.json file.

npm install -S @progress/kendo-theme-default

install the theme

For the fun part, we get to edit our .angular-cli.json file to include the theme πŸŽ‰.

.angular-cli.json

  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
  "project": {
    "name": "attack"
  },
  "apps": [
    {
      "root": "src",
      "outDir": "dist",
      "assets": [
        "assets",
        "favicon.ico"
      ],
      "index": "index.html",
      "main": "main.ts",
      "polyfills": "polyfills.ts",
      "test": "test.ts",
      "tsconfig": "tsconfig.app.json",
      "testTsconfig": "tsconfig.spec.json",
      "prefix": "app",
      "styles": [
        "../node_modules/@progress/kendo-theme-default/dist/all.css", // πŸ’…
        "styles.css"
      ],
      "scripts": [],
      ...

edit the cli config

πŸ™ get styled commit

Get Data in There!

In the ‘component.ts’ file you can change your title and create some data to export.

src/app/app.component.ts

import { Component } from '@angular/core';

@Component({
  selector: 'app-root',
  templateUrl: './app.component.html',
  styleUrls: ['./app.component.css']
})
export class AppComponent {
  title = 'Winning App';
  private items: any[] = [{
    name: "puppies",
    data: [3, .65, 2, .50]
  },{
    name: "bunnies",
    data: [2, 1, .25, 3]
  },{
    name: "snakes",
    data: [1, .5, 1, .5]
  }];

add data

πŸ™ get data in there commit

Get a Chart

Now you can add the chart component to your template and bind the data created in the component.ts file. We’ll keep the graph simple here because you still get a lot of interactions with just the basic graph but check out the API to see all the ways you can control and customize your chart.

First, the chart components <kendo-chart> and <kendo-chart-series> are added. Then, when you add the <kendo-chart-series-item> you can use *ngFor to loop through your list of items exported from component.ts and bind the items properties to the series item’s name and data. For this chart we set the type to area to create an area graph, but there are a lot of options for series or graph types in the Chart component docs!

src/app/app.component.html

<h1>
  {{title}}
</h1>

<kendo-chart>
  <kendo-chart-series>
    <kendo-chart-series-item *ngFor="let item of items"
      type="area" [data]="item.data" [name]="item.name">
    </kendo-chart-series-item>
  </kendo-chart-series>
</kendo-chart>

adding the chart code

Now when you run ng serve you should find a beautiful, interactive chart!

Remember, you can always check in with the repo commits to see if your code changes match.

πŸ™ get a chart commit

Conclusion

That’s all you need to get started with Kendo UI components & even put a chart in your app! Good luck with your app πŸ‘

Resources:

Related content:


Editor's note: This post originally appeared on the Telerik Developer Network. Check it out for other great content.
Tara Manicsic
About the Author

Tara Manicsic

Tara is a developer advocate at Progress for Kendo UI, and a life-long student, teacher and maker. She has spent the majority of her career using Javascript on both back-end and front-end to create applications. In her free time she works in her community to educate and learn from other developers launching the Cincinnati Chapter of Women Who Code and co-chairing the Cincinnati branch of NodeSchool.

Related Posts

Comments

Comments are disabled in preview mode.