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

# CardScroll \[tag:component]

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

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

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

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

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

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

| Размер  | Пропорции                      | Особенности                   |
| ------- | ------------------------------ | ----------------------------- |
| `s`     | высота 66% (≈1:1.5) от ширины  | Компактные элементы           |
| `m`     | высота 42% (≈1:2.38) от ширины | Универсальный размер          |
| `l`     | высота 29% (≈1:3.45) от ширины | Широкие элементы              |
| `false` | Авто                           | Ширина определяется контентом |

## Управление видимостью стрелок

В реализации `CardScroll` используется компонент [`HorizontalScroll`](/components/horizontal-scroll).
Поэтому для управления видимостью стрелок можно использовать свойство `showArrows` компонента `HorizontalScroll`:

```jsx
<CardScroll size="m" showArrows="always">
  <Card mode="shadow">
    <AspectRatio ratio={100 / 42}>
      <div />
    </AspectRatio>
  </Card>
  <Card mode="shadow">
    <AspectRatio ratio={100 / 42}>
      <div />
    </AspectRatio>
  </Card>
  <Card mode="shadow">
    <AspectRatio ratio={100 / 42}>
      <div />
    </AspectRatio>
  </Card>
  <Card mode="shadow">
    <AspectRatio ratio={100 / 42}>
      <div />
    </AspectRatio>
  </Card>
</CardScroll>
```

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

* По умолчанию используется семантический список (`<ul>`).
* Для несписочных структур меняйте тег через свойство `CardsListComponent`.

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

| Свойство             | Тип                                                                                                   | По умолчанию | Описание                                                                                                                                                                                                                                                                               |
| -------------------- | ----------------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `CardsListComponent` | `ElementType<any, keyof IntrinsicElements>`                                                           | `ul`         | Позволяет поменять тег используемый для обертки над карточками.                                                                                                                                                                                                                        |
| `Component`          | `ElementType<any, keyof IntrinsicElements>`                                                           | `-`          |                                                                                                                                                                                                                                                                                        |
| `getRootRef`         | `Ref<HTMLDivElement>`                                                                                 | `-`          |                                                                                                                                                                                                                                                                                        |
| `nextButtonTestId`   | `string`                                                                                              | `-`          | **Deprecated**: Since 8.0.0. Вместо этого используйте `slotProps={ nextArrow: { 'data-testid': ... } }`. Передает атрибут `data-testid` для кнопки прокрутки горизонтального скролла в направлении следующего элемента.                                                                |
| `padding`            | `boolean`                                                                                             | `false`      | Добавляет отступы по краям слева и справа.                                                                                                                                                                                                                                             |
| `prevButtonTestId`   | `string`                                                                                              | `-`          | **Deprecated**: Since 8.0.0. Вместо этого используйте `slotProps={ prevArrow: { 'data-testid': ... } }`. Передает атрибут `data-testid` для кнопки прокрутки горизонтального скролла в направлении предыдущего элемента.                                                               |
| `ref`                | `Ref<HTMLDivElement>`                                                                                 | `-`          |                                                                                                                                                                                                                                                                                        |
| `render`             | `((props: AllHTMLAttributes<HTMLDivElement> & Omit<HasRootRef<HTMLDivElement>, "ref">) => ReactNode)` | `-`          | Позволяет переопределить рендер компонента, получая собранные свойства (включая вычисленные `className` и `style`). Используется вместо `Component`.  Позволяет гибко объединять несколько компонентов без создания промежуточных DOM-узлов и без ремаунта поддерева на каждый рендер. |
| `showArrows`         | `boolean \| "always"`                                                                                 | `true`       | Показывать ли стрелки.                                                                                                                                                                                                                                                                 |
| `size`               | `false \| "s" \| "m" \| "l"`                                                                          | `s`          | При `size=false` ширина `Card` будет регулироваться контентом внутри. В остальных случаях — будет явно задана в процентах.                                                                                                                                                             |
