@syncfusion/ej2-angular-gantt 20.4.38 → 20.4.40-ngcc

package/README.md

@@ -1,86 +1,156 @@
-# ej2-angular-gantt
+# Angular Gantt Component
 
-The Gantt component is designed to visualize and edit the project schedule, and track the project progress. It helps to organize and schedule the projects and also you can update the project schedule through interactions like editing, dragging and resizing.
+The [Angular Gantt](https://www.syncfusion.com/angular-components/angular-gantt-chart?utm_source=npm&utm_medium=listing&utm_campaign=angular-gantt-npm) component is project planning and management tool used to display and manage hierarchical tasks with timeline details. It helps assess how long a project should take, determine the resources needed, manage the dependencies between tasks, and plan the order in which the tasks should be completed.
 
-![Gantt](https://ej2.syncfusion.com/products/images/gantt/readme.gif)
+<p align="center">
+  <a href="https://ej2.syncfusion.com/angular/documentation/gantt/getting-started/?utm_source=npm&utm_medium=listing&utm_campaign=angular-gantt-npm">Getting Started</a> .
+  <a href="https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_medium=listing&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/default">Online demos</a> .
+  <a href="https://www.syncfusion.com/angular-components/angular-gantt-chart?utm_source=npm&utm_medium=listing&utm_campaign=angular-gantt-npm">Learn more</a>
+</p>
 
-> 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 https://www.syncfusion.com/sales/products or start a free 30-day trial here (https://www.syncfusion.com/account/manage-trials/start-trials).
+<p align="center">
+<img alt="Angular Gantt Control" src="https://raw.githubusercontent.com/SyncfusionExamples/nuget-img/master/angular/angular-gantt-chart.png"> </p>
 
-> 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.
+<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>
 
 ## Setup
 
-To install Gantt and its dependent packages, use the following command.
+### Create an Angular Application
 
-```sh
-npm install @syncfusion/ej2-angular-gantt
+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.
+
+```bash
+npm install -g @angular/cli
+```
+
+Create a new Angular application using the following Angular CLI command.
+
+```bash
+ng new my-app
+cd my-app
 ```
 
-## Resources
+### Adding Syncfusion Gantt package
 
-* [Getting Started](https://ej2.syncfusion.com/angular/documentation/gantt/getting-started/)
-* [View Online Demos](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=gantt#/material/gantt/default)
-* [Product Page](https://www.syncfusion.com/angular-ui-components/angular-gantt-chart)
+All Syncfusion Angular packages are available in [npmjs.com](https://www.npmjs.com/~syncfusionorg). To install the Angular gantt package, use the following command.
 
-## Supported Frameworks
+```bash
+ng add @syncfusion/ej2-angular-gantt
+```
+
+The above command does the below configuration to your Angular app.
+ 
+ * Adds `@syncfusion/ej2-angular-gantt` package and its peer dependencies to your `package.json` file.
+ * Imports the `GanttModule` 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 Gantt module to your project and start using it in your application.
+
+### Add Gantt component
+
+In **src/app/app.component.ts**, use `<ejs-gantt>` selector in the `template` attribute of the `@Component` directive to render the Syncfusion Angular Gantt component.
+
+```typescript
+import { Component, OnInit } from '@angular/core';
+import { TaskFieldsModel } from '@syncfusion/ej2-angular-gantt';
+
+@Component({
+    selector: 'app-root',
+    template: `<ejs-gantt [dataSource]="data" [taskFields]="taskSettings"></ejs-gantt>`
+})
+export class AppComponent implements OnInit {
+
+    public data: object[] = [];
+
+    public taskSettings: TaskFieldsModel | undefined;
+
+    ngOnInit(): void {
+        this.taskSettings = {id: 'TaskID', name: 'TaskName', startDate: 'StartDate', endDate: 'EndDate', duration: 'Duration', progress: 'Progress', child: 'subtasks' };
+
+        this.data = [
+        {
+            TaskID: 1,
+            TaskName: 'Project Initiation',
+            StartDate: new Date('04/02/2019'),
+            EndDate: new Date('04/21/2019'),
+            subtasks: [
+                { TaskID: 2, TaskName: 'Identify Site location', StartDate: new Date('04/02/2019'), Duration: 4, Progress: 50 },
+                { TaskID: 3, TaskName: 'Perform Soil test', StartDate: new Date('04/02/2019'), Duration: 4, Progress: 50  },
+                { TaskID: 4, TaskName: 'Soil test approval', StartDate: new Date('04/02/2019'), Duration: 4, Progress: 50 },
+            ]
+        },
+        {
+            TaskID: 5,
+            TaskName: 'Project Estimation',
+            StartDate: new Date('04/02/2019'),
+            EndDate: new Date('04/21/2019'),
+            subtasks: [
+                { TaskID: 6, TaskName: 'Develop floor plan for estimation', StartDate: new Date('04/04/2019'), Duration: 3, Progress: 50 },
+                { TaskID: 7, TaskName: 'List materials', StartDate: new Date('04/04/2019'), Duration: 3, Progress: 50 },
+                { TaskID: 8, TaskName: 'Estimation approval', StartDate: new Date('04/04/2019'), Duration: 3, Progress: 50 }
+            ]
+        }];
+    }
+}
+```
+
+## Supported frameworks
 
 Gantt component is also offered in following list of frameworks.
 
-1. [React](https://github.com/syncfusion/ej2-react-ui-components/tree/master/components/gantt)
-2. [VueJS](https://github.com/syncfusion/ej2-vue-ui-components/tree/master/components/gantt)
-3. [ASP.NET Core](https://www.syncfusion.com/aspnet-core-ui-controls/gantt)
-4. [ASP.NET MVC](https://www.syncfusion.com/aspnet-mvc-ui-controls/gantt)
-5. [JavaScript (ES5)](https://www.syncfusion.com/javascript-ui-controls/gantt)
-6. [Blazor](https://www.syncfusion.com/blazor-components/blazor-gantt-chart)
-
-## Key Features
-
-* [**Data sources**](https://ej2.syncfusion.com/angular/documentation/gantt/data-binding/) - Bind hierarchical or self-referential data to Gantt chart with an array of JavaScript objects or DataManager.
-* [**Timeline**](https://ej2.syncfusion.com/angular/documentation/gantt/timeline/) – Display timescale from minutes to decades easily, and also display custom texts in the timeline units. Timeline can be displayed in either one-tier or two-tier layout.
-* [**Customizable Taskbars**](https://ej2.syncfusion.com/angular/documentation/gantt/appearance-customization/#taskbar-customization) – Display various tasks in a project using child taskbar, summary taskbar and milestone UI, that can also be customized with templates.
-* [**Unscheduled tasks**](https://ej2.syncfusion.com/angular/documentation/gantt/task-scheduling/#unscheduled-tasks) – Support for displaying tasks with undefined start date, end date or duration in a project.
-* [**Baselines**](https://ej2.syncfusion.com/angular/documentation/gantt/baseline/) – Display the deviations between planned dates and actual dates of a task in a project using baselines.
-* [**CRUD actions**](https://ej2.syncfusion.com/angular/documentation/gantt/managing-tasks/#maintaining-data-in-server) – Provides the options to dynamically insert, delete and update tasks using columns, dialog and taskbar editing options.
-* [**Task dependency**](https://ej2.syncfusion.com/angular/documentation/gantt/taskdependency/) – Define or update the dependencies between the tasks in a project with four types of task dependencies Finish – Start, Start – Finish, Finish – Finish, Start – Start.
-* [**Markers and indicators**](https://ej2.syncfusion.com/angular/documentation/gantt/data-markers/) - Support for displaying indicators and flags along with taskbars and task labels. Also map important events in a project using event marker.
-* [**Task label customization**](https://ej2.syncfusion.com/angular/documentation/gantt/appearance-customization/#task-labels) - provides option to set desired label inside task bar and right and left side of task bar.
-* [**Resources**](https://ej2.syncfusion.com/angular/documentation/gantt/resources/) - Allows you to assign and track performance of resource to particular task.
-* [**Sorting**](https://ej2.syncfusion.com/angular/documentation/gantt/sorting/) - Supports n levels of sorting.
-* [**Filtering**](https://ej2.syncfusion.com/angular/documentation/gantt/filtering/) - Offers filter UI such as filter bar, menu, excel and checkbox at each column to filter data.
-* [**Editing**](https://ej2.syncfusion.com/angular/documentation/gantt/managing-tasks/#editing-tasks) - provides the options for create, read, update, and delete operations.
-* [**Columns**](https://ej2.syncfusion.com/angular/documentation/gantt/columns/) - The column definitions are used as the dataSource schema in the gantt. This plays a vital role in rendering column values in the required format.
-  * [**Reordering**](https://ej2.syncfusion.com/angular/documentation/gantt/columns/#column-reordering) - Allows you to drag any column and drop it at any position in the gantt column header row, allowing columns to be repositioned.
-  * [**Column Chooser**](https://ej2.syncfusion.com/angular/documentation/gantt/columns/#column-menu) - The column chooser provides a list of column names paired with check boxes that allow the visibility to be toggled on the fly.
-  * [**Resizing**](https://ej2.syncfusion.com/angular/documentation/gantt/columns/#column-resizing) - Resizing allows changing column width on the fly by simply dragging the right corner of the column header.
-* [**Selection**](https://ej2.syncfusion.com/angular/documentation/gantt/selection/) - Rows or cells can be selected in the gantt. One or more rows or cells can also be selected by holding Ctrl or Command, or programmatically.
-* [**Row Drag And Drop**](https://ej2.syncfusion.com/angular/documentation/gantt/rows/#drag-and-drop) - Drag and drop allows user to dynamically rearrange the rows.
-* [**Context Menu**](https://ej2.syncfusion.com/angular/documentation/gantt/context-menu/) - The context menu improves user action with Gantt Chart using a pop-up menu. It appears when a cell or header is right-clicked.
-* [**Resource View**](https://ej2.syncfusion.com/angular/documentation/gantt/resource-view/) - Visualize the list of tasks assigned to each resource in a hierarchical manner.
-    * [**OverAllocation**](https://ej2.syncfusion.com/angular/documentation/gantt/resource-view/#resource-overallocation) - When a resource is assigned too much of work to complete within a day of resource’s available time then it is highlighted by a square bracket.
-    * [**Multi Taskbar**](https://ej2.syncfusion.com/angular/documentation/gantt/resource-view/#resource-multi-taskbar) - Allows user to visualize multiple tasks assigned to each resource in a row.
-* [**Exporting**](https://ej2.syncfusion.com/angular/documentation/gantt/excel-export/) - Allows you to export Gantt data to Excel, PDF and CSV formats.
-* [**Zooming**](https://ej2.syncfusion.com/angular/documentation/gantt/timeline/#zooming) - Zooming feature enables you to view the tasks in the project clearly from minute to year timespan.
-* [**Split Tasks**](https://ej2.syncfusion.com/angular/demos/#/material/gantt/split-tasks) - Allows an interruption in the task due to circumstances such as the occurrence of an unplanned event or reprioritization of already planned events. In such situtations, the pending work can be split into segments and the work can be resumed at a different date.
-* [**Virtual Scrolling**](https://ej2.syncfusion.com/angular/demos/#/material/gantt/virtual-scroll) - Allows user to load a large amount of data effectively.
-* [**Templates**](https://ej2.syncfusion.com/angular/demos/#/material/gantt/taskbar-template) - Templates can be used to create custom user experiences in the gantt.
-* [**Enriched UI**](https://ej2.syncfusion.com/angular/documentation/appearance/theme/) – Support for Material, bootstrap, fabric and high contrast themes along with other UI options like holidays support, vertical and horizontal grid lines support and so on.
-* [**Localization**](https://ej2.syncfusion.com/angular/documentation/gantt/global-local/) - Provides inherent support to localize the UI.
+| [<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; | 
+| :-----: | :-----: | :-----: | :-----: | :-----: |
+
+## Key features
+
+* [Data sources](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/local-data): Bind hierarchical or self-referential data to Gantt chart with an array of JSON objects or DataManager.
+* [Timeline](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/timeline): Display timescale from minutes to decades easily, and also display custom texts in the timeline units. Timeline can be displayed in either one-tier or two-tier layout.
+* [Task dependency](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/editing): Allows for the definition or update of dependencies between tasks in a project using four types of task dependencies: Finish – Start, Start – Finish, Finish – Finish, and Start – Start.
+* [Resources](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/resource-view): Visualizes the list of tasks assigned to each resource in hierarchy manner and switch the resources as per user need by task editing.
+* [Editing](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/editing): Provides the options to dynamically insert, delete and update tasks using columns, dialog and taskbar editing options.
+* [Virtual scrolling](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/virtual-scroll): Improves the performance of the gantt control when binding large amounts of data by only rendering the currently visible parts of the user interface and rendering other elements as needed while scrolling.
+* [Critical path](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/critical-path): The critical path in a project is displayed by a single task or a series of tasks. If a task in critical path is delayed, the entire project will be delayed. A task is considered to be critical if any delay to this task would affect the project end date.
+* [Customizable taskbars](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/taskbar-template): Display various tasks in a project using parent and child taskbars, summary taskbars and milestone UI, which can be customized with templates.
+* [Unscheduled tasks](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/unscheduled-task): Gantt Chart supports the display of tasks with undefined start date, end date or duration in a project.
+* [Baseline](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/baseline): Display the deviations between planned dates and actual dates of a task in a project using baselines.
+* [Markers and indicators](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/event-markers): Display indicators and flags along with taskbars and task labels. Also map important events in a project using event marker.
+* [Task label customization](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/tasklabel-template): Allows for the customization of labels within and on either side of the task bar.
+* [Sorting](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/sorting-api): Supports n levels of sorting.
+* [Filtering](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/filtering): Offers filter UIs such as filter bar and menu at each column to filter data. Also allows for filtering based on related parent or child records.
+* [Columns](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/column-menu): Column definitions are used as the dataSource schema in the gantt. This plays a vital role in rendering column values in the required format. Column functionalities such as resizing, reordering, column template, show or hide columns, etc., are supported.
+* [Column re-ordering](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/reorder): Drag any column and drop it at any position in the grid's column header row, to reposition the column.
+* [Column resizing](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/resize): Resizing allows changing column width on the fly by simply dragging the right corner of the column header.
+* [Row re-ordering](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/drag-and-drop): Allows rows to be rearranged through drag and drop actions, changing their position and hierarchy level. A child row can be moved as a sibling within the same parent row or as a child to a different parent row.
+* [Selection](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/selection): Rows or cells can be selected in the Gantt Chart. One or more rows or cells can also be selected by holding Shift, Ctrl or Command, or programmatically.
+* [Templates](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_campaign=angular-gantt-npm#/bootstrap5/gantt/column-template): Templates can be used to create custom user experiences in the gantt.
+* [RTL support](https://ej2.syncfusion.com/angular/documentation/gantt/global-local/#right-to-left-rtl): Provides the right-to-left mode which aligns content in the Gantt Chart component from right to left. This improves user experience and accessibility for those who work with RTL languages like Hebrew and Arabic.
+* [Localization](https://ej2.syncfusion.com/angular/documentation/gantt/global-local/#localization): Provides inherent support to localize the UI.
 
 ## Support
 
-Product support is available for through following mediums.
+Product support is available through following mediums.
 
-* Creating incident in Syncfusion [Direct-trac](https://www.syncfusion.com/support/directtrac/incidents?utm_source=npm&utm_campaign=gantt) support system or [Community forum](https://www.syncfusion.com/forums/angular-js2?utm_source=npm&utm_campaign=gantt).
-* New [GitHub issue](https://github.com/syncfusion/ej2-angular-ui-components/issues/new).
-* 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-gantt-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-gantt-npm)
+* Live chat
 
-## License
+## Changelog
 
-Check the license detail [here](https://github.com/syncfusion/ej2-angular-ui-components/blob/master/license).
+Check the changelog [here](https://github.com/syncfusion/ej2-angular-ui-components/blob/master/components/gantt/CHANGELOG.md). 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).
 
-Check the changelog [here](https://github.com/syncfusion/ej2-angular-ui-components/blob/master/components/gantt/CHANGELOG.md)
+> 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.
 
+See [LICENSE FILE](https://github.com/syncfusion/ej2-angular-ui-components/blob/master/license) for more info.
 
 © Copyright 2022 Syncfusion, Inc. All Rights Reserved. The Syncfusion Essential Studio license and copyright applies to this distribution.