Pagination API

This page provides an overview of the Pagination component API, detailing its props, emits, slots, and exposed methods/states.

Props

The Pagination component accepts the following props:

PropDefaultTypeDescription
modelValue1number or undefinedThe current active page.
mode"outlined""outlined" or "filled" or "underlined" or undefinedThe visual style of the pagination component.
sizePage5number or undefinedThe number of items displayed per page.
sizesSelector[5, 15, 20, 50, 100, 150]Array<number> or undefinedAvailable options for selecting the page size.
visibleNumberPages5number or undefinedThe number of pages visible in the pagination navigation.
total0number or undefinedThe total number of items across all pages.
isInfoTextfalseboolean or undefinedDisplays informational text about the pagination state.
isPageSizeSelectorfalseboolean or undefinedEnables a selector for choosing the page size.
isHiddenNavigationButtonsfalseboolean or undefinedHides the "Previous" and "Next" navigation buttons.
class""StyleClass or undefinedCustom CSS class for the pagination container.

Emits

The Pagination component emits the following events:

EventPayloadDescription
update:modelValuenumberEmitted when the active page changes.
update:sizePagenumberEmitted when the page size is updated by the user.

Slots

The Pagination component provides the following slots:

SlotPayloadDescription
defaultVNode[]Default slot for custom content inside the pagination component.

Expose

The Pagination component exposes the following methods and states via ref:

ExposeValueDescription
selectPageSizeSelectExpose or undefinedReference to the page size selector.
sizePagenumber or undefinedThe current page size.
visibleNumberPagesnumberThe number of pages visible in the pagination control.
totalnumberThe total number of items across all pages.
isInfoTextbooleanIndicates whether informational text about pagination is enabled.
isPageSizeSelectorbooleanIndicates whether the page size selector is enabled.
isNavigationButtonsbooleanIndicates whether the navigation buttons are visible.
arraySizesSelectorArray<{ key: number; value: string }>The available sizes for the page size selector.
pagesArray<number>The array of page numbers available for navigation.
activePagenumberThe currently active page number.
modestringThe current styling mode of the pagination.
paramsSelectPartial<BaseSelectProps>Parameters for the page size selector component.
switchPage(value: number | Array<number>) => voidSwitches to a specific page or an array of pages in navigation.
switchSizePage(sizePageValue: number) => voidUpdates the page size.
© 2025 FishtVue by Egoka