react-js-pagination

A ReactJS dumb component to render a pagination.

The component comes with no built-in styles. HTML layout compatible with Bootstrap 3 pagination stylesheets.

If you would like it to work for Bootstrap 4, you will need to add 2 additional props when using this component:

itemClass="page-item"
linkClass="page-link"

Installation

Install react-js-pagination with npm:

$ npm install react-js-pagination

Usage

Very easy to use. Just provide props with total amount of things that you want to display on the page.

import React, { Component } from "react";
import ReactDOM from "react-dom";
import Pagination from "react-js-pagination";
require("bootstrap/less/bootstrap.less");

class App extends Component {
  constructor(props) {
    super(props);
    this.state = {
      activePage: 15
    };
  }

  handlePageChange(pageNumber) {
    console.log(`active page is ${pageNumber}`);
    this.setState({activePage: pageNumber});
  }

  render() {
    return (
      <div>
        <Pagination
          activePage={this.state.activePage}
          itemsCountPerPage={10}
          totalItemsCount={450}
          pageRangeDisplayed={5}
          onChange={this.handlePageChange.bind(this)}
        />
      </div>
    );
  }
}

ReactDOM.render(<App />, document.getElementById("root"));

Check Live example

Params

Name	Type	Default	Description
totalItemsCount	Number		Required. Total count of items which you are going to display
onChange	Function		Required. Page change handler. Receive pageNumber as arg
activePage	Number	1	Required. Active page
itemsCountPerPage	Number	10	Count of items per page
pageRangeDisplayed	Number	5	Range of pages in paginator, exclude navigation blocks (prev, next, first, last pages)
prevPageText	String / ReactElement	⟨	Text of prev page navigation button
firstPageText	String / ReactElement	«	Text of first page navigation button
lastPageText	String / ReactElement	»	Text of last page navigation button
nextPageText	String / ReactElement	⟩	Text of next page navigation button
getPageUrl	Function		Generate href attribute for page
innerClass	String	pagination	Class name of <ul> tag
activeClass	String	active	Class name of active <li> tag
activeLinkClass	String		Class name of active <a> tag
itemClass	String		Default class of the <li> tag
itemClassFirst	String		Class of the first <li> tag
itemClassPrev	String		Class of the previous <li> tag
itemClassNext	String		Class of the next <li> tag
itemClassLast	String		Class of the last <li> tag
disabledClass	String	disabled	Class name of the first, previous, next and last <li> tags when disabled
hideDisabled	Boolean	false	Hide navigation buttons (prev, next, first, last) if they are disabled.
hideNavigation	Boolean	false	Hide navigation buttons (prev page, next page)
hideFirstLastPages	Boolean	false	Hide first/last navigation buttons
linkClass	String		Default class of the <a> tag
linkClassFirst	String		Class of the first <a> tag
linkClassPrev	String		Class of the previous <a> tag
linkClassNext	String		Class of the next <a> tag
linkClassLast	String		Class of the last <a> tag

React 17 example

Example as a functional component with hooks and bootstrap 4

npm install bootstrap

import { useState } from "react";
import Pagination from "react-js-pagination";
import 'bootstrap/dist/css/bootstrap.css';

function App() {
  const [page, setPage] = useState({activePage: 1});

  function handlePageChange(pageNumber) {
    console.log(page);
    setPage({activePage: pageNumber});
  }

  return (
    <>     
      <Pagination
          activePage={page.activePage}
          itemsCountPerPage={1}
          totalItemsCount={5}
          pageRangeDisplayed={5}
          onChange={handlePageChange}
          itemClass="page-item"
          linkClass="page-link"
          innerClass="pagination justify-content-center"
        />
    </>
  );
}

export default App;