Blocks / Pager

Pager

Where the page sits, 51–100 of 120, and Previous and Next.

import { Pager } from "@forgeron/ui";
/01 → Default
import { Pager } from "@forgeron/ui";
import { useState } from "react";

const total = 120;
const pageSize = 50;

export default function Default() {
  const [page, setPage] = useState(2);
  const count = Math.min(pageSize, total - (page - 1) * pageSize);
  return (
    <div style={{ width: 360 }}>
      <Pager
        page={page}
        pageSize={pageSize}
        count={count}
        total={total}
        hasMore={page * pageSize < total}
        onPage={setPage}
      />
    </div>
  );
}
/02 → Under a grid
idintegerPrimaryreferencetextUniquestatustext
1order-4100paid
2order-4101sent
3order-4102draft
4order-4103paid
5order-4104sent
import { DataGrid, Pager } from "@forgeron/ui";
import { useState } from "react";

const all = Array.from({ length: 23 }, (_, i) => [
  i + 1,
  `order-${String(4100 + i)}`,
  ["paid", "sent", "draft"][i % 3]!,
]);
const pageSize = 5;

export default function UnderAGrid() {
  const [page, setPage] = useState(1);
  const rows = all.slice((page - 1) * pageSize, page * pageSize);
  return (
    <div style={{ display: "grid", gap: 12, width: "100%", maxWidth: 520 }}>
      <DataGrid
        label="orders"
        columns={[
          { name: "id", type: "integer", chips: [{ kind: "primary" }], numeric: true },
          { name: "reference", type: "text", chips: [{ kind: "unique" }] },
          { name: "status", type: "text" },
        ]}
        rows={rows}
      />
      <Pager
        page={page}
        pageSize={pageSize}
        count={rows.length}
        total={all.length}
        hasMore={page * pageSize < all.length}
        onPage={setPage}
      />
    </div>
  );
}
/03 → Unknown total
import { Pager } from "@forgeron/ui";

// The server does not count past a limit: no total, and a way to narrow instead.
export default function UnknownTotal() {
  return (
    <div style={{ width: "100%", maxWidth: 520 }}>
      <Pager
        page={20}
        pageSize={50}
        count={50}
        hasMore={false}
        onPage={() => {}}
        limitNote="Paging stops at 1,000 rows: add a filter to see more."
      />
    </div>
  );
}
API → Props
PropTypeDefaultDescription
pagenumber—1-based.
pageSizenumber—Rows per page.
countnumber—Rows on this page.
totalnumber—Every row that matches, when known.
hasMoreboolean—Whether Next leads somewhere.
onPage(page) => void—Previous or Next.
limitNoteReactNode—When paging stops short, a way to narrow instead.
classNamestring—Extra classes.