Pagination

Navigation
stable

Page navigation control with first, previous, next and last buttons.

API

Props

Toutes les props acceptées par ce composant, avec leur type, valeur par défaut et description.

start
number
1
Starting page number (1-based by default).
modelValue
number
1
Current page number (v-model).
disabled
boolean
false
Disables all navigation buttons.
length
number | string
1
Total number of pages.
totalVisible
number | string
Maximum number of page buttons visible at once (excess replaced with ellipsis).
firstIcon
TIcon
'mdi-page-first'
Icon for the "first page" button.
prevIcon
TIcon
'mdi-chevron-left'
Icon for the "previous page" button.
nextIcon
TIcon
'mdi-chevron-right'
Icon for the "next page" button.
lastIcon
TIcon
'mdi-page-last'
Icon for the "last page" button.
ariaLabel
string
'Pagination Navigation'
aria-label for the navigation element.
pageAriaLabel
string
currentPageAriaLabel
string
firstAriaLabel
string
previousAriaLabel
string
nextAriaLabel
string
lastAriaLabel
string
ellipsis
string
'…'
Character or string shown in place of hidden page buttons.
showFirstLastPage
boolean
false
Show buttons to jump to the first and last page.
compact
boolean
false
Compact mode replaces the page list with an editable page number input.
pageText
string
ofText
string
withInfo
boolean
false
Renders a left-side "Showing X-Y of Z" range label. Requires total prop.
total
number | string
Total number of items (not pages). Drives the withInfo label.
perPage
number | string
10
Items per page used for the withInfo range calculation.
infoText
string
previousText
string
nextText
string
pageNumberAriaLabel
string
id
string
class
string | Array<string> | object
style
string | Array<string> | object | StyleValue
tag
string
'div'
Root HTML element tag.
color
TColor
Intent color applied to the active page button.
bgColor
TColor
border
boolean | number | string | TDirectionBoth | Array<TDirectionBoth>
borderTop
boolean | number | string
borderLeft
boolean | number | string
borderBottom
boolean | number | string
borderRight
boolean | number | string
borderBlock
boolean | number | string
borderInline
boolean | number | string
borderInlineStart
boolean | number | string
borderInlineEnd
boolean | number | string
borderBlockStart
boolean | number | string
borderBlockEnd
boolean | number | string
borderColor
string
borderStyle
string
borderTopColor
TColor
borderRightColor
TColor
borderBottomColor
TColor
borderLeftColor
TColor
borderInlineStartColor
TColor
borderInlineEndColor
TColor
borderBlockStartColor
TColor
borderBlockEndColor
TColor
padding
boolean | number | string
paddingTop
boolean | number | string
paddingLeft
boolean | number | string
paddingBottom
boolean | number | string
paddingRight
boolean | number | string
paddingBlock
boolean | number | string
paddingInline
boolean | number | string
paddingInlineStart
boolean | number | string
paddingInlineEnd
boolean | number | string
paddingBlockStart
boolean | number | string
paddingBlockEnd
boolean | number | string
margin
boolean | number | string
marginTop
boolean | number | string
marginLeft
boolean | number | string
marginBottom
boolean | number | string
marginRight
boolean | number | string
marginBlock
boolean | number | string
marginInline
boolean | number | string
marginInlineStart
boolean | number | string
marginInlineEnd
boolean | number | string
marginBlockStart
boolean | number | string
marginBlockEnd
boolean | number | string
elevation
TElevation
size
TSize | number
'default'
Size of pagination buttons.
density
TDensity
'default'
Padding density of the pagination buttons.
fontSize
TFontSize
fontWeight
TFontWeight

API

Slots

Emplacements de contenu exposés par ce composant.

#info
#first
#prev
#next
#last
#item
Custom render for each page button. Receives page number, active state and key.

API

Emits

Événements émis par ce composant.

@first
number
Fired when the user navigates to the first page.
@prev
number
Fired when the user navigates to the previous page.
@next
number
Fired when the user navigates to the next page.
@last
number
Fired when the user navigates to the last page.
@update:modelValue
any
Fired when the current page changes.

Interactif

Playground

Modifiez les props en direct et observez le composant se mettre à jour. Le snippet de code généré suit vos changements.

Rendu de l’aperçu en cours…

Usage

Exemples

Extraits de code prêts à coller dans vos templates.

Basic pagination

vue

With item count info

vue

Compact mode

vue