﻿---
description: Компонент, представляющий собой отдельное состояние интерфейса, отображающееся в один момент времени.
keywords:
  - PanelSpinner
---

# Panel \[tag:component]

Компонент, представляющий собой отдельное состояние интерфейса, отображающееся в один момент времени.

Связанные страницы:

* [View](/components/view)
* [Навигация](/overview/navigation)

```jsx
<Panel>
  <PanelHeader>Заголовок экрана</PanelHeader>
  <Placeholder stretched>Контент экрана</Placeholder>
</Panel>
```

## Визуальное оформление

### Тип отображения

Задаётся свойством `mode`.

* `"card"` — карточный дизайн с тенями и скруглениями;
* `"plain"` — плоский дизайн без теней и скруглений.

По умолчанию переключение между типами отображения зависит от [`viewWidth`](/overview/adaptivity#viewwidth)

| `viewWidth`    | `mode`    |
| -------------- | --------- |
| `SMALL_TABLET` | `"card"`  |
| `MOBILE`       | `"plain"` |

### Центрирование контента

Задаётся свойством `centered`.

```jsx
<Panel centered>
  <PanelHeader>Заголовок экрана</PanelHeader>
  <div>Отцентрованный контент</div>
</Panel>
```

### Фон страницы

Задаётся свойством `disableBackground`.

* `true` — задаёт прозрачный цвет фона;
* `false` — стандартный цвет фона.

```jsx
<Panel disableBackground>
  <PanelHeader>Заголовок экрана</PanelHeader>
  <Placeholder stretched>За мной нет фона</Placeholder>
</Panel>
```

## PanelSpinner \[tag:component]

Индикатор загрузки внутри экрана. Автоматически добавляет стандартные отступы и центрирование.

```jsx
<Panel centered>
  <PanelHeader>PanelSpinner</PanelHeader>
  <PanelSpinner />
</Panel>
```

### Свойства

Наследует все свойства компонента [`Spinner`](/components/spinner).

* `size` — размер индикатора.
* `disableAnimation` — отключение анимации.
* `noColor` — наследование цвета.

#### Высота компонента

Задается с помощью свойства `height`:

```jsx
<PanelSpinner height={300} />
```

### Когда использовать

* При загрузке контента внутри экрана.
* Когда нужен центрированный спиннер с отступами.
* Для полностраничной загрузки (в сочетании с кастомной высотой).

### Альтернативы

* [`Spinner`](/components/spinner) — для встроенной загрузки внутри элементов.
* [`ScreenSpinner`](/components/screen-spinner) — для модальной загрузки поверх интерфейса.

### Доступность (a11y) \[#a11y]

Следует придерживаться тех же правил, что и для компонента [`Spinner`](/components/spinner).

## Свойства и методы \[#api]

### Panel

| Свойство            | Тип                   | По умолчанию | Описание                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------- | --------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `centered`          | `boolean`             | `false`      | Центрирование содержимого.                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `disableBackground` | `boolean`             | `-`          | Отключает задний фон.                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `getRootRef`        | `Ref<HTMLDivElement>` | `-`          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `layoutMode`        | `"card" \| "plain"`   | `-`          | Тип оформления панели.  Позволяет переопределить тип оформления панели, заданный через адаптивность или свойство layoutMode у [AppRoot](https://vkui.io/components/app-root), глобально задающим тип оформления макета.  Если установлен `card` - Panel имеет фон отличный от фона контента. Позволяет компоненту [Group](https://vkui.io/components/group) со свойством layoutMode='card' точечно выглядеть как карточка. Тип `plain` — соответствует фону по умолчанию. |
| `mode`              | `"card" \| "plain"`   | `-`          | **Deprecated**: Используйте `layoutMode`.                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| `nav`               | `string`              | `-`          | Уникальный идентификатор навигационного элемента (вместо id)                                                                                                                                                                                                                                                                                                                                                                                                              |
| `ref`               | `Ref<HTMLDivElement>` | `-`          |                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

### PanelSpinner

| Свойство           | Тип                         | По умолчанию | Описание                                                           |
| ------------------ | --------------------------- | ------------ | ------------------------------------------------------------------ |
| `disableAnimation` | `boolean`                   | `-`          | Отключение анимации.                                               |
| `getRootRef`       | `Ref<HTMLSpanElement>`      | `-`          |                                                                    |
| `height`           | `number`                    | `-`          | Высота компонента.                                                 |
| `noColor`          | `boolean`                   | `-`          | Задать цвет можно будет через свойство color родителя.             |
| `ref`              | `Ref<HTMLSpanElement>`      | `-`          |                                                                    |
| `size`             | `"s" \| "m" \| "l" \| "xl"` | `-`          | Размер спиннера.                                                   |
| `visibilityDelay`  | `number`                    | `-`          | Задерживает отрисовку элемента на заданное количество миллисекунд. |
