@syncfusion/ej2-angular-treemap 20.4.38 → 20.4.40
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +117 -43
- package/package.json +4 -4
- package/schematics/utils/lib-details.d.ts +2 -2
package/README.md
CHANGED
|
@@ -1,69 +1,143 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Angular TreeMap Component
|
|
2
2
|
|
|
3
|
-
The
|
|
3
|
+
The [Angular TreeMap](https://www.syncfusion.com/angular-components/angular-treemap?utm_source=npm&utm_medium=listing&utm_campaign=angular-treemap-npm) component provides a simple and effective way to visualize flat or hierarchical data as clustered rectangles with a specific, weighted attribute determining the size of each rectangle.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
<p align="center">
|
|
6
|
+
<a href="https://ej2.syncfusion.com/angular/documentation/treemap/getting-started/?utm_source=npm&utm_medium=listing&utm_campaign=angular-treemap-npm">Getting started</a> .
|
|
7
|
+
<a href="https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_medium=listing&utm_campaign=angular-treemap-npm#/bootstrap5/treemap/default">Online demos</a> .
|
|
8
|
+
<a href="https://www.syncfusion.com/angular-components/angular-treemap?utm_source=npm&utm_medium=listing&utm_campaign=angular-treemap-npm">Learn more</a>
|
|
9
|
+
</p>
|
|
6
10
|
|
|
7
|
-
|
|
11
|
+
<p align="center">
|
|
12
|
+
<img src="https://raw.githubusercontent.com/SyncfusionExamples/nuget-img/master/angular/angular-treemap.png" alt="Angular TreeMap Component">
|
|
13
|
+
</p>
|
|
14
|
+
|
|
15
|
+
<p align="center">
|
|
16
|
+
Trusted by the world's leading companies
|
|
17
|
+
<a href="https://www.syncfusion.com">
|
|
18
|
+
<img src="https://raw.githubusercontent.com/SyncfusionExamples/nuget-img/master/syncfusion/syncfusion-trusted-companies.webp" alt="Bootstrap logo">
|
|
19
|
+
</a>
|
|
20
|
+
</p>
|
|
8
21
|
|
|
9
22
|
## Setup
|
|
10
23
|
|
|
11
|
-
|
|
24
|
+
### Create an Angular Application
|
|
12
25
|
|
|
13
|
-
|
|
14
|
-
|
|
26
|
+
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.
|
|
27
|
+
|
|
28
|
+
```bash
|
|
29
|
+
npm install -g @angular/cli
|
|
15
30
|
```
|
|
16
31
|
|
|
17
|
-
|
|
32
|
+
Create a new Angular application using the following Angular CLI command.
|
|
18
33
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
34
|
+
```bash
|
|
35
|
+
ng new my-app
|
|
36
|
+
cd my-app
|
|
37
|
+
```
|
|
22
38
|
|
|
23
|
-
|
|
39
|
+
### Add Syncfusion TreeMap package
|
|
24
40
|
|
|
25
|
-
|
|
41
|
+
All Syncfusion Angular packages are available in [npmjs.com](https://www.npmjs.com/~syncfusionorg). To install the Angular TreeMap package, use the following command.
|
|
26
42
|
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
4. [ASP.NET Core](https://aspdotnetcore.syncfusion.com/TreeMap/Default#/material)
|
|
31
|
-
5. [ASP.NET MVC](https://aspnetmvc.syncfusion.com/TreeMap/Default#/material)
|
|
32
|
-
6. [JavaScript (ES5)](https://www.syncfusion.com/products/javascript/treemap)
|
|
43
|
+
```sh
|
|
44
|
+
npm install @syncfusion/ej2-angular-treemap
|
|
45
|
+
```
|
|
33
46
|
|
|
34
|
-
|
|
47
|
+
The above command does the below configuration to your Angular app.
|
|
48
|
+
|
|
49
|
+
* Adds `@syncfusion/ej2-angular-treemap` package and its peer dependencies to your `package.json` file.
|
|
50
|
+
* Imports the `TreeMapModule` in your application module `app.module.ts`.
|
|
51
|
+
* Registers the Syncfusion UI default theme (material) in the `angular.json` file.
|
|
52
|
+
|
|
53
|
+
This makes it easy to add the Syncfusion Angular TreeMap module to your project and start using it in your application.
|
|
54
|
+
|
|
55
|
+
### Add TreeMap component
|
|
56
|
+
|
|
57
|
+
In **src/app/app.component.ts**, use `<ejs-treemap>` selector in the `template` attribute of the `@Component` directive to render the Syncfusion Angular TreeMap component.
|
|
58
|
+
|
|
59
|
+
```typescript
|
|
60
|
+
import { Component } from '@angular/core';
|
|
61
|
+
@Component({
|
|
62
|
+
selector: 'app-container',
|
|
63
|
+
template:
|
|
64
|
+
`<ejs-treemap id='container' style='display: block;' height='350px' [dataSource]='data' weightValuePath='Count'
|
|
65
|
+
[leafItemSettings]='leafItemSettings'>
|
|
66
|
+
</ejs-treemap>`
|
|
67
|
+
})
|
|
68
|
+
export class AppComponent {
|
|
69
|
+
public data: object[] = [
|
|
70
|
+
{ State: 'Brazil', Count: 25 },
|
|
71
|
+
{ State: 'Colombia', Count: 12 },
|
|
72
|
+
{ State: 'Argentina', Count: 9 },
|
|
73
|
+
{ State: 'Ecuador', Count: 7 },
|
|
74
|
+
{ State: 'Chile', Count: 6 },
|
|
75
|
+
{ State: 'Peru', Count: 3 },
|
|
76
|
+
{ State: 'Venezuela', Count: 3 },
|
|
77
|
+
{ State: 'Bolivia', Count: 2 },
|
|
78
|
+
{ State: 'Paraguay', Count: 2 },
|
|
79
|
+
{ State: 'Uruguay', Count: 2 },
|
|
80
|
+
{ State: 'Falkland Islands',Count: 1 },
|
|
81
|
+
{ State: 'French Guiana', Count:1 },
|
|
82
|
+
{ State: 'Guyana', Count: 1 },
|
|
83
|
+
{ State: 'Suriname', Count: 1 },
|
|
84
|
+
];
|
|
85
|
+
public leafItemSettings: object = {
|
|
86
|
+
labelPath: 'State'
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
```
|
|
35
90
|
|
|
36
|
-
|
|
37
|
-
* Countries population details ([Live Demo](https://ej2.syncfusion.com/angular/demos/#/material/treemap/drilldown))
|
|
91
|
+
## Supported frameworks
|
|
38
92
|
|
|
39
|
-
|
|
93
|
+
TreeMap component is also offered in the following list of frameworks.
|
|
40
94
|
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
* [**Layout**](https://ej2.syncfusion.com/angular/demos/#/material/treemap/layout) - Supports four types of layouts: square, horizontal, vertical, and auto.
|
|
44
|
-
* [**Drill-down**](https://ej2.syncfusion.com/angular/demos/#/material/treemap/drilldown) - Provides drill-down option to have a closer look at the lower level of a hierarchy.
|
|
45
|
-
* [**Data label**](https://ej2.syncfusion.com/angular/demos/#/material/treemap/label) - Provides additional information about the nodes.
|
|
46
|
-
* [**Label template**](https://ej2.syncfusion.com/angular/demos/#/material/treemap/custom) - Uses any custom HTML element as data label for each node.
|
|
47
|
-
* [**Color mapping**](https://ej2.syncfusion.com/angular/demos/#/material/treemap/label) - Applies colors to the nodes based on various conditions. Tree map supports three types of color mapping: range, equal, and desaturation.
|
|
48
|
-
* [**Legend**](https://ej2.syncfusion.com/angular/demos/#/material/treemap/legend) - Denotes the color mapping categories.
|
|
49
|
-
* [**Selection and Highlight**](https://ej2.syncfusion.com/angular/demos/#/material/treemap/selection) - Supports selecting or highlighting the nodes to bring center of attraction.
|
|
50
|
-
* [**Tooltip**](https://ej2.syncfusion.com/angular/demos/#/material/treemap/tooltip) - Provides additonal information about the nodes on mouse hover.
|
|
51
|
-
* [**Print and Export**](https://ej2.syncfusion.com/angular/demos/#/material/treemap/print) - Provides options to print and export the rendered tree map for future use.
|
|
95
|
+
| [<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/> [JavaScript](https://www.syncfusion.com/javascript-ui-controls?utm_medium=listing&utm_source=github) | [<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/> [React](https://www.syncfusion.com/react-ui-components?utm_medium=listing&utm_source=github) | [<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/> [Vue](https://www.syncfusion.com/vue-ui-components?utm_medium=listing&utm_source=github) | [<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/> [ASP.NET Core](https://www.syncfusion.com/aspnet-core-ui-controls?utm_medium=listing&utm_source=github) | [<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/> [ASP.NET MVC](https://www.syncfusion.com/aspnet-mvc-ui-controls?utm_medium=listing&utm_source=github) |
|
|
96
|
+
| :-----: | :-----: | :-----: | :-----: | :-----: |
|
|
52
97
|
|
|
53
|
-
##
|
|
98
|
+
## Showcase samples
|
|
54
99
|
|
|
55
|
-
|
|
100
|
+
* Olympic medal categories details - [Live Demo](https://ej2.syncfusion.com/angular/demos/#/material/treemap/custom)
|
|
101
|
+
* Countries population details - [Live Demo](https://ej2.syncfusion.com/angular/demos/#/material/treemap/drilldown)
|
|
102
|
+
* Fitness Tracker - [Source](https://github.com/SyncfusionExamples/showcase-angular-health-tracker-dashboard-demo), [Live Demo](https://ej2.syncfusion.com/showcase/angular/fitness-tracker-app/)
|
|
56
103
|
|
|
57
|
-
|
|
58
|
-
* New [GitHub issues](https://github.com/syncfusion/ej2-angular-ui-components/issues).
|
|
59
|
-
* Ask your query in Stack Overflow with tag `syncfusion`, `ej2`.
|
|
104
|
+
## Key features
|
|
60
105
|
|
|
61
|
-
|
|
106
|
+
* [Data sources](https://ej2.syncfusion.com/angular/documentation/treemap/data-binding/?utm_source=npm&utm_campaign=angular-treemap-npm): Binds the treemap component with an array of JSON objects or DataManager. Both hierarchical and flat collection data sources are supported.
|
|
107
|
+
* [Levels](https://ej2.syncfusion.com/angular/documentation/treemap/levels/?utm_source=npm&utm_campaign=angular-treemap-npm): Renders with any number of levels and items.
|
|
108
|
+
* [Layout](https://ej2.syncfusion.com/angular/documentation/treemap/layout/?utm_source=npm&utm_campaign=angular-treemap-npm): Supports four types of layouts: square, horizontal, vertical, and auto.
|
|
109
|
+
* [Drill-down](https://ej2.syncfusion.com/angular/documentation/treemap/drilldown/?utm_source=npm&utm_campaign=angular-treemap-npm): Provides drill-down option to have a closer look at the lower level of a hierarchy.
|
|
110
|
+
* [Data label](https://ej2.syncfusion.com/angular/documentation/treemap/data-label/?utm_source=npm&utm_campaign=angular-treemap-npm): Provides additional information about the nodes.
|
|
111
|
+
* [Header template](https://ej2.syncfusion.com/angular/documentation/treemap/levels/?utm_source=npm&utm_campaign=angular-treemap-npm#header-template-and-position): Uses any custom HTML element to customize the header of each item.
|
|
112
|
+
* [Label template](https://ej2.syncfusion.com/angular/documentation/treemap/data-label/?utm_source=npm&utm_campaign=angular-treemap-npm#template): Uses any custom HTML element to customize the data label for each node.
|
|
113
|
+
* [Color mapping](https://ej2.syncfusion.com/angular/documentation/treemap/color-mapping/?utm_source=npm&utm_campaign=angular-treemap-npm): Applies colors to the nodes based on various conditions. Treemap supports three types of color mapping: range, equal, and desaturation.
|
|
114
|
+
* [Legend](https://ej2.syncfusion.com/angular/documentation/treemap/legend/?utm_source=npm&utm_campaign=angular-treemap-npm): Provide useful information for conveying what the treemap showcases.
|
|
115
|
+
* [Selection and highlight](https://ej2.syncfusion.com/angular/documentation/treemap/selection-and-highlight/?utm_source=npm&utm_campaign=angular-treemap-npm): Support selecting or highlighting the nodes to bring center of attraction.
|
|
116
|
+
* [Tooltip](https://ej2.syncfusion.com/angular/documentation/treemap/tooltip/?utm_source=npm&utm_campaign=angular-treemap-npm): Provides additional information about the node on hover.
|
|
117
|
+
* [Print and Export](https://ej2.syncfusion.com/angular/documentation/treemap/print-and-export/?utm_source=npm&utm_campaign=angular-treemap-npm): Prints or exports the rendered treemap to a desired format. Exporting supports four formats: PDF, PNG, JPEG and SVG.
|
|
118
|
+
* [Globalization](https://ej2.syncfusion.com/angular/documentation/treemap/internationalization/?utm_source=npm&utm_medium=listing&utm_campaign=angular-treemap-npm): Personalize the treemap component with different languages, as well as culture-specific number, date and time formatting.
|
|
119
|
+
* [Accessibility](https://ej2.syncfusion.com/angular/documentation/treemap/accessibility/?utm_source=npm&utm_medium=listing&utm_campaign=angular-treemap-npm): Provides with built-in accessibility support which helps to access all the treemap component features through the keyboard, screen readers, or other assistive technology devices.
|
|
62
120
|
|
|
63
|
-
|
|
121
|
+
## Support
|
|
122
|
+
|
|
123
|
+
Product support is available through the following mediums.
|
|
124
|
+
|
|
125
|
+
* [Support ticket](https://support.syncfusion.com/support/tickets/create) - Guaranteed Response in 24 hours | Unlimited tickets | Holiday support
|
|
126
|
+
* [Community forum](https://www.syncfusion.com/forums/angular-js2?utm_source=npm&utm_medium=listing&utm_campaign=angular-treemap-npm)
|
|
127
|
+
* [GitHub issues](https://github.com/syncfusion/ej2-angular-ui-components/issues/new)
|
|
128
|
+
* [Request feature or report bug](https://www.syncfusion.com/feedback/angular?utm_source=npm&utm_medium=listing&utm_campaign=angular-treemap-npm)
|
|
129
|
+
* Live chat
|
|
64
130
|
|
|
65
131
|
## Changelog
|
|
66
132
|
|
|
67
|
-
Check the changelog [here](https://github.com/syncfusion/ej2-angular-ui-components/blob/master/components/treemap/CHANGELOG.md?utm_source=npm&utm_campaign=treemap)
|
|
133
|
+
Check the changelog [here](https://github.com/syncfusion/ej2-angular-ui-components/blob/master/components/treemap/CHANGELOG.md?utm_source=npm&utm_campaign=angular-treemap-npm). Get minor improvements and bug fixes every week to stay up to date with frequent updates.
|
|
134
|
+
|
|
135
|
+
## License and copyright
|
|
136
|
+
|
|
137
|
+
> 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).
|
|
138
|
+
|
|
139
|
+
> 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.
|
|
140
|
+
|
|
141
|
+
See [LICENSE FILE](https://github.com/syncfusion/ej2-angular-ui-components/blob/master/license?utm_source=npm&utm_campaign=angular-treemap-npm) for more info.
|
|
68
142
|
|
|
69
|
-
|
|
143
|
+
© Copyright 2022 Syncfusion, Inc. All Rights Reserved. The Syncfusion Essential Studio license and copyright applies to this distribution.
|
package/package.json
CHANGED
|
@@ -31,9 +31,9 @@
|
|
|
31
31
|
},
|
|
32
32
|
"bundleDependencies": false,
|
|
33
33
|
"dependencies": {
|
|
34
|
-
"@syncfusion/ej2-angular-base": "~20.4.
|
|
35
|
-
"@syncfusion/ej2-base": "~20.4.
|
|
36
|
-
"@syncfusion/ej2-treemap": "20.4.
|
|
34
|
+
"@syncfusion/ej2-angular-base": "~20.4.40",
|
|
35
|
+
"@syncfusion/ej2-base": "~20.4.40",
|
|
36
|
+
"@syncfusion/ej2-treemap": "20.4.40",
|
|
37
37
|
"tslib": "^2.3.0"
|
|
38
38
|
},
|
|
39
39
|
"deprecated": false,
|
|
@@ -87,5 +87,5 @@
|
|
|
87
87
|
"schematics": "./schematics/collection.json",
|
|
88
88
|
"sideEffects": false,
|
|
89
89
|
"typings": "syncfusion-ej2-angular-treemap.d.ts",
|
|
90
|
-
"version": "20.4.
|
|
90
|
+
"version": "20.4.40"
|
|
91
91
|
}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
export declare const pkgName = "@syncfusion/ej2-angular-treemap";
|
|
2
|
-
export declare const pkgVer = "^
|
|
2
|
+
export declare const pkgVer = "^20.4.38";
|
|
3
3
|
export declare const moduleName = "TreeMapModule";
|
|
4
|
-
export declare const themeVer = "~
|
|
4
|
+
export declare const themeVer = "~20.4.38";
|