@tylertech/forge 3.0.0-next.11 → 3.0.0-next.12

package/esm/paginator/paginator-adapter.d.ts

@@ -7,40 +7,42 @@ import { BaseAdapter, IBaseAdapter } from '../core/base/base-adapter';
 import { ISelectOption } from '../select';
 import { IPaginatorComponent } from './paginator';
 import { PaginatorAlternativeAlignment } from './paginator-constants';
+export type PaginatorFieldIdentifier = 'first' | 'last' | 'previous' | 'next' | 'page-size';
 export interface IPaginatorAdapter extends IBaseAdapter {
-    setLabel: (value: string) => void;
-    setPageSizeOptions: (options: ISelectOption[]) => void;
-    setPageSize: (value: number) => void;
-    setRangeLabel: (value: string) => void;
+    setLabel(value: string): void;
+    setPageSizeOptions(options: ISelectOption[]): void;
+    setPageSize(value: number): void;
+    setRangeLabel(value: string): void;
     hasFirstPageButton(): boolean;
     showFirstPageButton(): void;
     hideFirstPageButton(): void;
     hasLastPageButton(): boolean;
     showLastPageButton(): void;
     hideLastPageButton(): void;
-    attachPageSizeChangeListener: (listener: (evt: CustomEvent) => void) => void;
-    attachFirstPageListener: (listener: (evt: Event) => void) => void;
-    attachPreviousPageListener: (listener: (evt: Event) => void) => void;
-    attachNextPageListener: (listener: (evt: Event) => void) => void;
-    attachLastPageListener: (listener: (evt: Event) => void) => void;
-    detachPageSizeChangeListener: (listener: (evt: CustomEvent) => void) => void;
-    detachFirstPageListener: (listener: (evt: Event) => void) => void;
-    detachPreviousPageListener: (listener: (evt: Event) => void) => void;
-    detachNextPageListener: (listener: (evt: Event) => void) => void;
-    detachLastPageListener: (listener: (evt: Event) => void) => void;
-    disableFirstPageButton: () => void;
-    enableFirstPageButton: () => void;
-    disablePreviousPageButton: () => void;
-    enablePreviousPageButton: () => void;
-    disableNextPageButton: () => void;
-    enableNextPageButton: () => void;
+    attachPageSizeChangeListener(listener: (evt: CustomEvent) => void): void;
+    attachFirstPageListener(listener: (evt: Event) => void): void;
+    attachPreviousPageListener(listener: (evt: Event) => void): void;
+    attachNextPageListener(listener: (evt: Event) => void): void;
+    attachLastPageListener(listener: (evt: Event) => void): void;
+    detachPageSizeChangeListener(listener: (evt: CustomEvent) => void): void;
+    detachFirstPageListener(listener: (evt: Event) => void): void;
+    detachPreviousPageListener(listener: (evt: Event) => void): void;
+    detachNextPageListener(listener: (evt: Event) => void): void;
+    detachLastPageListener(listener: (evt: Event) => void): void;
+    disableFirstPageButton(): void;
+    enableFirstPageButton(): void;
+    disablePreviousPageButton(): void;
+    enablePreviousPageButton(): void;
+    disableNextPageButton(): void;
+    enableNextPageButton(): void;
     disablePageSizeSelect(): void;
     enablePageSizeSelect(): void;
     setPageSizeVisibility(visible: boolean): void;
-    disableLastPageButton: () => void;
-    enableLastPageButton: () => void;
-    setAlternative: (alternative: boolean) => void;
-    setAlignment: (alignment: PaginatorAlternativeAlignment) => void;
+    disableLastPageButton(): void;
+    enableLastPageButton(): void;
+    setAlternative(alternative: boolean): void;
+    setAlignment(alignment: PaginatorAlternativeAlignment): void;
+    handleFocusMove(from: PaginatorFieldIdentifier): void;
 }
 /**
  * Provides facilities for interacting with the internal DOM of `PaginatorComponent`.
@@ -93,4 +95,6 @@ export declare class PaginatorAdapter extends BaseAdapter<IPaginatorComponent> i
     enableLastPageButton(): void;
     setAlternative(alternative: boolean): void;
     setAlignment(alignment: PaginatorAlternativeAlignment): void;
+    handleFocusMove(from: PaginatorFieldIdentifier): void;
+    private _tryFocus;
 }

package/esm/paginator/paginator-adapter.js

@@ -146,4 +146,59 @@ export class PaginatorAdapter extends BaseAdapter {
                 break;
         }
     }
+    handleFocusMove(from) {
+        if (!this._component.matches(':focus')) {
+            return; // We can only move focus elsewhere within the element if the element already contains focus
+        }
+        switch (from) {
+            case 'first':
+                this._tryFocus([
+                    this._nextPageButton,
+                    this._lastPageButton,
+                    this._previousPageButton,
+                    this._pageSizeSelect
+                ]);
+                break;
+            case 'last':
+                this._tryFocus([
+                    this._previousPageButton,
+                    this._firstPageButton,
+                    this._nextPageButton,
+                    this._pageSizeSelect
+                ]);
+                break;
+            case 'previous':
+                this._tryFocus([
+                    this._nextPageButton,
+                    this._lastPageButton,
+                    this._firstPageButton,
+                    this._pageSizeSelect
+                ]);
+                break;
+            case 'next':
+                this._tryFocus([
+                    this._previousPageButton,
+                    this._firstPageButton,
+                    this._lastPageButton,
+                    this._pageSizeSelect
+                ]);
+                break;
+            case 'page-size':
+                this._tryFocus([
+                    this._nextPageButton,
+                    this._lastPageButton,
+                    this._firstPageButton,
+                    this._previousPageButton
+                ]);
+                break;
+        }
+    }
+    _tryFocus(elements) {
+        for (const el of elements) {
+            if (el && el.isConnected && !el.disabled) {
+                el.focus();
+                return;
+            }
+        }
+    }
 }

package/esm/paginator/paginator-foundation.d.ts

@@ -13,15 +13,12 @@ export interface IPaginatorFoundation extends ICustomElementFoundation {
     total: number;
     pageSizeOptions: number[] | boolean;
     pageSizeLabel: string;
-    initialize(): void;
 }
-/**
- * The foundation class behind the `<forge-paginator>` component.
- */
 export declare class PaginatorFoundation {
     private _adapter;
     private _pageIndex;
     private _pageSize;
+    private _offset;
     private _total;
     private _pageSizeOptions;
     private _label;
@@ -30,103 +27,59 @@ export declare class PaginatorFoundation {
     private _disabled;
     private _alternative;
     private _alignment;
+    private _rangeLabel;
     private _firstPageListener;
     private _previousPageListener;
     private _nextPageListener;
     private _lastPageListener;
     private _pageSizeListener;
-    private _rangeLabel;
     constructor(_adapter: IPaginatorAdapter);
-    /** The zero-based page index. Default is 0. */
-    set pageIndex(value: number);
-    get pageIndex(): number;
-    /** Number of items to display on a page. By default set to 25. */
-    set pageSize(value: number);
-    get pageSize(): number;
-    /** Sets page index by providing the number of items to skip. */
-    set offset(value: number);
-    get offset(): number;
-    /** The total number of items to be paginated. Default is 0. */
-    set total(value: number);
-    get total(): number;
-    /** The set of provided page size options to display to the user. */
-    set pageSizeOptions(options: number[] | boolean);
-    get pageSizeOptions(): number[] | boolean;
-    /** A label for the paginator. Default is "Rows per page:". */
-    set label(value: string);
-    get label(): string;
-    /** Whether to show the first page and last page buttons. Default is false. */
-    set firstLast(value: boolean);
-    get firstLast(): boolean;
-    /** Whether to show the first page button. Default is false. */
-    set first(value: boolean);
-    get first(): boolean;
-    /** Whether the paginator is disabled. Default is false. */
-    set disabled(value: boolean);
-    get disabled(): boolean;
-    get alternative(): boolean;
-    set alternative(value: boolean);
-    get alignment(): PaginatorAlternativeAlignment;
-    set alignment(value: PaginatorAlternativeAlignment);
-    private _applyAlternativeAlignment;
-    private _applyAlternative;
-    /**
-     * Intializes the internal state when the component loads.
-     */
     initialize(): void;
     disconnect(): void;
     private _attachListeners;
     private _detachListeners;
-    /**
-     * Handles clicking the first page button.
-     * @param evt The click event.
-     */
     private _onFirstPage;
-    /**
-     * Handles clicking the previous page button.
-     * @param evt The click event.
-     */
     private _onPreviousPage;
-    /**
-     * Handles clicking the next page button.
-     * @param evt The click event.
-     */
     private _onNextPage;
-    /**
-     * Handles clicking the last page button.
-     * @param evt The click event.
-     */
     private _onLastPage;
-    /**
-     * Handles selecting a new item in the page size options.
-     * @param evt The select custom event.
-     */
     private _onPageSizeChanged;
     private _emitChangeEvent;
-    /**
-     * Returns the max number of pages based on our current parameters.
-     */
     private _getMaxPages;
-    /**
-     * Updates our internal state as well as updating the UI.
-     */
-    private _update;
-    /**
-     * Toggle showing/hiding first and last buttons based on the show first/last buttons flag.
-     */
+    private _updateRangeLabel;
+    private _syncInteractionState;
     private _toggleFirstLastButtons;
-    /**
-     * Toggle showing/hiding first button based on the show first or first/last buttons flags.
-     */
     private _toggleFirstButton;
-    /** Checks if a first page exists. */
     private _hasFirstPage;
-    /**
-     * Checks if a previous page exists.
-     */
     private _hasPreviousPage;
-    /** Checks if a next page exists */
     private _hasNextPage;
-    /** Checks if a last page exists. */
     private _hasLastPage;
+    private _computePageIndexFromOffset;
+    private _computeOffset;
+    private _applyPageIndex;
+    private _applyPageSize;
+    private _applyTotal;
+    private _applyAlternativeAlignment;
+    private _applyDisabled;
+    get pageIndex(): number;
+    set pageIndex(value: number);
+    get pageSize(): number;
+    set pageSize(value: number);
+    get offset(): number;
+    set offset(value: number);
+    get total(): number;
+    set total(value: number);
+    get pageSizeOptions(): number[] | boolean;
+    set pageSizeOptions(options: number[] | boolean);
+    get label(): string;
+    set label(value: string);
+    get firstLast(): boolean;
+    set firstLast(value: boolean);
+    get first(): boolean;
+    set first(value: boolean);
+    get disabled(): boolean;
+    set disabled(value: boolean);
+    get alternative(): boolean;
+    set alternative(value: boolean);
+    get alignment(): PaginatorAlternativeAlignment;
+    set alignment(value: PaginatorAlternativeAlignment);
 }