1 import {Component, Input, Output, OnInit, AfterViewInit, EventEmitter,
2 OnDestroy, HostListener, ViewEncapsulation} from '@angular/core';
3 import {Subscription} from 'rxjs';
4 import {IdlService} from '@eg/core/idl.service';
5 import {OrgService} from '@eg/core/org.service';
6 import {ServerStoreService} from '@eg/core/server-store.service';
7 import {FormatService} from '@eg/core/format.service';
8 import {GridContext, GridColumn, GridDataSource, GridRowFlairEntry} from './grid';
11 * Main grid entry point.
16 templateUrl: './grid.component.html',
17 styleUrls: ['grid.component.css'],
18 // share grid css globally once imported so all grid component CSS
19 // can live in grid.component.css and to avoid multiple copies of
20 // the CSS when multiple grids are displayed.
21 encapsulation: ViewEncapsulation.None
24 export class GridComponent implements OnInit, AfterViewInit, OnDestroy {
26 // Source of row data.
27 @Input() dataSource: GridDataSource;
29 // IDL class for auto-generation of columns
30 @Input() idlClass: string;
32 // True if any columns are sortable
33 @Input() sortable: boolean;
35 // True if the grid supports sorting of multiple columns at once
36 @Input() multiSortable: boolean;
38 // If true, grid sort requests only operate on data that
39 // already exists in the grid data source -- no row fetching.
40 // The assumption is all data is already available.
41 @Input() useLocalSort: boolean;
43 // Storage persist key / per-grid-type unique identifier
44 // The value is prefixed with 'eg.grid.'
46 // If persistKey is set to "disabled", or does not exist,
47 // the grid will not display a Save button to the user
48 @Input() persistKey: string;
50 @Input() disableSelect: boolean;
52 // Prevent selection of multiple rows
53 @Input() disableMultiSelect: boolean;
55 // Show an extra column in the grid where the caller can apply
56 // row-specific flair (material icons).
57 @Input() rowFlairIsEnabled: boolean;
59 // Returns a material icon name to display in the flar column
60 // (if enabled) for the given row.
61 @Input() rowFlairCallback: (row: any) => GridRowFlairEntry;
63 // Returns a space-separated list of CSS class names to apply to
65 @Input() rowClassCallback: (row: any) => string;
67 // Returns a space-separated list of CSS class names to apply to
68 // a given cell or all cells in a column.
69 @Input() cellClassCallback: (row: any, col: GridColumn) => string;
71 // comma-separated list of fields to show by default.
72 // This field takes precedence over hideFields.
73 // When a value is applied, any field not in this list will
75 @Input() showFields: string;
77 // comma-separated list of fields to hide.
78 // This does not imply all other fields should be visible, only that
79 // the selected fields will be hidden.
80 @Input() hideFields: string;
82 // When true, only display columns that are declared in the markup
83 // and leave all auto-generated fields hidden.
84 @Input() showDeclaredFieldsOnly: boolean;
86 // Allow the caller to jump directly to a specific page of
88 @Input() pageOffset: number;
89 // Pass in a default page size. May be overridden by settings.
90 @Input() pageSize: number;
92 // If true and an idlClass is specificed, the grid assumes
93 // datatype=link fields that link to classes which define a selector
94 // are fleshed with the linked object. And, instead of displaying
95 // the raw field value, displays the selector value from the linked
96 // object. The caller is responsible for fleshing the appropriate
97 // fields in the GridDataSource getRows handler.
99 // This only applies to auto-generated columns.
101 // For example, idlClass="aou" and field="ou_type", the display
102 // value will be ou_type().name() since "name" is the selector
103 // field on the "aout" class.
104 @Input() showLinkSelectors: boolean;
106 @Input() disablePaging: boolean;
108 context: GridContext;
110 // These events are emitted from our grid-body component.
111 // They are defined here for ease of access to the caller.
112 @Output() onRowActivate: EventEmitter<any>;
113 @Output() onRowClick: EventEmitter<any>;
116 private idl: IdlService,
117 private org: OrgService,
118 private store: ServerStoreService,
119 private format: FormatService
122 new GridContext(this.idl, this.org, this.store, this.format);
123 this.onRowActivate = new EventEmitter<any>();
124 this.onRowClick = new EventEmitter<any>();
129 if (!this.dataSource) {
130 throw new Error('<eg-grid/> requires a [dataSource]');
133 this.context.idlClass = this.idlClass;
134 this.context.dataSource = this.dataSource;
135 this.context.persistKey = this.persistKey;
136 this.context.isSortable = this.sortable === true;
137 this.context.isMultiSortable = this.multiSortable === true;
138 this.context.useLocalSort = this.useLocalSort === true;
139 this.context.disableSelect = this.disableSelect === true;
140 this.context.showLinkSelectors = this.showLinkSelectors === true;
141 this.context.disableMultiSelect = this.disableMultiSelect === true;
142 this.context.rowFlairIsEnabled = this.rowFlairIsEnabled === true;
143 this.context.showDeclaredFieldsOnly = this.showDeclaredFieldsOnly;
144 this.context.rowFlairCallback = this.rowFlairCallback;
145 this.context.disablePaging = this.disablePaging === true;
146 if (this.showFields) {
147 this.context.defaultVisibleFields = this.showFields.split(',');
149 if (this.hideFields) {
150 this.context.defaultHiddenFields = this.hideFields.split(',');
153 if (this.pageOffset) {
154 this.context.pager.offset = this.pageOffset;
158 this.context.pager.limit = this.pageSize;
161 // TS doesn't seem to like: let foo = bar || () => '';
162 this.context.rowClassCallback =
163 this.rowClassCallback || function () { return ''; };
164 this.context.cellClassCallback =
165 this.cellClassCallback || function() { return ''; };
171 this.context.initData();
175 this.context.destroy();
179 this.context.reload();