# PageHeader

Шапка сторінки чи розділу — крихти, назва, опис, метадані, дії й вкладки в одному каркасі.


Кожен продуктовий екран починається однаково: де я (крихти або «Назад»),
що це (назва й опис), у якому воно стані (метадані) і що з ним зробити
(дії). У вихідних проєктах ця шапка написана заново на кожній сторінці — з
різними відступами, кеглями й поведінкою на мобільному.


Example (app/demos/page-header/PageHeaderBasic.vue):

```vue
<script setup lang="ts">
import { shallowRef } from 'vue'
import UiBreadcrumb from '~/components/ui/UiBreadcrumb.vue'
import UiButton from '~/components/ui/UiButton.vue'
import UiChip from '~/components/ui/UiChip.vue'
import UiPageHeader from '~/components/ui/UiPageHeader.vue'
import UiTabs from '~/components/ui/UiTabs.vue'

const tab = shallowRef('overview')
</script>

<template>
  <div class="w-full rounded-card border border-line bg-card p-5">
    <UiPageHeader
      title="ТОВ «Сігма Трейд»"
      description="Оптовий покупець кераміки. Менеджер — Олена Бондар."
      as="h2"
    >
      <template #breadcrumb>
        <UiBreadcrumb :items="[{ label: 'CRM' }, { label: 'Клієнти' }, { label: 'Сігма Трейд' }]" />
      </template>
      <template #meta>
        <UiChip tone="success" dot>Активний</UiChip>
        <span>Клієнт з березня 2024</span>
        <span>12 угод</span>
      </template>
      <template #actions>
        <UiButton variant="outline">Написати</UiButton>
        <UiButton>Нова угода</UiButton>
      </template>

      <UiTabs
        v-model="tab"
        :tabs="[
          { id: 'overview', label: 'Огляд' },
          { id: 'deals', label: 'Угоди' },
          { id: 'files', label: 'Файли' },
        ]"
      />
    </UiPageHeader>
  </div>
</template>

```


## Посилання «Назад» і аватар

`backTo` — маршрут, а не `history.back()`: сторінку часто відкривають за
прямим посиланням, і «назад» в історії вивів би з застосунку взагалі.
Текст краще конкретний — «До замовлень», а не просто «Назад».


Example (app/demos/page-header/PageHeaderBack.vue):

```vue
<script setup lang="ts">
import UiAvatar from '~/components/ui/UiAvatar.vue'
import UiButton from '~/components/ui/UiButton.vue'
import UiPageHeader from '~/components/ui/UiPageHeader.vue'
</script>

<template>
  <div class="w-full max-w-2xl rounded-card border border-line bg-card p-5">
    <UiPageHeader
      title="Олена Бондар"
      description="Менеджерка з продажу · Київ"
      as="h2"
      size="sm"
      back-to="/docs/components/page-header"
      back-label="До команди"
      divider
    >
      <template #leading>
        <UiAvatar name="Олена Бондар" :size="44" status="online" />
      </template>
      <template #actions>
        <UiButton variant="ghost" size="sm">Профіль</UiButton>
      </template>
    </UiPageHeader>
    <p class="mt-4 text-sm text-muted">Вміст сторінки починається під межею шапки.</p>
  </div>
</template>

```


## API

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

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

- Верх кожної сторінки застосунку: список, картка запису, налаштування.
- Шапка розділу всередині сторінки — з `as="h2"` і меншим `size`.

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

- Для маркетингового hero з великою типографікою — у шапки інша роль і
  інший ритм.
- Для заголовка картки. У `UiCard` є слот `header` з власними відступами.

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

Рівень заголовка (`as`) і кегль (`size`) — окремі props. Семантика й вигляд
— різні рішення: шапка розділу мусить бути `h2`, навіть якщо дизайн хоче
для неї великий кегль, інакше структура сторінки для скрінрідера ламається.

На сторінці — рівно один `h1`. Коли `UiPageHeader` стоїть усередині
картки чи панелі, передавайте `as="h2"` або `as="h3"`.

Дії переносяться під назву цілим рядком, а не стискають заголовок у
стовпчик: у шапці працює `flex-wrap` з базовою шириною назви, а не сітка з
фіксованою колонкою дій. Посилання «Назад» — рядок тексту заввишки 20px,
тож на дотику його ціль добудовує невидима зона 45px, як у `UiButton`.


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