# ScrollArea

Нативна scroll-область із edge affordance, подіями меж і програмним API.


## Приклад


Example (app/demos/scroll-area/ScrollAreaBasic.vue):

```vue
<script setup lang="ts">
const events = Array.from({ length: 12 }, (_, index) => ({
  title: `Подія ${index + 1}`,
  time: `${String(9 + Math.floor(index / 2)).padStart(2, '0')}:${index % 2 ? '30' : '00'}`,
}))
</script>

<template>
  <UiScrollArea height="16rem" aria-label="Стрічка подій" class="max-w-md border border-line bg-card">
    <ul class="divide-y divide-line">
      <li v-for="event in events" :key="event.title" class="flex items-center justify-between gap-4 px-4 py-3">
        <span class="text-sm text-ink">{{ event.title }}</span>
        <time class="text-xs text-muted">{{ event.time }}</time>
      </li>
    </ul>
  </UiScrollArea>
</template>

```


## API

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

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

Коли частині інтерфейсу потрібна власна вертикальна чи горизонтальна
прокрутка — sidebar, журнал подій, довга панель або таблиця. Компонент додає
лише affordance й події, не замінюючи механізм браузера.

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

Не огортайте ним всю сторінку й не створюйте вкладені scroll-контейнери без
необхідності. Для тисяч однотипних рядків використовуйте `UiVirtualList`.

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

Viewport лишається нативним overflow-контейнером, фокусується клавіатурою і
має іменовану `region`. PageUp, PageDown, Home, End, wheel і touch працюють
без кастомного перехоплення.


## Event descriptions

- `scroll`: Нативна подія прокрутки.
- `reachStart`: Прокрутка вперше досягла початку.
- `reachEnd`: Прокрутка вперше досягла кінця.


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