# Pagination

Пагінація з діапазоном записів, розміром сторінки та мобільним виглядом «X з Y».


Зведено з кількох реалізацій TablePagination — діапазон «1–20 з 437», вибір розміру
сторінки, усічений ряд номерів із «…». На мобільному ряд номерів ховається
— лишається «X з Y» і стрілки, бо влучити пальцем у «14» з восьми
квадратиків по 32px нереально.

## Приклад


Example (app/demos/pagination/PaginationBasic.vue):

```vue
<script setup lang="ts">
import { ref } from 'vue'
import UiPagination from '~/components/ui/UiPagination.vue'

const page = ref(3)
const pageSize = ref(20)
const totalPages = ref(22)
const totalItems = ref(437)
</script>

<template>
  <div class="flex flex-col gap-4">
    <UiPagination
      v-model:page="page"
      v-model:page-size="pageSize"
      :total-pages="totalPages"
      :total-items="totalItems"
      :page-size-options="[10, 20, 50]"
    />
    <p class="text-xs text-muted">
      Сторінка {{ page }} із {{ totalPages }}, розмір {{ pageSize }}.
    </p>
  </div>
</template>
```


## API

[Props, events, slots, exposed API (JSON)](https://ui.tatet.net/api/component-meta/UiPagination)

## Коли використовувати

Для серверної пагінації таблиць і списків. Разом з UiTable: активуйте
`rowClickable` у таблиці й керуйте сторінкою ззовні.

## Коли НЕ використовувати

Для стрічок, що підтягуються нескінченно (feed), — там пагінація ламає
скрол; потрібен «Показати ще».

Не показуйте компонент для однієї сторінки: він сам не рендериться, коли
`totalPages ≤ 1` і немає `pageSizeOptions`.

## Доступність

Контейнер — `<nav aria-label="Пагінація">`, активна сторінка —
`aria-current="page"`. Стрілки мають `aria-label`, бо іконки без тексту
для скрінрідера безіменні. Числові колонки вирівняні `tabular-nums`.

Кнопка сторінки ключується самою сторінкою, а не позицією в ряду. Ряд
змінює довжину (від 4 до 7 пунктів), і з індексом у ключі Vue
перестворював саме натиснуту кнопку: фокус падав на `<body>`, і наступний
Tab починав з шапки сайту.

Номери сторінок, як і стрілки, мають невидиму зону дотику 45×45: з `md` на
планшеті вони лише 30px. Вимкнена пагінація блякне цілком і не реагує на
наведення — раніше номери лишались «живими», тьмяніли тільки стрілки.

Селект розміру сторінки на мобільному — рівно 16px, а не `text-base`: за
кореня 15px `text-base` дає 15px, і iOS Safari зумував сторінку при фокусі.

## Event descriptions

- `update:page`: Новий номер сторінки. Використовуйте через `v-model:page`.
- `update:pageSize`: Новий розмір сторінки. Використовуйте через `v-model:page-size`.


[Source files, dependencies and ZIP](https://ui.tatet.net/registry/components/pagination.json)
