@progress/kendo-angular-pager 4.0.6 → 4.1.0-dev.202211230837

package/main.d.ts

@@ -15,5 +15,6 @@ export { PagerNumericButtonsComponent } from './pager/pager-numeric-buttons.comp
 export { PagerNextButtonsComponent } from './pager/pager-next-buttons.component';
 export { PagerInputComponent } from './pager/pager-input.component';
 export { PagerInfoComponent } from './pager/pager-info.component';
+export { PagerFocusableDirective } from './pager/focusable.directive';
 export { PagerComponent } from './pager/pager.component';
 export { PagerModule } from './pager/pager.module';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-pager",
-  "version": "4.0.6",
+  "version": "4.1.0-dev.202211230837",
   "description": "Kendo UI Angular Pager",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",

package/pager/focusable.directive.d.ts

@@ -0,0 +1,23 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2021 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { ElementRef, OnDestroy, OnInit, Renderer2 } from '@angular/core';
+import { PagerNavigationService } from './navigation.service';
+import * as i0 from "@angular/core";
+/**
+ * Place the directive on custom focusable elements in the [`kendoDataPagerTemplate`]({% slug api_pager_pagertemplatedirective %}) to include them in the built-in Pager keyboard navigation.
+ */
+export declare class PagerFocusableDirective implements OnInit, OnDestroy {
+    private navigationService;
+    private element;
+    private renderer;
+    private subscriptions;
+    constructor(navigationService: PagerNavigationService, element: ElementRef, renderer: Renderer2);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    private get nativeElement();
+    private innerNavigationChange;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PagerFocusableDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<PagerFocusableDirective, "[kendoPagerFocusable]", ["kendoPagerFocusable"], {}, {}, never>;
+}

package/pager/localization/messages.d.ts

@@ -48,6 +48,10 @@ export declare class Messages extends ComponentMessages {
      * The text of the title and aria-label attributes applied to the page chooser.
      */
     selectPage: string;
+    /**
+     * The text of the aria-label attribute applied to the input element for entering the page number."
+     */
+    inputLabel: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<Messages, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<Messages, "kendoPagerMessages", never, { "firstPage": "firstPage"; "lastPage": "lastPage"; "previousPage": "previousPage"; "nextPage": "nextPage"; "page": "page"; "pageNumberInputTitle": "pageNumberInputTitle"; "itemsPerPage": "itemsPerPage"; "of": "of"; "items": "items"; "selectPage": "selectPage"; }, {}, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<Messages, "kendoPagerMessages", never, { "firstPage": "firstPage"; "lastPage": "lastPage"; "previousPage": "previousPage"; "nextPage": "nextPage"; "page": "page"; "pageNumberInputTitle": "pageNumberInputTitle"; "itemsPerPage": "itemsPerPage"; "of": "of"; "items": "items"; "selectPage": "selectPage"; "inputLabel": "inputLabel"; }, {}, never>;
 }

package/pager/navigation.service.d.ts

@@ -0,0 +1,15 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2021 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { Subject } from "rxjs";
+/**
+ * @hidden
+ */
+export declare class PagerNavigationService {
+    isNavigable: boolean;
+    innerNavigationChange: Subject<boolean>;
+    toggleInnerNavigation(value: boolean): void;
+    keepFocusWithinComponent(wrapper: HTMLElement, target: HTMLElement, event: KeyboardEvent): void;
+    getFirstAndLastFocusable(wrapper: HTMLElement): Array<HTMLElement>;
+}

package/pager/pager-input.component.d.ts

@@ -3,7 +3,7 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 import { NumericTextBoxComponent } from '@progress/kendo-angular-inputs';
-import { ChangeDetectorRef, NgZone } from '@angular/core';
+import { ChangeDetectorRef, NgZone, Renderer2 } from '@angular/core';
 import { PagerElementComponent } from './pager-element.component';
 import { LocalizationService } from "@progress/kendo-angular-l10n";
 import { PagerContextService, PagerContextChanges } from "./pager-context.service";
@@ -14,8 +14,9 @@ import * as i0 from "@angular/core";
 export declare class PagerInputComponent extends PagerElementComponent {
     protected pagerContext: PagerContextService;
     private zone;
+    private renderer;
     numericInput: NumericTextBoxComponent;
-    constructor(localization: LocalizationService, pagerContext: PagerContextService, zone: NgZone, cd: ChangeDetectorRef);
+    constructor(localization: LocalizationService, pagerContext: PagerContextService, zone: NgZone, cd: ChangeDetectorRef, renderer: Renderer2);
     /**
      * @hidden
      *
@@ -40,6 +41,7 @@ export declare class PagerInputComponent extends PagerElementComponent {
      * @hidden
      */
     get hasPages(): boolean;
+    ngAfterViewInit(): void;
     protected onChanges({ total, skip, pageSize }: PagerContextChanges): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PagerInputComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<PagerInputComponent, "kendo-datapager-input", never, {}, {}, never, never>;

package/pager/pager.component.d.ts

@@ -2,7 +2,7 @@
 * Copyright © 2021 Progress Software Corporation. All rights reserved.
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
-import { EventEmitter, OnChanges, SimpleChanges, OnInit, OnDestroy, ElementRef } from '@angular/core';
+import { EventEmitter, OnChanges, SimpleChanges, OnInit, OnDestroy, ElementRef, Renderer2, NgZone } from '@angular/core';
 import { PageChangeEvent } from './change-event-args.interface';
 import { PagerTemplateDirective } from "./pager-template.directive";
 import { ResizeSensorComponent } from "@progress/kendo-angular-common";
@@ -11,11 +11,15 @@ import { PageSizeChangeEvent } from './pagesizechange-event';
 import { PageSizeItem } from './pagesize-item.interface';
 import { PagerType } from './common/pager-type';
 import { LocalizationService } from '@progress/kendo-angular-l10n';
+import { PagerNavigationService } from './navigation.service';
 import * as i0 from "@angular/core";
 export declare class PagerComponent implements OnChanges, OnInit, OnDestroy {
     private pagerContext;
     private element;
     private localization;
+    private renderer;
+    private ngZone;
+    private navigationService;
     resizeSensor: ResizeSensorComponent;
     template: PagerTemplateDirective;
     /**
@@ -53,6 +57,13 @@ export declare class PagerComponent implements OnChanges, OnInit, OnDestroy {
      * Toggles the **Previous** and **Next** buttons.
      */
     previousNext: boolean;
+    /**
+     * If set to `true`, the user can use dedicated shortcuts to interact with the Pager ([see example]({% slug keyboard_navigation_pager %})).
+     * By default, navigation is disabled and the Pager content is accessible in the normal tab sequence.
+     * @default false
+     */
+    set navigable(value: boolean);
+    get navigable(): boolean;
     /**
      * Fires when the current page of the Pager is changed ([see example]({% slug overview_pager %}#toc-basic-usage)).
      * You have to handle the event yourself and page the data.
@@ -66,7 +77,14 @@ export declare class PagerComponent implements OnChanges, OnInit, OnDestroy {
     pageSizeChange: EventEmitter<PageSizeChangeEvent>;
     pagerClass: boolean;
     widgetRole: string;
+    roleDescription: string;
+    keyShortcuts: string;
+    hostTabindex: string;
     get dir(): string;
+    /**
+     * @hidden
+     */
+    focusHandler(ev: any): void;
     get totalPages(): number;
     get currentPage(): number;
     get pageSizeValues(): boolean | Array<number | PageSizeItem>;
@@ -75,7 +93,9 @@ export declare class PagerComponent implements OnChanges, OnInit, OnDestroy {
     private _templateContext;
     private _pageSizeValues;
     private direction;
-    constructor(pagerContext: PagerContextService, element: ElementRef, localization: LocalizationService);
+    private isInnerNavigationEnabled;
+    private _navigable;
+    constructor(pagerContext: PagerContextService, element: ElementRef, localization: LocalizationService, renderer: Renderer2, ngZone: NgZone, navigationService: PagerNavigationService);
     ngOnInit(): void;
     ngAfterViewInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
@@ -93,6 +113,10 @@ export declare class PagerComponent implements OnChanges, OnInit, OnDestroy {
      */
     onPageSizeChange(event: PageSizeChangeEvent): void;
     private resizeHandler;
+    private textFor;
+    private get ariaLabel();
+    private keyDownHandler;
+    private innerNavigationChange;
     static ɵfac: i0.ɵɵFactoryDeclaration<PagerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PagerComponent, "kendo-datapager", ["kendoDataPager"], { "total": "total"; "skip": "skip"; "pageSize": "pageSize"; "buttonCount": "buttonCount"; "info": "info"; "type": "type"; "pageSizeValues": "pageSizeValues"; "previousNext": "previousNext"; }, { "pageChange": "pageChange"; "pageSizeChange": "pageSizeChange"; }, ["template"], never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PagerComponent, "kendo-datapager", ["kendoDataPager"], { "total": "total"; "skip": "skip"; "pageSize": "pageSize"; "buttonCount": "buttonCount"; "info": "info"; "type": "type"; "pageSizeValues": "pageSizeValues"; "previousNext": "previousNext"; "navigable": "navigable"; }, { "pageChange": "pageChange"; "pageSizeChange": "pageSizeChange"; }, ["template"], never>;
 }

package/pager/pager.module.d.ts

@@ -13,16 +13,17 @@ import * as i7 from "./pager-page-sizes.component";
 import * as i8 from "./pager-template.directive";
 import * as i9 from "./localization/localized-messages.directive";
 import * as i10 from "./localization/custom-messages.component";
-import * as i11 from "@angular/common";
-import * as i12 from "@progress/kendo-angular-inputs";
-import * as i13 from "@progress/kendo-angular-dropdowns";
-import * as i14 from "@progress/kendo-angular-common";
+import * as i11 from "./focusable.directive";
+import * as i12 from "@angular/common";
+import * as i13 from "@progress/kendo-angular-inputs";
+import * as i14 from "@progress/kendo-angular-dropdowns";
+import * as i15 from "@progress/kendo-angular-common";
 /**
  * @hidden
  */
 export declare class PagerModule {
     static exports(): any[];
     static ɵfac: i0.ɵɵFactoryDeclaration<PagerModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<PagerModule, [typeof i1.PagerComponent, typeof i2.PagerPrevButtonsComponent, typeof i3.PagerNextButtonsComponent, typeof i4.PagerNumericButtonsComponent, typeof i5.PagerInputComponent, typeof i6.PagerInfoComponent, typeof i7.PagerPageSizesComponent, typeof i8.PagerTemplateDirective, typeof i9.LocalizedMessagesDirective, typeof i10.CustomMessagesComponent], [typeof i11.CommonModule, typeof i12.NumericTextBoxModule, typeof i13.DropDownListModule, typeof i14.EventsModule, typeof i14.ResizeSensorModule], [typeof i1.PagerComponent, typeof i2.PagerPrevButtonsComponent, typeof i3.PagerNextButtonsComponent, typeof i4.PagerNumericButtonsComponent, typeof i5.PagerInputComponent, typeof i6.PagerInfoComponent, typeof i7.PagerPageSizesComponent, typeof i8.PagerTemplateDirective, typeof i9.LocalizedMessagesDirective, typeof i10.CustomMessagesComponent]>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<PagerModule, [typeof i1.PagerComponent, typeof i2.PagerPrevButtonsComponent, typeof i3.PagerNextButtonsComponent, typeof i4.PagerNumericButtonsComponent, typeof i5.PagerInputComponent, typeof i6.PagerInfoComponent, typeof i7.PagerPageSizesComponent, typeof i8.PagerTemplateDirective, typeof i9.LocalizedMessagesDirective, typeof i10.CustomMessagesComponent, typeof i11.PagerFocusableDirective], [typeof i12.CommonModule, typeof i13.NumericTextBoxModule, typeof i14.DropDownListModule, typeof i15.EventsModule, typeof i15.ResizeSensorModule], [typeof i1.PagerComponent, typeof i2.PagerPrevButtonsComponent, typeof i3.PagerNextButtonsComponent, typeof i4.PagerNumericButtonsComponent, typeof i5.PagerInputComponent, typeof i6.PagerInfoComponent, typeof i7.PagerPageSizesComponent, typeof i8.PagerTemplateDirective, typeof i9.LocalizedMessagesDirective, typeof i10.CustomMessagesComponent, typeof i11.PagerFocusableDirective]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<PagerModule>;
 }

package/util.d.ts

@@ -6,3 +6,11 @@
  * @hidden
  */
 export declare const DEFAULT_PAGE_SIZE_VALUES: Array<number>;
+/**
+ * @hidden
+ */
+export declare const getAllFocusableChildren: (parent: any) => Array<any>;
+/**
+ * @hidden
+ */
+export declare const focusableSelector: string;