﻿---
description: Компонент для отображения заглушек при отсутствии контента или ошибках.
tags: loading
---

# Placeholder \[tag:component]

Компонент для отображения заглушек при отсутствии контента или ошибках.
Обеспечивает единый стиль для пустых состояний интерфейса.

```jsx
<Placeholder title="Находите друзей">
  Здесь будут отображаться люди, которых вы добавите в друзья
</Placeholder>
```

## Полноэкранный режим (stretched)

Используется когда:

* Нет других элементов на экране;
* Нужно акцентировать внимание на состоянии;
* Требуется центральное позиционирование.

## Отображение нескольких кнопок

Чтобы отобразить несколько кнопок, в свойство `action` можно прокинуть несколько кнопок обернутых в [`ButtonGroup`](/components/button-group):

```jsx
<Placeholder
  title="Находите друзей"
  action={
    <ButtonGroup mode="vertical" align="center">
      <Button size="m">Найти друзей</Button>
      <Button size="m" mode="tertiary">
        Подробнее
      </Button>
    </ButtonGroup>
  }
>
  Здесь будут отображаться люди, которых вы добавите в друзья.
</Placeholder>
```

> Используйте не более 3-х кнопок.
>
> При работе с несколькими кнопками важно учитывать иерархию их значимости, определяя, какая из них является основной,
> а какая вспомогательной.

## Рекомендации по использованию

* Используйте `outline` иконки (иконки с префиксом `Outline` в `@vkontakte/icons`).
* Используйте кнопки размера `l`.
* Режимы кнопок `primary` или `tertiary`.
* Не используйте вместе с другим контентом при `stretched=true`.
* Избегайте небольших иконок (меньше `56px`).
* Не размещайте интерактивные элементы нигде, кроме `action`.

## Подкомпонентый подход

Компонент можно использовать в подкомпонентном подходе:

```jsx
<Placeholder.Container>
  <Placeholder.Icon>
    <Icon56UserAddOutline />
  </Placeholder.Icon>
  <Placeholder.Title>Находите друзей</Placeholder.Title>
  <Placeholder.Description>
    Здесь будут отображаться люди, которых вы добавите в друзья.
  </Placeholder.Description>
  <Placeholder.Actions>
    <ButtonGroup mode="vertical" align="center">
      <Button size="m">Найти друзей</Button>
      <Button size="m" mode="tertiary">
        Скрыть
      </Button>
    </ButtonGroup>
  </Placeholder.Actions>
</Placeholder.Container>
```

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

### Placeholder

| Свойство     | Тип                   | По умолчанию | Описание                                                                                           |
| ------------ | --------------------- | ------------ | -------------------------------------------------------------------------------------------------- |
| `action`     | `ReactNode`           | `-`          | Кнопка действия.                                                                                   |
| `getRootRef` | `Ref<HTMLDivElement>` | `-`          |                                                                                                    |
| `icon`       | `ReactNode`           | `-`          | Иконка.                                                                                            |
| `noPadding`  | `boolean`             | `false`      | Убирает отступы у компонента.                                                                      |
| `ref`        | `Ref<HTMLDivElement>` | `-`          |                                                                                                    |
| `stretched`  | `boolean`             | `-`          | Растягивает плейсхолдер на весь экран, но в таком случае на экране должен быть только плейсхолдер. |
| `title`      | `ReactNode`           | `-`          | Заголовок плейсхолдера.                                                                            |

### Placeholder.Container

| Свойство     | Тип                   | По умолчанию | Описание                                                                                           |
| ------------ | --------------------- | ------------ | -------------------------------------------------------------------------------------------------- |
| `getRootRef` | `Ref<HTMLDivElement>` | `-`          |                                                                                                    |
| `noPadding`  | `boolean`             | `false`      | Убирает отступы у компонента.                                                                      |
| `ref`        | `Ref<HTMLDivElement>` | `-`          |                                                                                                    |
| `stretched`  | `boolean`             | `-`          | Растягивает плейсхолдер на весь экран, но в таком случае на экране должен быть только плейсхолдер. |

### Placeholder.Icon

| Свойство     | Тип                   | По умолчанию | Описание |
| ------------ | --------------------- | ------------ | -------- |
| `getRootRef` | `Ref<HTMLDivElement>` | `-`          |          |
| `ref`        | `Ref<HTMLDivElement>` | `-`          |          |

### Placeholder.Title

| Свойство     | Тип                                                                                             | По умолчанию | Описание                                                                                                                                                                                                                                                                               |
| ------------ | ----------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Component`  | `ElementType<any, keyof IntrinsicElements>`                                                     | `-`          |                                                                                                                                                                                                                                                                                        |
| `getRootRef` | `Ref<HTMLElement>`                                                                              | `-`          |                                                                                                                                                                                                                                                                                        |
| `ref`        | `Ref<HTMLElement>`                                                                              | `-`          |                                                                                                                                                                                                                                                                                        |
| `render`     | `((props: AllHTMLAttributes<HTMLElement> & Omit<HasRootRef<HTMLElement>, "ref">) => ReactNode)` | `-`          | Позволяет переопределить рендер компонента, получая собранные свойства (включая вычисленные `className` и `style`). Используется вместо `Component`.  Позволяет гибко объединять несколько компонентов без создания промежуточных DOM-узлов и без ремаунта поддерева на каждый рендер. |

### Placeholder.Description

| Свойство     | Тип                                                                                             | По умолчанию | Описание                                                                                                                                                                                                                                                                               |
| ------------ | ----------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Component`  | `ElementType<any, keyof IntrinsicElements>`                                                     | `-`          |                                                                                                                                                                                                                                                                                        |
| `getRootRef` | `Ref<HTMLElement>`                                                                              | `-`          |                                                                                                                                                                                                                                                                                        |
| `ref`        | `Ref<HTMLElement>`                                                                              | `-`          |                                                                                                                                                                                                                                                                                        |
| `render`     | `((props: AllHTMLAttributes<HTMLElement> & Omit<HasRootRef<HTMLElement>, "ref">) => ReactNode)` | `-`          | Позволяет переопределить рендер компонента, получая собранные свойства (включая вычисленные `className` и `style`). Используется вместо `Component`.  Позволяет гибко объединять несколько компонентов без создания промежуточных DOM-узлов и без ремаунта поддерева на каждый рендер. |

### Placeholder.Actions

| Свойство     | Тип                   | По умолчанию | Описание |
| ------------ | --------------------- | ------------ | -------- |
| `getRootRef` | `Ref<HTMLDivElement>` | `-`          |          |
| `ref`        | `Ref<HTMLDivElement>` | `-`          |          |
