angular-paginator

Angular Paginator

Pagination for Angular Applications. Paginator uses Bootstrap-4 template

Getting Started

Installation

Install via Package managers such as npm or yarn

npm install angular-paginator --save
# or
yarn add angular-paginator

Usage

Import angular-paginator module

import { AngularPaginatorModule } from 'angular-paginator';

@NgModule({
  imports: [ AngularPaginatorModule ]
})

Import bootstrap-4 into your application

Then in HTML

<div *ngFor="let item of array | angularPaginator: { currentPage: currentPage }; let i = index">
    {{(currentPage - 1) * itemsPerPage + i +1}}. {{item}}
</div>

<app-angular-paginator (pageChange)="currentPage = $event"></app-angular-paginator>

Paginator Pipe

angularPaginator pipe accepts

{
  id: 'ANGULAR_PAGINATOR_DEFAULT',
  itemsPerPage: 10,
  currentPage: currentPage
}

Paginator Component

Paginator component accepts

<app-angular-paginator [boundaryLinks]="false" 
                       [directionLinks]="true"
                       maxSize="5"
                       [rotate]="true"
                       [boundaryLinkNumbers]="false"
                       [forceEllipses]="false"
                       size="sm"
                       id="ANGULAR_PAGINATOR_DEFAULT" 
                       firstText="First" 
                       previousText="Previous"
                       nextText="Next"
                       lastText="Last" 
                       screenReaderFirstText="First"
                       screenReaderPreviousText="Previous"
                       screenReaderNextText="Next"
                       screenReaderLastText="Last"
                       screenReaderPageText="Page"
                       screenReaderCurrentPageText="You`re on page"
                       screenReaderPaginationLabel="Pagination"
                       className="ANGULAR_PAGINATOR_DEFAULT"
                       [autoHide]="false"
                       (pageChange)="currentPage = $event">
</app-angular-paginator>

• id: Use unique id when multiple paginations are being used on the same page
• boundaryLinks: Whether to display First / Last buttons
• directionLinks: Whether to display Previous / Next buttons
• maxSize: Limit number for pagination size
• rotate: Whether to keep the current page in the middle of the visible ones
• boundaryLinkNumbers: Whether to always display the first and last page numbers. If max-size is smaller than the number of pages, then the first and last page numbers are still shown with ellipses in-between as necessary. NOTE: max-size refers to the center of the range. This option may add up to 2 more numbers on each side of the displayed range for the end value and what would be an ellipsis but is replaced by a number because it is sequential
• forceEllipses: Also displays ellipses when rotate is true and maxSize is smaller than the number of pages
• size: Sets the size of pagination when bootstrap 4 is being used. Can accept only two values either sm or lg. Check Bootstrap 4 docs for more details.
• className: Adds custom class to the pagination element
• firstText: Text for First button
• previousText: Text for Previous button
• nextText: Text for Next button
• lastText: Text for Last button
• autoHide: Hides the pagination component if items length is less than itemsPerPage

Documentation

Check wiki for more information

Changelog

v1.0.2 (2017-12-01)

Performance Improvements

• implement changeDetectionStrategy for better performance (b41a9242)

Bug Fixes

• currentPage not set on page load (b41a9242)