Angular Grid Component

The Grid component for Angular is a powerful widget that displays tabular data. It offers rich support for interacting with data, including paging, grouping, sorting, filtering and editing.

Prerequisites

Refer to Angular Getting Started before you start with this help topic.

Configuration

I. Imports

The Grid component for Angular requires the following imports.

II. @Component Decorator

A class is marked as an Angular component through the @Component decorator:

selector - CSS selector that identifies this component in a template
styles - inline-defined styles to be applied to this component's view
styleUrls - list of URLs to stylesheets to be applied to this component's view
template - inline-defined template for the view
templateUrl - URL to an external file containing a template for the view

The full list of @Component decorator properties is available on: Angular @Component Decorator API

Every jQWidgets Angular component has an [auto-create] attribute which determines whether the component is automatically created or is created on demand by API method call.
By default, the [auto-create] attribute value is true.

III. Create the AppComponent class

The AppComponent class is used to instantiate the app. In some of the examples, we use @ViewChild and ngAfterViewInit.

@ViewChild: makes a reference using a Grid selector. View queries are set before the ngAfterViewInit callback is called.
@ViewChild('gridReference') myGrid: jqxGridComponent;
ngAfterViewInit - this is an Angular Component Lifecycle method in which we create our angular components. After the view is initialized, myGrid is available.
For more information about this methods please refer to Angular Component Lifecycle API

The following example demonstrates the Grid component for Angular.

app.component.htm

app.component.ts

Run Code

IV. Create Grid component with JSON

Add the imports.
import { Component, ViewChild, AfterViewInit } from '@angular/core';
import { jqxGridComponent } from 'jqwidgets-ng/jqxgrid';
@Component decorator:
```
@Component({
    selector: 'app-root',
    template: `<jqxGrid #gridReference></jqxGrid>`
})
```
Create the AppComponent class.
- @ViewChild: makes a reference using a Grid selector. View queries are set before the ngAfterViewInit callback is called.
```
@ViewChild('gridReference') myGrid: jqxGridComponent;
```
- ngAfterViewInit: All Angular components have an integrated method called createComponent that accept a JSON object with the component initialization properties. If no argument is passed, default properties will be used. If you would like to dynamically set properties after creation, you can use the setOptions method.
```
ngAfterViewInit(): void
{
    this.myGrid.createComponent(this.GridSettings);
}
```
The following example demonstrates how to create a Grid component for Angular by using the createComponent method.

Properties

The properties which are defined as attributes can be changed directly:

To get or set a property, which we did not define or call a method, we can do the following:

Import @ViewChild decorator:
Add the Grid component:
Get access to the Grid component and its API:
Finally, we can call methods or set/get properties like that:

Every component has a method setOptions which accepts a JSON object as an argument. This object contains component settings and you can use it to set a single or multiple properties dynamically.

Events

The filter event is triggered when the Grid is filtered.

The following example demonstrates how to add an event listener.

Note: Event Names of the Grid component for Angular are the same as the Event Names of the jqxGrid widget.
The only thing you need to do is to put "on" before the event name and upperCase it's the first letter.

Methods

To invoke methods, you can use the Grid reference.
( refresh() to refresh the widget ) - this.myGrid.refresh().

The following example demonstrates how to invoke methods of the Grid component for Angular.

Grid Examples

Overview

The following example demonstrates how to create a Grid component for Angular.

Editing

The following example demonstrates the Grid editing feature.

app.component.htm

app.component.ts

Run Code

Filtering

(requires jqxgrid.filter.js)

The following example demonstrates the Grid filtering feature.

app.component.htm

app.component.css

app.component.ts

Run Code

Paging

(requires jqxgrid.pager.js)

The following example demonstrates how to enable the paging feature of the Grid.

app.component.htm

app.component.css

app.component.ts

Run Code

Nested Grids

The following example demonstrates how to display nested Grid plugins.

app.component.htm

app.component.ts

Run Code

Using Angular Grid with Angular Directives

<jqxGrid #grid>  
   <tr>  
     <th>Id</th>  
     <th>Name</th>  
   </tr>  
   <tr *ngFor="let hero of heroes">  
     <td>  
       {{hero.id}}</td>  
     <td>  
       {{hero.name}}</td>  
   </tr>  
 </jqxGrid>

Grid API

API Reference of the jQWidgets Grid component for Angular: Grid API