@syncfusion/ej2-angular-schedule 20.3.61 → 20.4.38-ngcc

package/README.md

@@ -1,73 +1,147 @@
-# ej2-angular-schedule
+# Angular Schedule Component
+
+The [Angular Schedule](https://www.syncfusion.com/angular-ui-components/angular-scheduler?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) component is an event calendar that facilitates almost all the basic Outlook and Google Calendar features, allowing the user to plan and manage appointments and time efficiently. It receives event data from a variety of data sources, such as an array of JSON objects, OData web services, RESTful or WCF services, and [DataManager](https://ej2.syncfusion.com/angular/documentation/data/data-binding/) with built-in load on demand support to reduce the data transfer and load time. Also, it is availed with the multiple resources support that allots an unique individual space for more than one resources on the same calendar.
+
+<p align="center">
+    <a href="https://ej2.syncfusion.com/angular/documentation/schedule/getting-started/?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm">Getting started</a> . 
+    <a href="https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm#/bootstrap5/schedule/overview">Online demos</a> . 
+    <a href="https://www.syncfusion.com/angular-components/angular-scheduler?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm">Learn more</a>
+</p>
+<p align="center">
+<img src="https://raw.githubusercontent.com/SyncfusionExamples/nuget-img/master/angular/angular-scheduler.png" alt="Angular Scheduler Component"/>
+</p>
+<p align="center">
+Trusted by the world's leading companies
+  <a href="https://www.syncfusion.com">
+    <img src="https://raw.githubusercontent.com/SyncfusionExamples/nuget-img/master/syncfusion/syncfusion-trusted-companies.webp" alt="Bootstrap logo">
+  </a>
+</p>
 
-The [Angular Scheduler](https://www.syncfusion.com/angular-ui-components/angular-scheduler?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) component is an event calendar that facilitates almost all the basic Outlook and Google Calendar features, allowing the user to plan and manage appointments and time efficiently. It receives data from a variety of data sources, such as an array of JSON objects, OData web services, RESTful or WCF services, and [`DataManager`](https://ej2.syncfusion.com/angular/documentation/data/) with built-in load on demand support to reduce the data transfer and load time. Also, it is availed with the multiple resources support that allots an unique individual space for more than one resources on the same calendar.
+## Setup
 
-![Schedule](https://ej2.syncfusion.com/products/images/schedule/readme.png)
+### Create an Angular Application
 
-> This is a commercial product and requires a paid license for possession or use. Syncfusion’s licensed software, including this component, is subject to the terms and conditions of Syncfusion's [EULA](https://www.syncfusion.com/eula/es/). To acquire a license, you can purchase one at [here](https://www.syncfusion.com/sales/products) or start a free 30-day trial from [here](https://www.syncfusion.com/account/manage-trials/start-trials).
+You can use [Angular CLI](https://github.com/angular/angular-cli) to setup your Angular applications. To install the Angular CLI, use the following command.
 
-> A free community [license](https://www.syncfusion.com/products/communitylicense) is also available for companies and individuals whose organizations have less than $1 million USD in annual gross revenue and five or fewer developers.
+```bash
+npm install -g @angular/cli
+```
 
-## Setup
+Create a new Angular application using the following Angular CLI command.
 
-To install Schedule and its dependent packages, use the following command.
+```bash
+ng new my-app
+cd my-app
+```
 
-```sh
-npm install @syncfusion/ej2-angular-schedule
+### Adding Syncfusion Schedule package
+
+All Syncfusion Angular packages are available in [npmjs.com](https://www.npmjs.com/~syncfusionorg). To install the Angular schedule package, use the following command.
+
+```bash
+ng add @syncfusion/ej2-angular-schedule
 ```
 
-## Resources
+The above command does the below configuration to your Angular app.
+ 
+ * Adds `@syncfusion/ej2-angular-schedule` package and its peer dependencies to your `package.json` file.
+ * Imports the `ScheduleModule` in your application module `app.module.ts`.
+ * Registers the Syncfusion UI default theme (material) in the `angular.json` file.
+
+This makes it easy to add the Syncfusion Angular Schedule module to your project and start using it in your application.
+
+### Module injection
 
-* [Getting Started](https://ej2.syncfusion.com/angular/documentation/schedule/getting-started.html?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm)
-* [View Online Demos](https://ej2.syncfusion.com/angular/demos/#/material/schedule/default?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm)
-* [Product Page](https://www.syncfusion.com/angular-ui-components/angular-scheduler?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm)
+In the **app.component.ts** file, use the following code to inject the modules.
 
-## Supported Frameworks
+```typescript
+@Component({
+  providers: [DayService, WeekService, WorkWeekService, MonthService, AgendaService, MonthAgendaService, TimelineViewsService, TimelineMonthService]
+})
+```
+
+### Add Schedule component
+
+In **src/app/app.component.ts**, use `<ejs-schedule>` selector in the `template` attribute of the `@Component` directive to render the Syncfusion Angular Schedule component.
+
+```typescript
+import { Component, OnInit } from '@angular/core';
+import { EventSettingsModel, DayService, WeekService, WorkWeekService, MonthService, AgendaService } from '@syncfusion/ej2-angular-schedule';
+@Component({
+    selector: 'app-root',
+    providers: [DayService, WeekService, WorkWeekService, MonthService, AgendaService],
+    template: `<ejs-schedule [selectedDate]='selectedDate'
+  [eventSettings]='eventSettings'></ejs-schedule>`
+})
+export class AppComponent implements OnInit {
+  public data: object[] = [
+    {
+      Id: 1,
+      Subject: 'Meeting',
+      StartTime: new Date(2023, 1, 15, 10, 0),
+      EndTime: new Date(2023, 1, 15, 12, 30)
+    },
+  ];
+  public selectedDate: Date = new Date(2023 1, 15);
+  public eventSettings: EventSettingsModel = {
+    dataSource: this.data
+  };
+}
+```
 
-Schedule component is also available in following list of frameworks.
+## Supported frameworks
 
-1. [React Scheduler](https://www.syncfusion.com/react-ui-components/react-scheduler?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm)
-2. [Vue Scheduler](https://www.syncfusion.com/vue-ui-components/vue-scheduler?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm)
-3. [ASP.NET Core Scheduler](https://www.syncfusion.com/aspnet-core-ui-controls/scheduler?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm)
-4. [ASP.NET MVC Scheduler](https://www.syncfusion.com/aspnet-mvc-ui-controls/scheduler?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm)
-5. [JavaScript Scheduler](https://www.syncfusion.com/javascript-ui-controls/js-scheduler?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm)
+Schedule component is also offered in the following list of frameworks.
+
+| [<img src="https://ej2.syncfusion.com/github/images/js.svg" height="50" />](https://www.syncfusion.com/javascript-ui-controls?utm_medium=listing&utm_source=github)<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[JavaScript](https://www.syncfusion.com/javascript-ui-controls?utm_medium=listing&utm_source=github)&nbsp;&nbsp;&nbsp;&nbsp; | [<img src="https://ej2.syncfusion.com/github/images/react.svg"  height="50" />](https://www.syncfusion.com/react-ui-components?utm_medium=listing&utm_source=github)<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[React](https://www.syncfusion.com/react-ui-components?utm_medium=listing&utm_source=github)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | [<img src="https://ej2.syncfusion.com/github/images/vue.svg" height="50" />](https://www.syncfusion.com/vue-ui-components?utm_medium=listing&utm_source=github)<br/>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[Vue](https://www.syncfusion.com/vue-ui-components?utm_medium=listing&utm_source=github)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; | [<img src="https://ej2.syncfusion.com/github/images/netcore.svg" height="50" />](https://www.syncfusion.com/aspnet-core-ui-controls?utm_medium=listing&utm_source=github)<br/>&nbsp;&nbsp;[ASP.NET&nbsp;Core](https://www.syncfusion.com/aspnet-core-ui-controls?utm_medium=listing&utm_source=github)&nbsp;&nbsp; | [<img src="https://ej2.syncfusion.com/github/images/netmvc.svg" height="50" />](https://www.syncfusion.com/aspnet-mvc-ui-controls?utm_medium=listing&utm_source=github)<br/>&nbsp;&nbsp;[ASP.NET&nbsp;MVC](https://www.syncfusion.com/aspnet-mvc-ui-controls?utm_medium=listing&utm_source=github)&nbsp;&nbsp; | 
+| :-----: | :-----: | :-----: | :-----: | :-----: |
 
 ## Showcase samples
 
-* [Fare calendar demo in Angular](https://ej2.syncfusion.com/angular/demos/#/material/schedule/resources?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm))
-
-## Key Features
-
-* [**Views**](https://ej2.syncfusion.com/angular/demos/#/material/schedule/views?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Schedule is now availed with 10 different view modes – day, week, work week, month, timeline day, timeline week, timeline work-week, timeline month, agenda and month agenda. It is possible to configure view-based settings on each view mode. The `Week` view is set as active view by default.
-* [**Data binding**](https://ej2.syncfusion.com/angular/demos/#/material/schedule/remote-data?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Seamless data binding with various client-side and remote data sources thus allowing the data to load on demand by default to reduce the data transfer and loading time.
-* **Drag and drop** - Appointments can be easily rescheduled to another time by dragging and dropping them onto the required time slots.
-* **Appointment resize** - An appointment’s time can be easily extended by resizing its start or end handlers.
-* [**Multiple resources**](https://ej2.syncfusion.com/angular/demos/#/material/schedule/group?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Supports planning and management of events for multiple resources and allows to group them under appropriate resources. Also, supports date-wise grouping, linked appointments and other group related customizations.
-* [**Recurrence**](https://ej2.syncfusion.com/angular/demos/#/material/schedule/recurrence-events?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Allows the user to repeat a set of events on a daily, weekly, monthly, or yearly basis.
-* [**Template**](https://ej2.syncfusion.com/angular/demos/#/material/schedule/events-template?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - The key elements like events, date header, work cells and event tooltip comes with the default template support which allows the flexible end-user customization to embed any kind of text, images, or styles to it.
-* [**Timezone**](https://ej2.syncfusion.com/angular/demos/#/material/schedule/timezone-event?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) -  Regardless of whatever time zone your system follows, Schedule supports setting your own required time zone value to it as well as to each event – thus allowing the events to display on its exact local time.
-* [**Timescale**](https://ej2.syncfusion.com/angular/demos/#/material/schedule/timescale?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Allows to display customized time duration, with clear and accurate depiction of appointments across the appropriate time slots.
-* [**Customizable working days and hours**](https://ej2.syncfusion.com/angular/demos/#/material/schedule/work-days?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Users can set specific [work hour](https://ej2.syncfusion.com/angular/demos/#/material/schedule/work-hours?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) range which is visually differentiated with active colour. Also, the working days collection can be customized with specific days, so that the remaining days will be considered as [weekend](https://ej2.syncfusion.com/angular/demos/#/material/schedule/hide-weekend?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm).
-* [**Custom editor template**](https://ej2.syncfusion.com/angular/demos/#/material/schedule/editor-template?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Template option is availed for event editor, thus allowing the users to add their own custom editor design and also provides option to add additional fields onto the default event editor.
-* [**Adaptive rendering**](https://ej2.syncfusion.com/angular/demos/#/material/schedule/month-agenda?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Adapts with optimal user interfaces for mobile and desktop form-factors, thus helping the user’s application to scale elegantly across all the form-factors without any additional effort.
-* [**Keyboard interaction**](https://ej2.syncfusion.com/angular/demos/#/material/schedule/keyboard-interaction?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - All the common actions such as traversing through the appointments, multiple cell selection, add/edit/delete the appointments, navigate to other views, dates and much more can be performed through keyboard inputs.
-* [**Localization**](https://ej2.syncfusion.com/angular/documentation/schedule/localization.html#localization?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - All the static text and date content can be localized to any desired language. Also, it can be displayed with appropriate time mode and date-format as per the localized language.
-* [**RTL**](https://ej2.syncfusion.com/angular/documentation/schedule/localization.html#rtl?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Supports displaying the component to display in the direction from right to left.
+* Appointment Planner - [Source](https://github.com/syncfusion/ej2-showcase-angular-expensetracker?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm), [Live Demo](https://ej2.syncfusion.com/showcase/angular/appointmentplanner/#/dashboard?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm)
+* Fare calendar- [Live Demo](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/resources?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm)
+
+## Key features
+
+* [Multiple views](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/views?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - A wide variety of built-in views are available: `day, week, work week, month, timeline day, timeline week, timeline work week, timeline month, timeline year, year, agenda and month agenda`. Easily configure each individual view with different, view-specific options.
+* [Data binding](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/remote-data?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Seamless data binding with various client-side and remote data sources thus allowing the data to load on demand by default to reduce the data transfer and loading time.
+* [Drag and drop](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/external-drag-drop?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Appointments can be easily rescheduled to another time by dragging and dropping them onto the required time slots.
+* Appointment resize - An appointment’s time can be easily extended by resizing its start or end handlers.
+* [Multiple resources](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/resource-grouping?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Supports planning and management of events for multiple resources and allows to group them under appropriate resources. Also, supports date-wise grouping, linked appointments and other group related customizations.
+* [Virtual scrolling](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/virtual-scrolling?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Supports to load a large number of resources and events instantly as the users scroll.
+* [Recurrence appointment](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/recurrence-events?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Allows the user to repeat a set of events on a daily, weekly, monthly, or yearly basis.
+* [Template](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/events-template?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - The key elements like events, date header, work cells, time cells, event tooltip, resource header, date range text, and quick info popup comes with the default template support which allows the flexible end-user customization to embed any kind of text, images, or styles to it.
+* [Timezone](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/timezone-event?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) -  Regardless of whatever time zone your system follows, Schedule supports setting your own required time zone value to it as well as to each event - thus allowing the events to display on its exact local time.
+* [Timescale](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/time-scale?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Allows to display customized time duration, with clear and accurate depiction of appointments across the appropriate time slots.
+* [Customizable working days and hours](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/work-days?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Users can set specific [work hour](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/work-hours?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) range which is visually differentiated with active colour. Also, the working days collection can be customized with specific days, so that the remaining days will be considered as [weekend](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/hide-weekend?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm).
+* [Custom editor template](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/editor-template?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Template option is availed for event editor, thus allowing the users to add their own custom editor design and also provides option to add additional fields onto the default event editor.
+* [Adaptive rendering](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/month-agenda?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Adapts with optimal user interfaces for mobile and desktop form-factors, thus helping the user’s application to scale elegantly across all the form-factors without any additional effort.
+* [Export to Excel](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/excel-export?utm_source=npm&utm_medium=listing&utm_campaign=javascript-scheduler-npm) - Provides the options to Export the events to Excel formats.
+* [Export and Import ICS](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/calendar-export-import?utm_source=npm&utm_medium=listing&utm_campaign=javascript-scheduler-npm) - Provides the options to Export and Import the events as ICS formats.
+* [Keyboard interaction](https://ej2.syncfusion.com/angular/demos/#/bootstrap5/schedule/keyboard-interaction?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - All the common actions such as traversing through the appointments, multiple cell selection, add/edit/delete the appointments, navigate to other views, dates and much more can be performed through keyboard inputs.
+* [Localization](https://ej2.syncfusion.com/angular/documentation/schedule/localization.html#localization?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - All the static text and date content can be localized to any desired language. Also, it can be displayed with appropriate time mode and date-format as per the localized language.
+* [RTL](https://ej2.syncfusion.com/angular/documentation/schedule/localization.html#rtl?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) - Supports displaying the component to display in the direction from right to left.
 
 ## Support
 
-Product support is available through following mediums.
+Product support is available through the following mediums.
 
-* Creating incident through Syncfusion [Direct-trac](https://www.syncfusion.com/support/directtrac/incidents?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) support system or [Community forum](https://www.syncfusion.com/forums/essential-js2?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm).
-* New [GitHub issue](https://github.com/syncfusion/ej2-angular-ui-components/issues/new?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm).
-* Ask your query in Stack Overflow with tag `syncfusion`, `ej2`.
+* [Support ticket](https://support.syncfusion.com/support/tickets/create) - Guaranteed Response in 24 hours | Unlimited tickets | Holiday support
+* [Community forum](https://www.syncfusion.com/forums/angular-js2?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm)
+* [GitHub issues](https://github.com/syncfusion/ej2-angular-ui-components/issues/new)
+* [Request feature or report bug](https://www.syncfusion.com/feedback/angular?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm)
+* Live chat
 
-## License
+## Changelog
 
-Check the license detail [here](https://github.com/syncfusion/ej2-angular-ui-components/blob/master/license?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm).
+Check the changelog [here](https://github.com/syncfusion/ej2-angular-ui-components/blob/master/components/schedule/CHANGELOG.md?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm). Get minor improvements and bug fixes every week to stay up to date with frequent updates.
 
-## Changelog
+## License and copyright
+
+> This is a commercial product and requires a paid license for possession or use. Syncfusion’s licensed software, including this component, is subject to the terms and conditions of Syncfusion's [EULA](https://www.syncfusion.com/eula/es/). To acquire a license for 80+ [Angular UI components](https://www.syncfusion.com/angular-components), you can [purchase](https://www.syncfusion.com/sales/products) or [start a free 30-day trial](https://www.syncfusion.com/account/manage-trials/start-trials).
+
+> A free community [license](https://www.syncfusion.com/products/communitylicense) is also available for companies and individuals whose organizations have less than $1 million USD in annual gross revenue and five or fewer developers.
 
-Check the changelog [here](https://ej2.syncfusion.com/angular/documentation/release-notes?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm).
+See [LICENSE FILE](https://github.com/syncfusion/ej2-angular-ui-components/blob/master/license?utm_source=npm&utm_medium=listing&utm_campaign=angular-scheduler-npm) for more info.
 
 © Copyright 2022 Syncfusion, Inc. All Rights Reserved. The Syncfusion Essential Studio license and copyright applies to this distribution.