﻿---
description:
  Адаптивность VKUI позволяет в зависимости от ширины и высоты экрана, а также на основе типа ввода
  автоматически адаптировать внешний вид компонентов.
---

# Адаптивность

В зависимости от ширины и высоты экрана и наличия точного указателя (мышь, стилус) компоненты VKUI автоматически адаптируют внешний вид одним из двух способов:

1. Меняют размеры на **компактные** или **базовые** (далее — `compact` и `regular`).
2. Изменяют вёрстку и поведение.

В этой документации вы узнаете:

* какие бывают параметры адаптивности;
* как переопределить адаптивность глобально и локально;
* как создавать собственные адаптивные интерфейсы.

## Параметры адаптивности \[#adaptivity-props]

Библиотека использует несколько подходов.

| Подход                                      | Реализация в коде          |
| ------------------------------------------- | -------------------------- |
| ↓ [Изменение размеров интерфейса](#density) | `density`                  |
| ↓ [Изменение вёрстки](#breakpoints)         | `viewWidth` и `viewHeight` |
| ↓ [Изменение поведения](#pointer)           | `hasPointer`               |

### Размеры элементов интерфейса \[#density]

> До `v8.0.0` было два отдельных свойства `sizeX` и `sizeY` (см. [документацию `v7.11.0`](/7.11.0/overview/adaptivity#sizes)).
> `sizeX` работал как псевдоним для `ViewWidth.MOBILE` и `ViewWidth.SMALL_TABLET` и скорее путал разработчиков, поэтому от него отказались в пользу одного свойства.

Чтобы интерфейс был удобен и на десктопе, и на мобильных, у большинства компонентов два режима размера: `compact` и `regular`.

* `compact` — включается при **большом экране** и **точном указателе** (например, мышь). Используются меньшие размеры, чтобы на экране помещалось больше элементов — их не нужно прятать за меню.
* `regular` — включается при **ограниченной области экрана** и **отсутствии точного указателя** (сенсорный экран). Элементы крупнее, чтобы по ним удобно было попадать пальцем.

За это отвечает свойство `density`, которое принимает `compact` или `regular`.

Если значение не задано, оно зависит от [@media](https://developer.mozilla.org/en-US/docs/Web/CSS/@media) в CSS и [matchMedia()](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia) в JS — от ширины, высоты экрана и наличия точного указателя.

| Значение  | Условие                                                                                                              |
| --------- | -------------------------------------------------------------------------------------------------------------------- |
| `compact` | `высота < 415px`,или`мышь / стилус` и `ширина >= 768px`                                                              |
| `regular` | `высота >= 415px` и `сенсорный экран`,или`высота >= 415px` и `нет указателя`,или`высота >= 415px` и `ширина < 768px` |

### Размеры экрана \[#breakpoints]

От размера экрана может полностью меняться вёрстка компонента, чтобы сохранить привычный пользователю интерфейс. Например, [`ModalPage`](/components/modal-page) на мобильном — выезжающая снизу панель, а на десктопе — диалоговое окно по центру.

Размер экрана описывают два свойства с брейкпоинтами: `viewWidth` и `viewHeight`. В CSS они реализованы через [@media](https://developer.mozilla.org/en-US/docs/Web/CSS/@media), в JS — через [matchMedia()](https://developer.mozilla.org/en-US/docs/Web/API/Window/matchMedia).

Сейчас библиотека не позволяет переопределять брейкпоинты.

#### `viewWidth`

| Брейкпоинт    | Условие            |
| ------------- | ------------------ |
| DESKTOP       | `ширина >= 1280px` |
| TABLET        | `ширина >= 1024px` |
| SMALL\_TABLET | `ширина >= 768px`  |
| MOBILE        | `ширина >= 320px`  |
| SMALL\_MOBILE | `ширина < 320px`   |

#### `viewHeight`

| Брейкпоинт   | Условие           |
| ------------ | ----------------- |
| MEDIUM       | `высота >= 720px` |
| SMALL        | `высота >= 415px` |
| EXTRA\_SMALL | `высота < 415px`  |

### Наличие точного указателя \[#pointer]

Помимо вёрстки по размеру экрана, важно сохранить привычное взаимодействие с интерфейсом.

Возьмём элемент, который появляется при наведении. С мышью или стилусом это оправданно, на сенсорном экране — антипаттерн. Поэтому [Avatar.Overlay](/components/avatar#наложение) при точном указателе показывается по наведению, без него — всегда.

Наличие точного указателя определяет свойство `hasPointer`.

#### `hasPointer`

В CSS — через [@media (pointer: fine)](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/pointer#fine), в JS — через `hasMouse` из [@vkontakte/vkjs](https://www.npmjs.com/package/@vkontakte/vkjs).

## Переопределение адаптивности \[#override]

Если нужно зафиксировать конкретные размеры, вёрстку или поведение, используйте провайдер [`AdaptivityProvider`](/components/adaptivity-provider).

* см. [AdaptivityProvider | Глобальное переопределение](/components/adaptivity-provider#override-global)
* см. [AdaptivityProvider | Локальное переопределение](/components/adaptivity-provider#override-local)

## Утилиты для создания адаптивных интерфейсов \[#utils]

Утилиты в порядке приоритета использования:

1. Хук [`useAdaptivityConditionalRender`](/components/use-adaptivity-conditional-render) — показать или скрыть элемент по брейкпоинту.
2. Компонент [`AdaptiveIconRenderer`](/components/adaptive-icon-renderer) — заменить иконку на другой размер по условию `compact` или `regular`.
3. Хук [`useAdaptivityWithJSMediaQueries`](/components/use-adaptivity-with-js-media-queries) — показать или скрыть элемент во **всплывающих окнах** (см. [Серверный рендер | Примечание к адаптивности](/overview/ssr#adaptivity-note)).

Подробнее — в отдельных документациях по каждой утилите.
