@syncfusion/ej2-angular-querybuilder 21.2.4 → 22.1.34
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 +39 -109
- package/license +10 -0
- package/package.json +19 -13
- package/schematics/utils/lib-details.ts +2 -2
- package/styles/material3-dark.css +815 -0
- package/styles/material3-dark.scss +3 -0
- package/styles/material3.css +871 -0
- package/styles/material3.scss +3 -0
- package/styles/query-builder/_layout.scss +71 -13
- package/styles/query-builder/_material3-dark-definition.scss +1 -0
- package/styles/query-builder/_material3-definition.scss +110 -0
- package/styles/query-builder/icons/_material3-dark.scss +1 -0
- package/styles/query-builder/material3-dark.css +815 -0
- package/styles/query-builder/material3-dark.scss +16 -0
- package/styles/query-builder/material3.css +871 -0
- package/styles/query-builder/material3.scss +16 -0
- package/schematics/collection.json +0 -10
- package/schematics/ng-add/index.d.ts +0 -3
- package/schematics/ng-add/index.js +0 -9
- package/schematics/ng-add/schema.d.ts +0 -13
- package/schematics/ng-add/schema.js +0 -2
- package/schematics/ng-add/schema.json +0 -34
- package/schematics/tsconfig.json +0 -25
- package/schematics/utils/lib-details.d.ts +0 -4
- package/schematics/utils/lib-details.js +0 -6
package/README.md
CHANGED
|
@@ -1,140 +1,70 @@
|
|
|
1
|
-
#
|
|
1
|
+
# ej2-angular-querybuilder
|
|
2
2
|
|
|
3
|
-
The [Angular Query Builder](https://www.syncfusion.com/angular-ui-components/angular-query-builder?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm)
|
|
3
|
+
The [Angular Query Builder](https://www.syncfusion.com/angular-ui-components/angular-query-builder?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm) is a rich and responsive UI for filtering large amounts of data by creating or editing conditions that can be combined with data visualization controls like DataGrid and Charts to view the filtered data. It outputs structured JSON filters that can be easily parsed to create SQL queries. It allows you to create conditions and group them using AND/OR logic.
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
<a href="https://ej2.syncfusion.com/angular/documentation/query-builder/getting-started/?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm">Getting started</a> .
|
|
7
|
-
<a href="https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm#/bootstrap5/query-builder/default">Online demos</a> .
|
|
8
|
-
<a href="https://www.syncfusion.com/angular-components/angular-query-builder?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm">Learn more</a>
|
|
5
|
+
|
|
9
6
|
|
|
10
|
-
|
|
7
|
+
> 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).
|
|
11
8
|
|
|
12
|
-
|
|
13
|
-
Trusted by the world's leading companies
|
|
14
|
-
<a href="https://www.syncfusion.com">
|
|
15
|
-
<img src="https://raw.githubusercontent.com/SyncfusionExamples/nuget-img/master/syncfusion/syncfusion-trusted-companies.webp" alt="Bootstrap logo">
|
|
16
|
-
</a>
|
|
17
|
-
</p>
|
|
9
|
+
> 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.
|
|
18
10
|
|
|
19
11
|
## Setup
|
|
20
12
|
|
|
21
|
-
|
|
13
|
+
To install `QueryBuilder` and its dependent packages, use the following command
|
|
22
14
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
```bash
|
|
26
|
-
npm install -g @angular/cli
|
|
15
|
+
```sh
|
|
16
|
+
npm install @syncfusion/ej2-angular-querybuilder
|
|
27
17
|
```
|
|
28
18
|
|
|
29
|
-
|
|
19
|
+
## Components included
|
|
30
20
|
|
|
31
|
-
|
|
32
|
-
ng new my-app
|
|
33
|
-
cd my-app
|
|
34
|
-
```
|
|
21
|
+
Following list of components are available in the package.
|
|
35
22
|
|
|
36
|
-
|
|
23
|
+
* QueryBuilder - `QueryBuilder` Query Builder component is a graphical user interface that allows users to create and edit filters. It outputs a structured JSON of filters that can be easily parsed to create SQL. It is integrated with Data Manager to communicate with data sources and returns the desired result based on the provided filter. It supports data binding, templates, validation, and horizontal and vertical orientation.
|
|
37
24
|
|
|
38
|
-
|
|
25
|
+
* [Getting Started](https://ej2.syncfusion.com/angular/documentation/querybuilder/getting-started?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm)
|
|
26
|
+
* [View Online Demos](https://ej2.syncfusion.com/angular/demos/?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm#/material/querybuilder/default)
|
|
27
|
+
* [Product Page](https://www.syncfusion.com/angular-ui-components/angular-query-builder?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm)
|
|
39
28
|
|
|
40
|
-
|
|
41
|
-
ng add @syncfusion/ej2-angular-querybuilder
|
|
42
|
-
```
|
|
29
|
+
## Supported Frameworks
|
|
43
30
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
* Adds `@syncfusion/ej2-angular-querybuilder` package and its peer dependencies to your `package.json` file.
|
|
47
|
-
* Imports the `QueryBuilderModule` in your application module `app.module.ts`.
|
|
48
|
-
* Registers the Syncfusion UI default theme (material) in the `angular.json` file.
|
|
49
|
-
|
|
50
|
-
This makes it easy to add the Syncfusion Angular Query Builder module to your project and start using it in your application.
|
|
51
|
-
|
|
52
|
-
### Add Syncfusion Angular Query Builder component
|
|
53
|
-
|
|
54
|
-
In **src/app/app.component.ts**, use `<ejs-querybuilder>` selector in the `template` attribute of the `@Component` directive to render the Syncfusion Angular Query Builder component.
|
|
55
|
-
|
|
56
|
-
```typescript
|
|
57
|
-
import { Component, OnInit } from '@angular/core';
|
|
58
|
-
@Component({
|
|
59
|
-
selector: 'app-root',
|
|
60
|
-
template: `<ejs-querybuilder width="70%" [rule]="importRules">
|
|
61
|
-
<e-columns>
|
|
62
|
-
<e-column field="EmployeeID" label="Employee ID" type="number"></e-column>
|
|
63
|
-
<e-column field="FirstName" label="First Name" type="string"></e-column>
|
|
64
|
-
<e-column field="TitleOfCourtesy" label="Title Of Courtesy" type="boolean" [values]="values"></e-column>
|
|
65
|
-
<e-column field="Title" label="Title" type="string"></e-column>
|
|
66
|
-
<e-column field="HireDate" label="Hire Date" type="date" format="dd/MM/yyyy"></e-column>
|
|
67
|
-
<e-column field="Country" label="Country" type="string"></e-column>
|
|
68
|
-
<e-column field="City" label="City" type="string"></e-column>
|
|
69
|
-
</e-columns>
|
|
70
|
-
</ejs-querybuilder>`
|
|
71
|
-
})
|
|
72
|
-
export class AppComponent implements OnInit {
|
|
73
|
-
public importRules: RuleModel;
|
|
74
|
-
public values: string[] = ['Mr.', 'Mrs.'];
|
|
75
|
-
|
|
76
|
-
ngOnInit(): void {
|
|
77
|
-
this.importRules = {
|
|
78
|
-
'condition': 'and',
|
|
79
|
-
'rules': [{
|
|
80
|
-
'label': 'EmployeeID',
|
|
81
|
-
'field': 'EmployeeID',
|
|
82
|
-
'type': 'number',
|
|
83
|
-
'operator': 'equal',
|
|
84
|
-
'value': 1
|
|
85
|
-
},
|
|
86
|
-
{
|
|
87
|
-
'label': 'Title',
|
|
88
|
-
'field': 'Title',
|
|
89
|
-
'type': 'string',
|
|
90
|
-
'operator': 'equal',
|
|
91
|
-
'value': 'Sales Manager'
|
|
92
|
-
}]
|
|
93
|
-
};
|
|
94
|
-
}
|
|
95
|
-
}
|
|
96
|
-
```
|
|
31
|
+
These components are available in following list of frameworks.
|
|
97
32
|
|
|
98
|
-
|
|
33
|
+
1. [React Query Builder](https://www.syncfusion.com/react-ui-components/react-query-builder?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm)
|
|
34
|
+
2. [Vue Query Builder](https://www.syncfusion.com/vue-ui-components/vue-query-builder?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm)
|
|
35
|
+
3. [JavaScript Query Builder](https://www.syncfusion.com/javascript-ui-controls/js-query-builder?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm)
|
|
36
|
+
4. [ASP.NET Core Query Builder](https://www.syncfusion.com/aspnet-core-ui-controls/query-builder?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm)
|
|
37
|
+
5. [ASP.NET MVC Query Builder](https://www.syncfusion.com/aspnet-mvc-ui-controls/query-builder?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm)
|
|
99
38
|
|
|
100
|
-
|
|
39
|
+
## Showcase samples
|
|
101
40
|
|
|
102
|
-
|
|
103
|
-
|
|
41
|
+
* Expense Tracker ([Source](https://github.com/syncfusion/ej2-showcase-angular-expensetracker?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm), [Live Demo](https://ej2.syncfusion.com/showcase/angular/expensetracker/#/dashboard?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm))
|
|
42
|
+
* Loan Calculator ([Source](https://github.com/syncfusion/ej2-showcase-angular-loancalculator?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm), [Live Demo](https://ej2.syncfusion.com/showcase/angular/loancalculator/?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm))
|
|
104
43
|
|
|
105
|
-
## Key
|
|
44
|
+
## Key Features
|
|
106
45
|
|
|
107
|
-
|
|
108
|
-
* [Template](https://ej2.syncfusion.com/angular/documentation/query-builder/templates): The Query Builder offers templates that allow users to create custom user experiences by customizing the user interface for individual values, the entire rule, and the group header. This allows users to tailor the Query Builder to their specific needs and preferences.
|
|
109
|
-
* [Importing and Exporting](https://ej2.syncfusion.com/angular/documentation/query-builder/import-export): The Query Builder allows users to export filters or conditions as SQL and structured JSON, and to import these filters into the Query Builder for regeneration. This makes it easy for users to save and share their filters with others.
|
|
110
|
-
* [Model Binding](https://ej2.syncfusion.com/angular/documentation/query-builder/model-binding): The Query Builder allows users to bind properties for the components used in the field, operator, and value user interfaces, allowing users to define the behavior and appearance of these components.
|
|
111
|
-
* [RTL support](https://ej2.syncfusion.com/angular/documentation/query-builder/how-to/rtl): The Query Builder supports RTL (right-to-left) mode, which aligns content from right to left. This is useful for languages that are written in a right-to-left script, such as Arabic.
|
|
112
|
-
* [Localization](https://ej2.syncfusion.com/angular/documentation/query-builder/global-local): The Query Builder provides inherent support for localization, allowing users to easily translate the user interface into different languages. This makes the Query Builder more accessible to users who speak languages other than English.
|
|
113
|
-
* Rich and responsive UI: The Query Builder provides a user-friendly interface for creating and editing conditions, making it easy for users to filter large amounts of data.
|
|
114
|
-
* AND/OR logic: The Query Builder allows users to group conditions using AND/OR logic, giving them greater control over the filtered data.
|
|
115
|
-
* Integration with data visualization controls: The Query Builder can be used in conjunction with data visualization controls like DataGrid and Charts to view the filtered data, providing a more comprehensive view of the data.
|
|
116
|
-
* Easy to use: The Query Builder is easy to use and can be easily integrated into any project, making it a convenient and powerful tool for filtering data.
|
|
46
|
+
### QueryBuilder
|
|
117
47
|
|
|
118
|
-
|
|
48
|
+
- **Data binding**: It auto populates the data source and maps the data to the appropriate fields.
|
|
119
49
|
|
|
120
|
-
|
|
50
|
+
- **Template**: Supports templates and it is applicable for all input components.
|
|
121
51
|
|
|
122
|
-
|
|
123
|
-
* [Community forum](https://www.syncfusion.com/forums/angular-js2?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm)
|
|
124
|
-
* [GitHub issues](https://github.com/syncfusion/ej2-angular-ui-components/issues/new)
|
|
125
|
-
* [Request feature or report bug](https://www.syncfusion.com/feedback/angular?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm)
|
|
126
|
-
* Live chat
|
|
52
|
+
- **Queries**: Queries supports JSON/SQL rules.
|
|
127
53
|
|
|
128
|
-
##
|
|
54
|
+
## Support
|
|
129
55
|
|
|
130
|
-
|
|
56
|
+
Product support is available for through following mediums.
|
|
131
57
|
|
|
132
|
-
|
|
58
|
+
* Creating incident in Syncfusion [Direct-trac](https://www.syncfusion.com/support/directtrac/incidents?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm) support system or [Community forum](https://www.syncfusion.com/forums/angular-js2?utm_source=npm&utm_campaign=querybuilder)?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm.
|
|
59
|
+
* New [GitHub issue](https://github.com/syncfusion/ej2-angular-ui-components/issues/new?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm ).
|
|
60
|
+
* Ask your query in [Stack Overflow](https://stackoverflow.com/?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm) with tag `syncfusion`, `ej2`.
|
|
133
61
|
|
|
134
|
-
|
|
62
|
+
## License
|
|
135
63
|
|
|
136
|
-
|
|
64
|
+
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-query-builder-npm).
|
|
65
|
+
|
|
66
|
+
## Changelog
|
|
137
67
|
|
|
138
|
-
|
|
68
|
+
Check the changelog [here](https://github.com/syncfusion/ej2-angular-ui-components/blob/master/components/querybuilder/CHANGELOG.md?utm_source=npm&utm_medium=listing&utm_campaign=angular-query-builder-npm)
|
|
139
69
|
|
|
140
70
|
© Copyright 2023 Syncfusion, Inc. All Rights Reserved. The Syncfusion Essential Studio license and copyright applies to this distribution.
|
package/license
ADDED
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
Essential JS 2 library is available under the Syncfusion Essential Studio program, and can be licensed either under the Syncfusion Community License Program or the Syncfusion commercial license.
|
|
2
|
+
|
|
3
|
+
To be qualified for the Syncfusion Community License Program you must have a gross revenue of less than one (1) million U.S. dollars ($1,000,000.00 USD) per year and have less than five (5) developers in your organization, and agree to be bound by Syncfusion’s terms and conditions.
|
|
4
|
+
|
|
5
|
+
Customers who do not qualify for the community license can contact sales@syncfusion.com for commercial licensing options.
|
|
6
|
+
|
|
7
|
+
Under no circumstances can you use this product without (1) either a Community License or a commercial license and (2) without agreeing and abiding by Syncfusion’s license containing all terms and conditions.
|
|
8
|
+
|
|
9
|
+
The Syncfusion license that contains the terms and conditions can be found at
|
|
10
|
+
https://www.syncfusion.com/content/downloads/syncfusion_license.pdf
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"_from": "@syncfusion/ej2-angular-querybuilder@*",
|
|
3
|
-
"_id": "@syncfusion/ej2-angular-querybuilder@
|
|
3
|
+
"_id": "@syncfusion/ej2-angular-querybuilder@20.1.59",
|
|
4
4
|
"_inBundle": false,
|
|
5
|
-
"_integrity": "sha512-
|
|
5
|
+
"_integrity": "sha512-6PatKdhzadzAg1U5wP49Y2Zisn0AJKFpF4B/sZ36Ucjj9ACMyx8zj4ICONlBZ5tlM+9VwFE2SSVDnuUXiUnz+w==",
|
|
6
6
|
"_location": "/@syncfusion/ej2-angular-querybuilder",
|
|
7
7
|
"_phantomChildren": {},
|
|
8
8
|
"_requested": {
|
|
@@ -19,8 +19,8 @@
|
|
|
19
19
|
"_requiredBy": [
|
|
20
20
|
"/"
|
|
21
21
|
],
|
|
22
|
-
"_resolved": "https://nexus.syncfusion.com/repository/ej2-angular-
|
|
23
|
-
"_shasum": "
|
|
22
|
+
"_resolved": "https://nexus.syncfusion.com/repository/ej2-angular-release/@syncfusion/ej2-angular-querybuilder/-/ej2-angular-querybuilder-20.1.59.tgz",
|
|
23
|
+
"_shasum": "9dc0c25f1bc37a2b865eece9cdbf34096b14c151",
|
|
24
24
|
"_spec": "@syncfusion/ej2-angular-querybuilder@*",
|
|
25
25
|
"_where": "/jenkins/workspace/elease-automation_release_21.1.1/ivypackages/included",
|
|
26
26
|
"author": {
|
|
@@ -31,9 +31,9 @@
|
|
|
31
31
|
},
|
|
32
32
|
"bundleDependencies": false,
|
|
33
33
|
"dependencies": {
|
|
34
|
-
"@syncfusion/ej2-angular-base": "~
|
|
35
|
-
"@syncfusion/ej2-base": "~
|
|
36
|
-
"@syncfusion/ej2-querybuilder": "
|
|
34
|
+
"@syncfusion/ej2-angular-base": "~22.1.34",
|
|
35
|
+
"@syncfusion/ej2-base": "~22.1.34",
|
|
36
|
+
"@syncfusion/ej2-querybuilder": "22.1.34",
|
|
37
37
|
"tslib": "^2.3.0"
|
|
38
38
|
},
|
|
39
39
|
"deprecated": false,
|
|
@@ -57,13 +57,19 @@
|
|
|
57
57
|
"fesm2020": "fesm2020/syncfusion-ej2-angular-querybuilder.mjs",
|
|
58
58
|
"homepage": "https://www.syncfusion.com/angular-components",
|
|
59
59
|
"keywords": [
|
|
60
|
+
"ej2",
|
|
61
|
+
"Syncfusion",
|
|
62
|
+
"web-components",
|
|
63
|
+
"ej2-query-builder",
|
|
64
|
+
"ej2-querybuilder",
|
|
65
|
+
"query-builder",
|
|
66
|
+
"querybuilder",
|
|
60
67
|
"angular",
|
|
61
68
|
"ng",
|
|
62
|
-
"ej2
|
|
63
|
-
"ng
|
|
64
|
-
"angular
|
|
65
|
-
"
|
|
66
|
-
"angular filter"
|
|
69
|
+
"ej2-ng-query-builder",
|
|
70
|
+
"ng-query-builder",
|
|
71
|
+
"ej2-angular-query-builder",
|
|
72
|
+
"ng-querybuilder"
|
|
67
73
|
],
|
|
68
74
|
"license": "SEE LICENSE IN license",
|
|
69
75
|
"module": "fesm2015/syncfusion-ej2-angular-querybuilder.mjs",
|
|
@@ -75,5 +81,5 @@
|
|
|
75
81
|
"schematics": "./schematics/collection.json",
|
|
76
82
|
"sideEffects": false,
|
|
77
83
|
"typings": "syncfusion-ej2-angular-querybuilder.d.ts",
|
|
78
|
-
"version": "
|
|
84
|
+
"version": "22.1.34"
|
|
79
85
|
}
|