Skip to content

Pagination

QTablePagination is a standalone footer for page-based APIs. It emits page and page-size changes; the application fetches the corresponding data.

Default pagination

Pagination with a custom footer

Inputs and behavior

Prop/modelDefaultDescription
v-model:pagerequiredOne-based current page.
v-model:items-per-pagerequiredCurrent page size.
total-items0Total available rows. Hides the summary when zero.
page-sizes[1, 2, 10, 25, 50, 100]Selectable page sizes.
summarylocalizedReplaces only the Showing {start}–{end} of {total} template.
textsExplicit text overrides, ahead of i18n and English defaults.
shortcutstrueEnables keyboard page navigation.
uiClasses for the root, left, and right footer regions.

Changing the page size emits update:items-per-page and clamps the current page to the new page count. The default pagination control provides first, previous, next, and last navigation; keyboard shortcuts mirror these actions:

  • Shift + / moves one page.
  • Shift + Ctrl + / moves to the first or last page.

Slots

SlotSlot propsUse it to replace
leftpage, itemsPerPage, totalItems, start, endThe result summary region.
page-sizeitemsPerPage, setItemsPerPageThe page-size selector.
paginationpage, pageCount, first, previous, next, lastThe page navigation control.
rightpage, pageCountA trailing footer region.

Released under the MIT License.