﻿---
description: Компонент-контейнер для создания адаптивных сеток из Card.
tags: card
---

# CardGrid \[tag:component]

Компонент-контейнер для создания адаптивных сеток из [`Card`](/components/card).
Выбирает необходимую сетку в зависимости от указанного размера, обеспечивает семантически правильную разметку по умолчанию.

Связанные компоненты:

* [Card](/components/card)
* [ContentCard](/components/content-card)

```jsx
<CardGrid size="s">
  <Card mode="shadow">
    <AspectRatio ratio={100 / 92}>
      <div />
    </AspectRatio>
  </Card>
  <Card mode="shadow">
    <AspectRatio ratio={100 / 92}>
      <div />
    </AspectRatio>
  </Card>
  <Card mode="shadow">
    <AspectRatio ratio={100 / 92}>
      <div />
    </AspectRatio>
  </Card>
</CardGrid>
```

## Размер карточек

Свойство `size` задаёт нужную сетку и накладывает определённые ограничения на пропорции карточек.
Соблюдение пропорций осуществляется самостоятельно
(например, с помощью компонента [`AspectRatio`](/components/aspect-ratio), как в примере выше).

| Размер | Пропорции                      | Сетка      | Типовое применение      |
| :----: | ------------------------------ | ---------- | ----------------------- |
|   `s`  | высота 92% (≈1:1.08) от ширины | Три в ряд  | Квадратные элементы     |
|   `m`  | высота 62% (≈1:1.61) от ширины | Два в ряд  | Горизонтальные карточки |
|   `l`  | высота 30% (≈1:3.33) от ширины | Один в ряд | Широкие баннеры         |

```jsx
<CardGrid size="m">
  <Card mode="shadow">
    <AspectRatio ratio={100 / 62}>
      <div />
    </AspectRatio>
  </Card>
  <Card mode="shadow">
    <AspectRatio ratio={100 / 62}>
      <div />
    </AspectRatio>
  </Card>
</CardGrid>
<CardGrid size="l">
  <Card mode="shadow">
    <AspectRatio ratio={100 / 30}>
      <div />
    </AspectRatio>
  </Card>
</CardGrid>
```

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

* По умолчанию используется семантический тег `<ul>`.
* Для одиночных сеток вне списков меняйте тег через `Component`.
* Добавляйте `ARIA`-роли при необходимости.

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

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