1.1.0 • Published 3 years ago

pagix v1.1.0

Weekly downloads
20
License
MIT
Repository
github
Last release
3 years ago

A generic, framework agnostic, pagination calculator

Highlights

  • :electric_plug: Framework agnostic
  • :trophy: Dependency free
  • :fire: Higly flexible

Demo

Install

yarn add pagix

Basic Usage

import { pagix } from 'pagix'

const paginate = pagix({ records: 100 })

The pagix function returns an object with some calculated props:

  • total: total number of pages
  • current: current page number, constrained between 1 and total
  • start: an array of page numbers, the first fixed page numbers
  • middle: an array of page numbers, calculated from current page
  • end: an array of page numbers, the last fixed page numbers
  • prev: the previous page number between start and middle, false if there is no truncated pages between start and middle
  • next: the next page number between middle and end, false if there is no truncated pages between middle and end
  • from: initial record in current page
  • to: last record in current page

pagination explain

API

pagix({ records , limit, current, delta, fixed }): Main method to calculate pagination

PropRequiredDefaultDescription
recordstrue-total of records to paginate
limitfalse10total of records to show per page
currenttrue1current page
deltatrue1total of pages to show in each side of current page
fixedtrue1total of pages to show before prev button and after next button

🤝 Contributing

Contributions, issues and feature requests are welcome!Feel free to check issues page.

Show your support

Give a ⭐️ if this project helped you!