Articles in this section
Category / Section

How to get started easily with Syncfusion Angular 4 Scheduler?

4 mins read

A quick start project that helps you to create an Angular 4 Scheduler with minimal code configuration.

 

Angular 4 Scheduler displaying month view

 

Scheduler features covered in this Project

This is an Angular 4 project created using Angular CLI 1.4. The Scheduler features included in this project are as follows.

  • Angular 4 Scheduler displaying basic views with appointments loaded as JSON data.
  • Drag and resize actions enabled for events by default.
  • Setting current date and view for scheduler.
  • Setting specific timezone on scheduler.

 

Project pre-requisites

Make sure that you have the compatible versions of TypeScript and Angular in your machine before starting to work on this project.

  • Angular 4+
  • TypeScript 2.6+

 

Angular 4 Scheduler – Introduction

The Angular 4 Scheduler used in this project is created from the Syncfusion `ej2-angular-schedule` package. You can simply define it as <ejs-schedule> within the template.

 

Dependencies

Before starting with this project, the Angular 4 Scheduler requires to add the Syncfusion `ej2-angular-schedule` package from npmjs, which are distributed in npm as @syncfusion scoped packages.

 

Creating Angular Project

We will see the Angular project creation steps using the Angular CLI tool.

  1. Install the Angular CLI application in your machine.
    npm install @angular/cli@1.4
    
  1. Now create a new Angular project by using the command `ng new` and navigate to that folder.
    ng new <project name>
    cd <project name>
    
  1. Install the ej2-angular-schedule package through the npm install command.
    npm install @syncfusion/ej2-angular-schedule --save
    

Adding Angular 4 Scheduler

You can add the Angular 4 Scheduler component by using `ejs-schedule` directive and the attributes used within this tag allows you to define other scheduler functionalities.

  1. Import the ScheduleModule into app.module.ts file from the ej2-angular-schedule package.
  2. The next step in Angular Scheduler creation is to import and inject the other required modules within the providers section of app.module.ts.

 

[app.module.ts]

import { BrowserModule } from '@angular/platform-browser';
import {ScheduleModule, AgendaService, DayService, WeekService, WorkWeekService, MonthService } from '@syncfusion/ej2-angular-schedule';
import { NgModule } from '@angular/core';
 
import { AppComponent } from './app.component';
 
@NgModule({
    imports: [
        BrowserModule, ScheduleModule
    ],
    providers: [AgendaService, DayService, WeekService, WorkWeekService, MonthService],
    bootstrap: [AppComponent]
})
export class AppModule { }

 

  1. Define the Angular Scheduler code within the app.component.html file which is mapped against the templateUrl option in app.component.ts file.

 

[app.component.html]

<ejs-schedule> </ejs-schedule>

 

  1. Refer the CDN link of CSS reference within the index.html file.

 

[index.html]

<link href="https://cdn.syncfusion.com/ej2/material.css" rel="stylesheet" />

 

  1. Try running the application with the command ng serve, and have an empty Scheduler displayed on the browser.  Now, let’s load the Scheduler with event data.

 

Loading appointment data

Let’s populate the empty Scheduler with appointments, by binding the local JSON event data to it through the dataSource property.

[app.component.ts]

import { Component } from '@angular/core';
import { EventSettingsModel} from '@syncfusion/ej2-angular-schedule';
 
@Component({
    selector: 'app-root',
    templateUrl: './app.component.html',
    styleUrls: ['./app.component.css']
})
export class AppComponent {
    public eventData: EventSettingsModel = {
        dataSource: [{
            Id: 1,
            Subject: 'Board Meeting',
            StartTime: new Date(2018, 10, 30, 9, 0),
            EndTime: new Date(2018, 10, 30, 11, 0)
        },
            {
                Id: 2,
                Subject: 'Training session on JSP',
                StartTime: new Date(2018, 10, 30, 15, 0),
                EndTime: new Date(2018, 10, 30, 17, 0)
            },
            {
                Id: 3,
                Subject: 'Sprint Planning with Team members',
                StartTime: new Date(2018, 10, 30, 9, 30),
                EndTime: new Date(2018, 10, 30, 11, 0)
            }]
    }
}

 

Now assign this data source to the Angular Scheduler’s eventSettings property within the app.component.html file.

[app.component.html]

<ejs-schedule [eventSettings]="eventData"></ejs-schedule>

 

Enabling drag-and-resize options

To enable the drag and resize actions on Scheduler events, import the required module services from the ej2-angular-schedule package and then mention it in the providers section within the app.module.ts file.

[app.module.ts]

import { BrowserModule } from '@angular/platform-browser';
import {ScheduleModule, AgendaService, DayService, DragAndDropService, ResizeService, WeekService, WorkWeekService, MonthService } from '@syncfusion/ej2-angular-schedule';
import { NgModule } from '@angular/core';
 
import { AppComponent } from './app.component';
 
@NgModule({
    imports: [
        BrowserModule, ScheduleModule
    ],
    providers: [AgendaService, DayService, WeekService, WorkWeekService, MonthService, DragAndDropService, ResizeService],
    bootstrap: [AppComponent]
})
export class AppModule { }

 

Setting current date and view

By default, Scheduler displays the current system date in Week view mode. To change both the display date as well as view mode, selectedDate and currentView property can be used.

[app.component.ts]

import { Component } from '@angular/core';
import { EventSettingsModel, View } from '@syncfusion/ej2-angular-schedule';
 
@Component({
    selector: 'app-root',
    templateUrl: './app.component.html',
    styleUrls: ['./app.component.css']
})
export class AppComponent {
    public currentDate: Date = new Date(2018, 10, 30);
    public newViewMode: View = 'Month';
}

 

[app.component.html]

<ejs-schedule [eventSettings]="eventData" [selectedDate]="currentDate" [currentView]="newViewMode"></ejs-schedule>

 

Setting timezone

To set specific timezone for Angular Scheduler, timezone property can be defined with valid timezone value. Here, let’s assign “UTC” to the timezone property of Scheduler, so that the events will get displayed on Scheduler with UTC time difference.

<ejs-schedule [eventSettings]="eventData" [selectedDate]="currentDate" timezone="UTC" [currentView]="newViewMode"></ejs-schedule>

 

Run the application with the command “ng serve” in command prompt and you will be able to view the Angular Scheduler output with loaded appointments and other settings.

There are more options to explore with Angular 4 Scheduler and you can also try playing with the downloadable example link in this knowledge base article.

Downloadable example link: Angular 4 Scheduler

Check our Video Tutorials: Angular 4 Scheduler

Did you find this information helpful?
Yes
No
Help us improve this page
Please provide feedback or comments
Comments
Please sign in to leave a comment
Access denied
Access denied