React Table Server Side Pagination Made Simple

In modern web development, handling large datasets efficiently is a constant challenge. For developers working with React, implementing server-side pagination is an effective way to manage large tables without overwhelming the client.

In this blog , we will explore React Table server-side pagination, its significance, and how to implement it with ease.

What is a React Table?

React Table is a powerful library designed to display and manipulate data in tabular form. It comes with built-in features like sorting, filtering, and pagination. While client-side pagination works well for small datasets, when dealing with large datasets, server-side pagination is often a more efficient approach.

React Table server-side pagination enables you to fetch only the data that is required for each page, reducing the load on the browser and improving performance. In this post, we will show you how to implement server-side pagination using React Table and also explore pagination logic and best practices.

Client Side vs Server Side Pagination

Before jumping into the implementation, it's crucial to understand the difference between client-side pagination and server-side pagination.

• Client-side pagination loads all the data at once and then splits it into pages in the browser. While it's simple to implement, this can become inefficient when handling large datasets.
• Server-side pagination, on the other hand, only fetches a portion of the data from the server for each page. This results in better performance and reduced memory usage.

For large datasets, server-side pagination is the preferred approach because it offloads the task of sorting and filtering to the server.

Implementing React Table with Server Side Pagination

Let’s go through the implementation step by step. Below is a basic example of how to use React Table with server-side pagination.

Step 1: Setting Up the Project

You will need to install React Table and a backend API that supports server-side pagination. Here's how to install React Table:

Copy
npm install react-table

In this case, we will use a React Query example to fetch data from a backend API.

Copy
npm install react-query

Step 2: Fetch Data Using React Query

Let's start by fetching the data from the server. Here's a basic setup to fetch data for server-side pagination using React Query:

Copy
import React, { useEffect } from "react";
import { useQuery } from "react-query";
import { useTable, usePagination } from "react-table";

const fetchData = async (pageIndex, pageSize) => {
  const response = await fetch(`/api/data?page=${pageIndex}&pageSize=${pageSize}`);
  return response.json();
};

const Table = () => {
  const { pageIndex, pageSize } = useTable({
    manualPagination: true, // manual pagination logic
    pageCount: -1 // unknown number of pages until data is fetched
  });

  const { data, isLoading } = useQuery(
    ["data", pageIndex, pageSize],
    () => fetchData(pageIndex, pageSize),
    {
      keepPreviousData: true, // Keep previous data while fetching new data
    }
  );

  // Table pagination UI
  const { getTableProps, getTableBodyProps, headerGroups, rows, prepareRow, state: { pageIndex } } = useTable({
    data: data?.rows || [],
    columns,
    manualPagination: true,
    pageCount: data?.totalPages || 0
  });

  return (
    <div>
      <table {...getTableProps()}>
        <thead>
          {headerGroups.map(headerGroup => (
            <tr {...headerGroup.getHeaderGroupProps()}>
              {headerGroup.headers.map(column => (
                <th {...column.getHeaderProps()}>{column.render("Header")}</th>
              ))}
            </tr>
          ))}
        </thead>
        <tbody {...getTableBodyProps()}>
          {rows.map(row => {
            prepareRow(row);
            return (
              <tr {...row.getRowProps()}>
                {row.cells.map(cell => {
                  return <td {...cell.getCellProps()}>{cell.render("Cell")}</td>;
                })}
              </tr>
            );
          })}
        </tbody>
      </table>
      {/* Pagination controls */}
      <div>
        <button
          onClick={() => pageIndex > 0 && gotoPage(pageIndex - 1)}
          disabled={pageIndex === 0}
        >
          Previous
        </button>
        <button
          onClick={() => pageIndex < data?.totalPages - 1 && gotoPage(pageIndex + 1)}
          disabled={pageIndex === data?.totalPages - 1}
        >
          Next
        </button>
      </div>
    </div>
  );
};

Explanation of the Code:

• We are using manual pagination by setting manualPagination: true in the table options. This ensures that React Table doesn’t handle the pagination internally.
• The data is fetched using React Query and we pass the page index and page size as query parameters.
• The pagination state is controlled manually and updated with each page change.

Step 3: Backend Implementation

On the server side, you need to handle pagination as well. Here’s a basic example of how the backend can handle server-side pagination:

Step 4: Handling Pagination Controls

The pagination controls enable users to navigate between pages. By listening to page index changes, we can fetch the corresponding data from the backend.

The above code allows users to navigate through pages by changing the page index.

Customizing Pagination

One of the significant advantages of React Table is its flexibility. You can customize the pagination controls and the pagination behavior to suit your project’s needs. You can implement your table pagination UI and customize pagination based on the pagination state.

Handling Sub Rows and Expanded Rows

React Table allows you to create expanded rows or sub-rows. If you need to display more data on the same page without fetching additional data from the server, you can use the parent row to hold extra information.

Final Thoughts!

Implementing React Table server-side pagination is an excellent solution for managing large datasets. It ensures optimal performance by fetching only the data needed for each page. By combining React Query for data fetching and React Table for handling pagination, sorting, and filtering, you can create an efficient and highly customizable table component.

By understanding the server-side pagination logic and applying it properly, you can significantly improve the user experience and performance of your React applications.

If you want to take control of pagination and create your pagination UI, React Table gives you all the tools necessary. Start implementing server-side pagination today and make your tables more efficient!

<button onClick={() => gotoPage(pageIndex - 1)} disabled={pageIndex === 0}>
  Previous
</button>
<button onClick={() => gotoPage(pageIndex + 1)} disabled={pageIndex === totalPages - 1}>
  Next
</button>