﻿---
description: Компонент для визуальной группировки связанных элементов интерфейса.
tags: list
keywords:
  - Header
  - Footer
  - Group.ExpandedContent
---

# Group \[tag:component]

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

```jsx
<Group header={<Header>Заголовок группы</Header>} separator="hide">
  <Box padding="system">
    <Text>Контент группы</Text>
  </Box>
  <Footer>Подвал группы</Footer>
</Group>
```

## Вложенные Group

`Group` можно вкладывать в другой `Group`. Чаще всего вложенным компонентам нужно задать `mode="plain"` — это даёт прозрачный фон и скрывает рамки.

```jsx
<Group separator="hide">
  <Group layoutMode="plain">
    <SimpleCell indicator="+7 ••• •• •• 96" before={<Icon28PhoneOutline />} onClick={() => {}}>
      Номер телефона
    </SimpleCell>
    <SimpleCell indicator="g•••@gmail.com" before={<Icon28MailOutline />} onClick={() => {}}>
      Email
    </SimpleCell>
  </Group>
  <Group layoutMode="plain">
    <SimpleCell
      indicator="Обновлён 3 года назад"
      before={<Icon28KeyOutline />}
      onClick={() => {}}
    >
      Пароль
    </SimpleCell>
    <SimpleCell indicator="Вкл." before={<Icon28CheckShieldDeviceOutline />} onClick={() => {}}>
      Подтверждение входа
    </SimpleCell>
    <SimpleCell indicator="2" before={<Icon28DevicesOutline />} onClick={() => {}}>
      Привязанные устройства
    </SimpleCell>
  </Group>
</Group>
```

## Header \[tag:component]

Заголовок группы. Передаётся либо в свойство `header`, либо в начале `children`, либо в `Group.Header`.

```jsx
<Header indicator={<Badge mode="prominent">12</Badge>} after={<Switch label="Уведомления" />}>Уведомления</Header>
```

### Рекомендуемые размеры иконок

| Свойство         | Расположение            | Рекомендуемый размер |
| ---------------- | ----------------------- | -------------------- |
| `before`         | Слева от всего контента | `28px`               |
| `beforeTitle`    | Слева от заголовка      | `16px`               |
| `afterTitle`     | Справа от заголовка     | `16px`               |
| `beforeSubtitle` | Слева от подзаголовка   | `12px`               |
| `afterSubtitle`  | Справа от подзаголовка  | `12px`               |

### Дополнительные элементы

* `indicator` — отображает счётчик/статус:

  ```jsx
  <Header indicator={<Badge mode="prominent">12</Badge>}>Уведомления</Header>
  ```

* `after` — контент справа от всего заголовка:

  ```jsx
  <Header after={<Switch label="Настройки" />}>Настройки</Header>
  ```

### Пример использования

```jsx
<Group
  mode="card"
  separator="hide"
  header={
    <Header
      before={<Icon28UserCircleFillBlue />}
      beforeTitle={<Icon16LockOutline />}
      afterTitle={<Icon16UnlockOutline />}
      beforeSubtitle={<Icon12Tag />}
      afterSubtitle={<Icon12Fire />}
      subtitle="SOHN — Conrad"
      subtitleComponent="h3"
      indicator={
        <Counter size="s" mode="primary" appearance="accent-red">
          3
        </Counter>
      }
      after={<Link href="#">Показать все</Link>}
    >
      Плейлисты
    </Header>
  }
>
  <Box padding="system">
    <Text>Контент</Text>
  </Box>
</Group>
```

## Group.ExpandedContent \[#group-expanded-content] \[tag:component]

Компенсирует внутренние отступы `Group`.

```jsx
<Group header={<Header>Удаляем для HorizontalScroll отступы Group по горизонтали</Header>}>
  <Group.ExpandedContent direction="inline">
    <HorizontalScroll showArrows>
      {Array.from({ length: 20 }).map((_, index) => {
        return (
          <HorizontalCell key={index} header={index}>
            <Avatar size={56} />
          </HorizontalCell>
        );
      })}
    </HorizontalScroll>
  </Group.ExpandedContent>
</Group>
```

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

Собрать `Group` самостоятельно можно с помощью следующих подкомпонентов:

* `Group.Container` – служит оберткой, отвечающей за скругления и отступы внутри группы.
  Принимает все основные свойства `Group`, кроме `header` и `description`.

* `Group.Header` – отвечает за отрисовку заголовка. Соответствует свойству `header` у `Group`. Рекомендуется использовать подкомпонент
  [`Header`](#header) в качестве содержимого.

* `Group.Description` – отвечает за отрисовку подписи в нижней части группы. Соответствует свойству `description` у `Group`.

```jsx
<Group.Container separator="hide">
  <Group.Header>
    <Header>Адреса</Header>
  </Group.Header>
  <CellButton onClick={() => {}}>Добавить домашний адрес</CellButton>
  <CellButton onClick={() => {}}>Добавить рабочий адрес</CellButton>
  <Group.Description>
    Для использования в мини-приложениях, Delivery Club, VK Taxi и других сервисах ВКонтакте. Эти
    адреса видны только Вам.
  </Group.Description>
</Group.Container>
```

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

### Group

| Свойство               | Тип                                                                                             | По умолчанию | Описание                                                                                                                                                                                                                                                                                  |
| ---------------------- | ----------------------------------------------------------------------------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Component`            | `ElementType<any, keyof IntrinsicElements>`                                                     | `-`          |                                                                                                                                                                                                                                                                                           |
| `description`          | `ReactNode`                                                                                     | `-`          | Подпись под содержимым.                                                                                                                                                                                                                                                                   |
| `getRootRef`           | `Ref<HTMLElement>`                                                                              | `-`          |                                                                                                                                                                                                                                                                                           |
| `header`               | `ReactNode`                                                                                     | `-`          | Элемент заголовка группы.                                                                                                                                                                                                                                                                 |
| `layoutMode`           | `"card" \| "plain"`                                                                             | `-`          | Режим отображения. Если установлен `card`, выглядит как карточка c обводкой и внешними отступами. Если `plain` — без отступов и обводки. По умолчанию режим отображения зависит от `viewWidth` (`card` при `SMALL_TABLET` и `plain` при `MOBILE`) В модальных окнах по умолчанию `plain`. |
| `mode`                 | `"card" \| "plain"`                                                                             | `-`          | **Deprecated**: Используйте `layoutMode`.                                                                                                                                                                                                                                                 |
| `noBlockEndRounding`   | `boolean`                                                                                       | `-`          | Отключает закругление в конце блока.                                                                                                                                                                                                                                                      |
| `noBlockStartRounding` | `boolean`                                                                                       | `-`          | Отключает закругление в начале блока.                                                                                                                                                                                                                                                     |
| `padding`              | `"s" \| "m"`                                                                                    | `-`          | Отвечает за отступы вокруг контента в режиме `card`.                                                                                                                                                                                                                                      |
| `ref`                  | `Ref<HTMLElement>`                                                                              | `-`          |                                                                                                                                                                                                                                                                                           |
| `render`               | `((props: AllHTMLAttributes<HTMLElement> & Omit<HasRootRef<HTMLElement>, "ref">) => ReactNode)` | `-`          | Позволяет переопределить рендер компонента, получая собранные свойства (включая вычисленные `className` и `style`). Используется вместо `Component`.  Позволяет гибко объединять несколько компонентов без создания промежуточных DOM-узлов и без ремаунта поддерева на каждый рендер.    |
| `separator`            | `"auto" \| "show" \| "hide"`                                                                    | `-`          | `show` (только для `layoutMode="plain"`) - разделитель всегда показывается `hide` - разделитель всегда спрятан, `auto` - разделитель рисуется автоматически между соседними группами.                                                                                                     |

### Group.Container

| Свойство            | Тип                                                                                             | По умолчанию | Описание                                                                                                                                                                                                                                                                               |
| ------------------- | ----------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `after`             | `ReactNode`                                                                                     | `-`          | Допускаются иконки, текст, Link.                                                                                                                                                                                                                                                       |
| `afterSubtitle`     | `ReactNode`                                                                                     | `-`          | Иконка справа от subtitle (рекомендуется использовать размер 12px).                                                                                                                                                                                                                    |
| `afterTitle`        | `ReactNode`                                                                                     | `-`          | Иконка справа от title (рекомендуется использовать размер 16px).                                                                                                                                                                                                                       |
| `before`            | `ReactNode`                                                                                     | `-`          | Иконка слева (рекомендуется использовать размер 28px).                                                                                                                                                                                                                                 |
| `beforeSubtitle`    | `ReactNode`                                                                                     | `-`          | Иконка слева от subtitle (рекомендуется использовать размер 12px).                                                                                                                                                                                                                     |
| `beforeTitle`       | `ReactNode`                                                                                     | `-`          | Иконка слева от title (рекомендуется использовать размер 16px).                                                                                                                                                                                                                        |
| `Component`         | `ElementType<any, keyof IntrinsicElements>`                                                     | `h2`         |                                                                                                                                                                                                                                                                                        |
| `getRootRef`        | `Ref<HTMLElement>`                                                                              | `-`          |                                                                                                                                                                                                                                                                                        |
| `indicator`         | `ReactNode`                                                                                     | `-`          | Допускаются текст, Indicator.                                                                                                                                                                                                                                                          |
| `multiline`         | `boolean`                                                                                       | `-`          | Возможность отображения текста в несколько строк.                                                                                                                                                                                                                                      |
| `ref`               | `Ref<HTMLElement>`                                                                              | `-`          |                                                                                                                                                                                                                                                                                        |
| `render`            | `((props: AllHTMLAttributes<HTMLElement> & Omit<HasRootRef<HTMLElement>, "ref">) => ReactNode)` | `-`          | Позволяет переопределить рендер компонента, получая собранные свойства (включая вычисленные `className` и `style`). Используется вместо `Component`.  Позволяет гибко объединять несколько компонентов без создания промежуточных DOM-узлов и без ремаунта поддерева на каждый рендер. |
| `size`              | `"s" \| "m" \| "l" \| "xl"`                                                                     | `m`          | Размер компонента.                                                                                                                                                                                                                                                                     |
| `subtitle`          | `ReactNode`                                                                                     | `-`          | Подпись под основным текстом.                                                                                                                                                                                                                                                          |
| `subtitleComponent` | `ElementType<any, keyof IntrinsicElements>`                                                     | `span`       | Позволяет задать тип элемента в который будет обёрнут subtitle.                                                                                                                                                                                                                        |

### Group.Header

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