﻿---
description: Контейнер для реализации интерфейса многоколоночной структурой.
tags: navigation
keywords:
  - SplitCol
---

# SplitLayout \[tag:component]

Контейнер для реализации интерфейса многоколоночной структурой – за реализацию колонки отвечает [`SplitCol`](#split-col).

Помимо многоколоночной структуры, за счёт [`SplitCol`](#split-col) со свойством `autoSpaced`, обеспечивает боковые отступы для
экранов на базе [`Panel`](/components/panel).

Связанные страницы и компоненты:

* [Навигация](/overview/navigation)
* [`Panel`](/components/panel)
* [`PanelHeader`](/components/panel-header)

```jsx
const { viewWidth } = useAdaptivityConditionalRender();

return (
  <SplitLayout>
    {viewWidth.tabletPlus && (
      <SplitCol className={viewWidth.tabletPlus.className}>
        <div
          style={{
            padding: 12,
            color: 'white',
            backgroundColor: 'tomato',
          }}
        >
          Фиксированная колонка слева
        </div>
      </SplitCol>
    )}
    <SplitCol>
      <div
        style={{
          padding: 12,
          color: 'white',
          backgroundColor: 'steelblue',
        }}
      >
        Колонка справа
        {viewWidth.tabletMinus && (
          <p className={viewWidth.tabletMinus.className}>
            ⚠️ колонка слева спрятана по условию адаптивности
          </p>
        )}
      </div>
    </SplitCol>
  </SplitLayout>
);
```

```jsx
const { viewWidth } = useAdaptivityConditionalRender();

return (
  <SplitLayout>
    {viewWidth.tabletPlus && (
      <SplitCol fixed width={280} maxWidth={280} className={viewWidth.tabletPlus.className}>
        <div
          style={{
            padding: 12,
            color: 'white',
            backgroundColor: 'tomato',
          }}
        >
          Фиксированная колонка слева
        </div>
      </SplitCol>
    )}
    <SplitCol>
      <div
        style={{
          padding: 12,
          color: 'white',
          backgroundColor: 'steelblue',
        }}
      >
        Колонка справа
        {viewWidth.tabletMinus && (
          <p className={viewWidth.tabletMinus.className}>
            ⚠️ колонка слева спрятана по условию адаптивности
          </p>
        )}
      </div>
    </SplitCol>
  </SplitLayout>
);
```

## Применение компонента

Компонент должен быть один на всё приложение.

Достаточно будет объявить `SplitLayout` один раз ближе к корню приложения (см. [Навигация | Предварительная настройка](/overview/navigation#initial-setup)).

## Выравнивание

За выравнивание контента по горизонтали отвечает свойство `center`.

* `true` — весь контент выравнивается по центру;
* `false` — выравнивание не применяется.

## Сквозная шапка

Для реализации сквозной шапки между колонками используется свойство `header` с передачей в него компонента [`PanelHeader`](/components/panel-header).

```jsx
const platform = usePlatform();
const hasHeader = platform !== 'vkcom';
const { viewWidth } = useAdaptivityConditionalRender();

return (
  <SplitLayout header={hasHeader && <PanelHeader delimiter="none" />}>
    {viewWidth.tabletPlus && (
      <SplitCol className={viewWidth.tabletPlus.className} fixed width={280} maxWidth={280}>
        <Panel layoutMode="card">
          {hasHeader && <PanelHeader />}
          <Group>
            <Box padding="system">Колонка слева</Box>
          </Group>
        </Panel>
      </SplitCol>
    )}
    <SplitCol maxWidth="560px" stretchedOnMobile autoSpaced>
      <Panel layoutMode="card">
        <PanelHeader>Шапка</PanelHeader>
        <Group layoutMode="card">
          <Box padding="system">Колонка справа</Box>
        </Group>
      </Panel>
    </SplitCol>
  </SplitLayout>
);
```

Для платформы vkcom шапку передавать не нужно. Для определения платформы используйте хук [`usePlatform`](/components/platform-provider#use-platform).

```jsx showLineNumbers filename="src/App.tsx"
import { SplitLayout, SplitCol, usePlatform } from '@vkontakte/vkui';

export default function App() {
  const platform = usePlatform();
  const hasHeader = platform !== 'vkcom';

  return (
    <SplitLayout header={hasHeader && <PanelHeader delimiter="none" />}>
      {/* остальной контент */}
    </SplitLayout>
  );
}
```

## Кастомизация

Через свойство `slotProps` можно прокинуть свойства во внутренние элементы.
Это удобно для добавления кастомных классов, data-атрибутов, aria-атрибутов, обработчиков событий, доступов к элементам через `getRootRef` и других расширений, не влияя на внешний API компонента.

```jsx
const { viewWidth } = useAdaptivityConditionalRender();
const contentRef = React.useRef();

return (
  <SplitLayout
    className="my-root-class"
    data-testid="split-layout-root"
    slotProps={{
      content: {
         className: 'my-content-class',
        'data-testid': 'split-layout-content',
        getRootRef: contentRef,
      },
    }}
  >
    {viewWidth.tabletPlus && (
      <SplitCol fixed width={280} maxWidth={280} className={viewWidth.tabletPlus.className}>
        <div
          style={{
            padding: 12,
            color: 'white',
            backgroundColor: 'tomato',
          }}
        >
          Фиксированная колонка слева
        </div>
      </SplitCol>
    )}
    <SplitCol>
      <div
        style={{
          padding: 12,
          color: 'white',
          backgroundColor: 'steelblue',
        }}
      >
        Колонка справа
        {viewWidth.tabletMinus && (
          <p className={viewWidth.tabletMinus.className}>
            ⚠️ колонка слева спрятана по условию адаптивности
          </p>
        )}
      </div>
    </SplitCol>
  </SplitLayout>
);
```

## SplitCol \[#split-col] \[tag:component]

Подкомпонент для отрисовки колонки в многоколоночном интерфейсе.

### Позиционирование

Свойство `fixed` даёт возможность задать стиль `position: fixed` для колонки.
Обычно используется для боковых колонок, не позволяя им прокручиваться с основным контентом и всегда оставаться в области видимости.

* `true` — стиль применяется;
* `false` — стиль не применяется.

### Размеры

С помощью свойств `width`, `minWidth` и `maxWidth` можно управлять шириной колонки. Принимаются либо числовое (в пикселях), либо
строковое (токены или другие единицы измерения) значения.

```jsx
<SplitCol width="100%" maxWidth={560}>
  {/* контент */}
</SplitCol>
```

Свойство `stretchedOnMobile` позволит колонке растягиваться на всю доступную ширину на устройствах шириной меньше `tablet`.

### Отступы

Свойство `autoSpaced` добавляет фиксированные боковые отступы колонке на устройствах с шириной больше `smallTablet`.

### Анимации \[#animation]

Через свойство `animate` можно управлять включением/отключением анимаций при переходах во [`View`](/components/view). По умолчанию
анимации при переходах включены только для мобильных устройств.

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

### SplitLayout

| Свойство         | Тип                                                                                                                                                                                           | По умолчанию | Описание                                                                                                                                                                                                                                                                   |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `center`         | `boolean`                                                                                                                                                                                     | `-`          | Центрирует контент.                                                                                                                                                                                                                                                        |
| `getRef`         | `Ref<HTMLDivElement>`                                                                                                                                                                         | `-`          | **Deprecated**: Since 7.9.0. Будет удалено в **VKUI v9**. Вместо этого используйте `slotProps={ content: { getRootRef: ... } }`.                                                                                                                                           |
| `getRootRef`     | `Ref<HTMLDivElement>`                                                                                                                                                                         | `-`          |                                                                                                                                                                                                                                                                            |
| `header`         | `ReactNode`                                                                                                                                                                                   | `-`          | Компонент для отрисовки заголовка.                                                                                                                                                                                                                                         |
| `modal`          | `ReactNode`                                                                                                                                                                                   | `-`          | **Deprecated**: Since 7.0.0. Будет удалено в **VKUI v9**. Начиная с **VKUI v7**  `ModalRoot` можно располагать в любом месте приложения в пределах `AppRoot`.                                                                                                              |
| `popout`         | `ReactNode`                                                                                                                                                                                   | `-`          | **Deprecated**: Since 7.0.0. Будет удалено в **VKUI v9**. Начиная с **VKUI v7** компоненты можно располагать в любом месте приложения в пределах `AppRoot`.                                                                                                                |
| `ref`            | `Ref<HTMLDivElement>`                                                                                                                                                                         | `-`          |                                                                                                                                                                                                                                                                            |
| `reverseColumns` | `boolean`                                                                                                                                                                                     | `-`          | Визуально меняет порядок колонок на обратный.  Используется для доступности: позволяет разместить в DOM первой колонку, важную для скринридеров, но визуально отрисовать её последней. DOM-порядок при этом не меняется, поэтому порядок чтения скринридерами сохраняется. |
| `slotProps`      | `{ root?: (HTMLAttributes<HTMLDivElement> & HasRootRef<HTMLDivElement> & HasDataAttribute); content?: (HTMLAttributes<...> & ... 1 more ... & HasDataAttribute) \| undefined; } \| undefined` | `-`          | Свойства, которые можно прокинуть внутрь компонента: - `root`: свойства для прокидывания в корень компонента; - `content`: свойства для прокидывания в контент;.                                                                                                           |

### SplitCol

| Свойство            | Тип                   | По умолчанию | Описание                                                                                              |
| ------------------- | --------------------- | ------------ | ----------------------------------------------------------------------------------------------------- |
| `animate`           | `boolean`             | `-`          | Если false, то переходы между Panel происходят без анимации.                                          |
| `autoSpaced`        | `boolean`             | `-`          | Если true, то добавляются боковые отступы фиксированной величины при ширине больше чем `smallTablet`. |
| `fixed`             | `boolean`             | `-`          | Фиксированное положение колонки.                                                                      |
| `getRootRef`        | `Ref<HTMLDivElement>` | `-`          |                                                                                                       |
| `maxWidth`          | `string \| number`    | `-`          | Максимальная ширина колонки.                                                                          |
| `minWidth`          | `string \| number`    | `-`          | Минимальная ширина колонки.                                                                           |
| `ref`               | `Ref<HTMLDivElement>` | `-`          |                                                                                                       |
| `stretchedOnMobile` | `boolean`             | `-`          | Если true, то ширина контейнера становится 100% при ширине меньше чем `tablet`.                       |
| `width`             | `string \| number`    | `-`          | Ширина колонки.                                                                                       |
