StellarUI

<stellar-pagination>

Numbered page navigation with compact mode and link rendering.

Properties

Preview

Markup

Copy
<stellar-pagination
  total="12"
  current="4"
>
</stellar-pagination>

API

Complete props, events, slots, and implementation notes for the shipped pagination control.

Props

PropTypeDefaultNotes
appearancenormal | filled | unstylednormal
currentnumber1
disabledbooleanfalse
ellipsisbooleanfalse
formatcompact | standardstandard
labelstringPagination
link-formatterstring''
siblingsnumber1
totalnumber1
without-endsbooleanfalse
without-navbooleanfalse

Events

EventSourceNotes
before-page-changestellar-paginationCancelable event emitted before a button-driven page change. The event detail includes currentPage and requestedPage.
page-changestellar-paginationEmitted after the current page changes from button interaction.
input / changestellar-paginationEmitted with button-driven page changes so docs and app state can round-trip the mutable current prop.

Slots

SlotNotes
previous-iconOptional icon override for the previous button.
next-iconOptional icon override for the next button.

Notes

  • `stellar-pagination` owns the page-range logic and compact vs standard presentation without requiring authored child items.
  • `multiple`-style dataset state stays outside this component. The only mutable control surface here is the current page via `current`.
  • When `link-formatter` is present the control renders links instead of local buttons, so page navigation becomes app-routed instead of component-owned.
  • The standard format always shows the sibling window around the current page. `ellipsis` only controls whether hidden gaps render as `...`, and `without-ends` removes the first/last page buttons.