Merge pull request #7393 from IgniteUI/expose-pageChange-perPageChange-emitters-m

docs(grid): Expose paging event emitters

Author: zdrawku

projects/igniteui-angular/src/lib/grids/grid-base.directive.ts

@@ -456,7 +456,16 @@ export class IgxGridBaseDirective extends DisplayDensityBase implements
     }
 
     /**
-     * @hidden @internal
+     * Emitted after the current page is changed.
+     * @example
+     * ```html
+     * <igx-grid (pageChange)="onPageChange($event)"></igx-grid>
+     * ```
+     * ```typescript
+     * public onPageChange(page: number) {
+     *   this.currentPage = page;
+     * }
+     * ```
      */
     @Output()
     public pageChange = new EventEmitter<number>();
@@ -488,7 +497,16 @@ export class IgxGridBaseDirective extends DisplayDensityBase implements
     }
 
     /**
-     * @hidden @internal
+     * Emitted when `perPage` property value of the grid is changed.
+     * @example
+     * ```html
+     * <igx-grid #grid (perPageChange)="onPerPageChange($event)" [autoGenerate]="true"></igx-grid>
+     * ```
+     * ```typescript
+     * public onPerPageChange(perPage: number) {
+     *   this.perPage = perPage;
+     * }
+     * ```
      */
     @Output()
     public perPageChange = new EventEmitter<number>();

projects/igniteui-angular/src/lib/paginator/paginator.component.ts

@@ -202,13 +202,31 @@ export class IgxPaginatorComponent extends DisplayDensityBase {
     public prepositionPage = CurrentResourceStrings.PaginatorResStrings.igx_paginator_pager_text;
 
     /**
-     * An event that is emitted when the select in the `IgxPaginatorComponent` changes its value.
+     * Emitted when `perPage` property value of the paginator is changed.
+     * @example
+     * ```html
+     * <igx-paginator (perPageChange)="onPerPageChange($event)"></igx-paginator>
+     * ```
+     * ```typescript
+     * public onPerPageChange(perPage: number) {
+     *   this.perPage = perPage;
+     * }
+     * ```
      */
     @Output()
     public perPageChange = new EventEmitter<number>();
 
     /**
-     * An event that is emitted when the paginating is used.
+     * Emitted after the current page is changed.
+     * @example
+     * ```html
+     * <igx-paginator (pageChange)="onPageChange($event)"></igx-paginator>
+     * ```
+     * ```typescript
+     * public onPageChange(page: number) {
+     *   this.currentPage = page;
+     * }
+     * ```
      */
     @Output()
     public pageChange = new EventEmitter<number>();