On this page
@addTagHelper *, Webority.Ui.RazorIn a page header
Put the pager in a detail page's header, before the primary action, so the next record is one tap away.
Invoice 12 of 47
At either end
A direction at an end, or with neither a link nor a handler, is disabled, so the pager never leads nowhere.
Every option
Every value of every prop, one cell each.
index: the position, from 1
index not set: empty label, both disabledtotal: how many records
prev-href: the previous record URL
onPrev: a callback, React only
next-href: the next record URL
onNext: a callback, React only
prev-label: the previous icon's name and tooltip
next-label: the next icon's name and tooltip
keys: J and K press next and previous
class: an extra class on the wrapper (React: className)
ction>Guidance
What to do, and what to avoid.
Use it when
- A record opened from a list that people work through.
- The open item's header in a reading pane.
Reach for something else when
- Moving between pages of a list. → AppTablePagination
Reference
Try every prop, read the full list, and check keyboard and screen reader behaviour.
7 props. The 5 most used come first.
Used on most screens 5 props
| Prop | Type | Default | Description |
|---|---|---|---|
| indexdefault - | int | - | The position of this record, from 1. Without it (nothing open) the label is empty and both icons are disabled. |
| totaldefault - | int | - | How many records the list holds. |
| prev-hrefdefault - | string | - | The previous record URL. |
| next-hrefdefault - | string | - | The next record URL. |
| keysdefault false | bool | false | J and K press next and previous. |
Less common 2 props
| Prop | Type | Default | Description |
|---|---|---|---|
| prev-labeldefault Previous | string | Previous | The previous icon name and tooltip, such as Previous invoice. |
| next-labeldefault Next | string | Next | The next icon name and tooltip, such as Next invoice. |
Screen reader
2 notes- The position text is a polite live region, so a change of record is announced.
- Previous and next are labelled by prevLabel and nextLabel, which also show as their tooltips.