1. Plugins
  2. addPagination



addPagination paginates the table by page index.


Subscribe to TableViewModel#pageRows instead of TableViewModel#rows.

  const {
  } = table.createViewModel(columns);

    {#each $pageRows as row (row.id)}


Options passed into addPagination.

const table = createTable(data, {
  page: addPagination({ ... }),

initialPageIndex?: number

Sets the initial page index.

Defaults to 0.

initialPageSize?: number

Sets the initial page size.

Defaults to 10.

serverSide?: boolean

If true, the pagination plugin will have no effect on the rows of the table. Instead, you can control pagination by updating $data. The plugin's state can be used as variables in your data-fetching query to get paginated data from the server directly.

Defaults to false.

serverItemCount: Writable<number>

The total number of items expected from the server.

When using server-side pagination, the number of items in $data only reflects the number of items in the page and not the number of total items. To calculate the right number of pages required, the plugin needs to know how many items in total are expected.

Required when serverSide = true.

Column Options

Options passed into column definitions.

const columns = table.createColumns([
    header: 'Name',
    accessor: 'name',
    plugins: {
      page: { ... },

Nothing here so far.

Prop Set

Extensions to the view model.

Subscribe to .props() on the respective table components.

{#each $headerRows as headerRow (headerRow.id)}
  <Subscribe rowProps={headerRow.props()} let:rowProps>
    {rowProps.page} <!-- HeaderRow props -->
    {#each headerRow.cells as cell (cell.id)}
      <Subscribe props={cell.props()} let:props>
        {props.page} <!-- HeaderCell props -->

Nothing here so far.

Plugin State

State provided by addPagination.

const { headerRows, pageRows, pluginStates } = table.createViewModel(columns);
const { ... } = pluginStates.page;

pageSize: Writable<number>

The current number of rows per page. If a value less than 1 is set, a minimum value of 1 is enforced.

pageIndex: Writable<number>

The current page index.

hasPreviousPage: Readable<boolean>

Whether a previous page is available.

hasNextPage: Readable<boolean>

Whether a next page is available.

pageCount: Readable<number>

The total number of pages derived from the number of rows and page size.


Simple pagination