feat(table): add MdTableDataSource

Author: andrewseguin

src/cdk/rxjs/rx-operators.ts

@@ -6,7 +6,10 @@
  * found in the LICENSE file at https://angular.io/license
  */
 
-import {Observable, ObservableInput} from 'rxjs/Observable';
+// Subscribable needs to be imported because combineLatest has or is using it, but it does not need
+// to be used in any of the explicit typings in this file.
+// tslint:disable-next-line:no-unused-variable
+import {Observable, ObservableInput, Subscribable} from 'rxjs/Observable';
 import {PartialObserver} from 'rxjs/Observer';
 import {Subscription} from 'rxjs/Subscription';
 import {IScheduler} from 'rxjs/Scheduler';
@@ -22,6 +25,7 @@ import {startWith as startWithOperator} from 'rxjs/operator/startWith';
 import {debounceTime as debounceTimeOperator} from 'rxjs/operator/debounceTime';
 import {auditTime as auditTimeOperator} from 'rxjs/operator/auditTime';
 import {takeUntil as takeUntilOperator} from 'rxjs/operator/takeUntil';
+import {combineLatest as combineLatestOperator} from 'rxjs/operator/combineLatest';
 
 /**
  * Represents a strongly-typed chain of RxJS operators.
@@ -71,6 +75,9 @@ export interface StrictRxChain<T> {
 
   call(operator: takeUntilOperatorType<T>, notifier: Observable<any>): StrictRxChain<T>;
 
+  call<T2>(operator: combineLatestOperatorType<T, T2>,
+      v2: ObservableInput<T2>): StrictRxChain<[T, T2]>;
+
   subscribe(fn: (t: T) => void): Subscription;
 
   result(): Observable<T>;
@@ -89,6 +96,7 @@ export class StartWithBrand { private _; }
 export class DebounceTimeBrand { private _; }
 export class AuditTimeBrand { private _; }
 export class TakeUntilBrand { private _; }
+export class CombineLatestBrand { private _; }
 /* tslint:enable:no-unused-variable */
 
 
@@ -104,8 +112,9 @@ export type startWithOperatorType<T> = typeof startWithOperator & StartWithBrand
 export type debounceTimeOperatorType<T> = typeof debounceTimeOperator & DebounceTimeBrand;
 export type auditTimeOperatorType<T> = typeof auditTimeOperator & AuditTimeBrand;
 export type takeUntilOperatorType<T> = typeof takeUntilOperator & TakeUntilBrand;
+export type combineLatestOperatorType<T, R> = typeof combineLatestOperator & CombineLatestBrand;
 
-// We add `Function` to the type intersection to make this nomically different from
+// We add `Function` to the type intersection to make this nominally different from
 // `finallyOperatorType` while still being structurally the same. Without this, TypeScript tries to
 // reduce `typeof _finallyOperator & FinallyBrand` to `finallyOperatorType<T>` and then fails
 // because `T` isn't known.
@@ -123,3 +132,5 @@ export const debounceTime =
     debounceTimeOperator as typeof debounceTimeOperator & DebounceTimeBrand & Function;
 export const auditTime = auditTimeOperator as typeof auditTimeOperator & AuditTimeBrand & Function;
 export const takeUntil = takeUntilOperator as typeof takeUntilOperator & TakeUntilBrand & Function;
+export const combineLatest =
+    combineLatestOperator as typeof combineLatestOperator & CombineLatestBrand & Function;

src/demo-app/table/table-demo.html

@@ -170,3 +170,62 @@ <h3>MdTable Example</h3>
                 [pageSizeOptions]="[5, 10, 25, 100]">
   </md-paginator>
 </div>
+
+
+<h3>MdTable With MdTableDataSource Example</h3>
+
+<md-form-field>
+  <input mdInput [formControl]="filter">
+</md-form-field>
+
+<div class="demo-table-container demo-mat-table-example mat-elevation-z4">
+
+  <table-header-demo (shiftColumns)="displayedColumns.push(displayedColumns.shift())"
+                     (toggleColorColumn)="toggleColorColumn()">
+  </table-header-demo>
+
+  <md-table [dataSource]="mdTableDataSource" [trackBy]="userTrackBy" mdSort
+            #sortForDataSource="mdSort">
+
+    <!-- Column Definition: ID -->
+    <ng-container cdkColumnDef="userId">
+      <md-header-cell *mdHeaderCellDef md-sort-header> ID </md-header-cell>
+      <md-cell *mdCellDef="let row"> {{row.id}} </md-cell>
+    </ng-container>
+
+    <!-- Column Definition: Progress -->
+    <ng-container mdColumnDef="progress">
+      <md-header-cell *mdHeaderCellDef md-sort-header> Progress </md-header-cell>
+      <md-cell *mdCellDef="let row">
+        <div class="demo-progress-stat">{{row.progress}}%</div>
+        <div class="demo-progress-indicator-container">
+          <div class="demo-progress-indicator"
+               [style.background]="row.progress > 50 ? 'green' : 'red'"
+               [style.opacity]="getOpacity(row.progress)"
+               [style.width.%]="row.progress"></div>
+        </div>
+      </md-cell>
+    </ng-container>
+
+    <!-- Column Definition: Name -->
+    <ng-container mdColumnDef="userName">
+      <md-header-cell *mdHeaderCellDef md-sort-header> Name </md-header-cell>
+      <md-cell *mdCellDef="let row"> {{row.name}} </md-cell>
+    </ng-container>
+
+    <!-- Column Definition: Color -->
+    <ng-container mdColumnDef="color">
+      <md-header-cell *mdHeaderCellDef md-sort-header>Color</md-header-cell>
+      <md-cell *mdCellDef="let row" [style.color]="row.color"> {{row.color}} </md-cell>
+    </ng-container>
+
+    <md-header-row *mdHeaderRowDef="displayedColumns"></md-header-row>
+    <md-row *mdRowDef="let row; columns: displayedColumns"></md-row>
+
+  </md-table>
+
+  <md-paginator #paginatorForDataSource
+                [length]="_peopleDatabase.data.length"
+                [pageSizeOptions]="[10, 25, 100]">
+  </md-paginator>
+</div>

src/demo-app/table/table-demo.ts

@@ -1,7 +1,8 @@
 import {Component, ViewChild} from '@angular/core';
 import {PeopleDatabase, UserData} from './people-database';
 import {PersonDataSource} from './person-data-source';
-import {MdPaginator, MdSort} from '@angular/material';
+import {MdPaginator, MdSort, MdTableDataSource} from '@angular/material';
+import {FormControl} from '@angular/forms';
 
 export type UserProperties = 'userId' | 'userName' | 'progress' | 'color' | undefined;
 
@@ -17,19 +18,43 @@ const properties = ['id', 'name', 'progress', 'color'];
 })
 export class TableDemo {
   dataSource: PersonDataSource | null;
+  mdTableDataSource = new MdTableDataSource<UserData>();
   displayedColumns: UserProperties[] = [];
   trackByStrategy: TrackByStrategy = 'reference';
   changeReferences = false;
   highlights = new Set<string>();
 
+  filter = new FormControl();
+
   dynamicColumnDefs: any[] = [];
   dynamicColumnIds: string[] = [];
 
-  @ViewChild(MdPaginator) _paginator: MdPaginator;
-
+  @ViewChild(MdPaginator) paginator: MdPaginator;
   @ViewChild(MdSort) sort: MdSort;
 
-  constructor(public _peopleDatabase: PeopleDatabase) { }
+  @ViewChild('paginatorForDataSource') paginatorForDataSource: MdPaginator;
+  @ViewChild('sortForDataSource') sortForDataSource: MdSort;
+
+  constructor(public _peopleDatabase: PeopleDatabase) {
+    this.mdTableDataSource.sortingDataAccessor = (data: UserData, property: string) => {
+      switch (property) {
+        case 'userId': return +data.id;
+        case 'userName': return data.name;
+        case 'progress': return +data.progress;
+        case 'color': return data.color;
+        default: return '';
+      }
+    };
+    this.mdTableDataSource.filterTermAccessor = (data: UserData) => data.name;
+    this.filter.valueChanges.subscribe(filter => this.mdTableDataSource!.filter = filter);
+  }
+
+  ngAfterViewInit() {
+    // Needs to be set up after the view is initialized since the data source will look at the sort
+    // and paginator's initial values to know what data should be rendered.
+    this.mdTableDataSource!.paginator = this.paginatorForDataSource;
+    this.mdTableDataSource!.sort = this.sortForDataSource;
+  }
 
   ngOnInit() {
     this.connect();
@@ -54,8 +79,9 @@ export class TableDemo {
   connect() {
     this.displayedColumns = ['userId', 'userName', 'progress', 'color'];
     this.dataSource = new PersonDataSource(this._peopleDatabase,
-        this._paginator, this.sort);
+        this.paginator, this.sort);
     this._peopleDatabase.initialize();
+    this.mdTableDataSource!.data = this._peopleDatabase.data.slice();
   }
 
   disconnect() {

src/lib/core/rxjs/rx-operators.ts

@@ -16,5 +16,5 @@
 </div>
 
 <span class="cdk-visually-hidden" *ngIf="_isSorted()">
-  {{_intl.sortDescriptionLabel(id, _sort.direction)}}
+  &nbsp;{{_intl.sortDescriptionLabel(id, _sort.direction)}}
 </span>

src/lib/sort/sort-header.html

@@ -25,6 +25,7 @@ export interface Sort {
 /** Container for MdSortables to manage the sort state and provide default sort parameters. */
 @Directive({
   selector: '[mdSort], [matSort]',
+  exportAs: 'mdSort'
 })
 export class MdSort {
   /** Collection of all registered sortables that this directive manages. */

src/lib/sort/sort.ts

@@ -10,4 +10,5 @@ export * from './table-module';
 export * from './cell';
 export * from './table';
 export * from './row';
+export * from './table-data-source';
 export * from './mat-exports';