Версия источника: f50fde03c6615c45530b5ab681a9b585c0c454d7
Синхронизировано: 2026-11-17T23:57:59.493Z
Источник: https://github.com/sergey-from-riders/vibecoding-base/tree/f50fde03c6615c45530b5ab681a9b585c0c454d7

<a id="interface-banner-carousel"></a>

# Баннеры и карусели

## Коротко

Несколько баннеров можно перелистывать свайпом с плавным переходом. Индикатор показывает текущий баннер и общее количество. Нажатие на содержимое всего баннера выполняет одно понятное действие; стрелки и индикаторы переключают слайды отдельно и не открывают ссылку.

## Плохо

```text
Подборка из пяти баннеров, виден второй.
Индикатор: отсутствует, неизвестно, есть ли продолжение.
Клик по изображению → ничего; по маленькой надписи → каталог.
Свайп → резкая смена картинки и случайный переход в каталог.
Стрелка «Далее» → переключение и переход одновременно.
С клавиатуры доступны ссылки всех скрытых слайдов.
```

## Хорошо

```text
Подборка из пяти баннеров, виден второй.
Индикатор: «2 / 5»; после текущего осталось три баннера.
Клик по изображению, заголовку или фону баннера → каталог.
Свайп влево → плавный переход к третьему, без открытия ссылки.
«Назад» / «Далее» и выбор индикатора → только смена баннера.
Клавиатура: текущая ссылка и кнопки; скрытые слайды недоступны.
```

## Почему

Без индикатора посетитель не понимает объём подборки. Маленькая кликабельная надпись внутри большого баннера затрудняет переход. Если обработчик не различает клик и свайп, просмотр превращается в случайную навигацию. Анимация помогает увидеть направление перелистывания, но не должна мешать людям, которые ограничили движение в настройках устройства.

## Когда применять

Для блока из нескольких рекламных, информационных или навигационных баннеров. Один баннер остается статичным: стрелки, свайп и индикатор «1 / 1» не нужны. Пустой блок не выводится. Информационный баннер без действия не получает фиктивную ссылку; правило кликабельности действует, когда у баннера есть целевое действие.

Полная кликабельность, видимый счетчик и плавное перелистывание — требования этого справочника к такому компоненту. WCAG 2.2 и WAI-ARIA APG обосновывают доступное управление, а не обязательное наличие карусели на каждом сайте. APG описывает образец реализации, а не отдельный сертификат соответствия.

### Одно действие и отдельное управление

- Вся содержательная область баннера — изображение, текст и фон — ведет к одной цели. Для перехода используйте обычную ссылку с `href`, сохраняющую Enter, контекстное меню и открытие новой вкладки. Для локального действия, например открытия формы, используйте кнопку с понятным названием.
- Стрелки, выбор слайда и пауза располагаются отдельно от основной ссылки или кнопки, даже если визуально находятся поверх баннера. Не вкладывайте кнопки и другие ссылки внутрь `<a>`; обработчик родительского контейнера не должен перехватывать их клики.
- Надпись «Подробнее» может выглядеть как кнопка внутри единой ссылки, но не создает второе действие или дублирующий элемент управления. Если нужны несколько разных действий, это уже составная карточка: примените отдельный контракт, без обещания «весь баннер — одна ссылка».

### Перелистывание и индикатор

- Поддерживайте горизонтальный свайп на сенсорном экране. После завершенного свайпа, перетаскивания или отмены жеста переход по ссылке не происходит. Обычное нажатие без перелистывания сохраняет действие; не запускайте его на `pointerdown`.
- Сохраняйте вертикальную прокрутку страницы и масштабирование браузера. Для собственного горизонтального обработчика Pointer Events допустимо `touch-action: pan-y pinch-zoom` на области жеста, с обработкой `pointercancel`. Это пример для такого обработчика, а не универсальная настройка любой библиотеки или нативного scroll-контейнера.
- Переключение сопровождается коротким плавным сдвигом в направлении жеста; отмененный жест возвращает текущий баннер. При `prefers-reduced-motion: reduce` убирайте пространственное перемещение, сохраняя переключение и индикатор. Длительность выбирается в проекте и проверяется на целевых устройствах.
- Показывайте позицию и общее количество: например, «2 / 5», подписанные точки или сегменты с различимым активным состоянием. Из индикатора должно быть понятно, сколько слайдов ещё впереди. Для большой подборки используйте счетчик, а не десятки мелких точек. Если точки нажимаются, у каждой есть доступное название, например «Показать баннер 3 из 5».
- Добавляйте видимые кнопки «Назад» и «Далее»: свайп не является единственным способом переключения. На концах конечного списка соответствующая кнопка недоступна. Циклический переход допустим, если он согласован в проекте и не искажает счетчик; не выдавайте повторы за новые баннеры.

### Доступность и загрузка

- Дайте блоку понятное название, кнопкам — доступные имена и видимый фокус. Скрытые слайды исключаются из фокуса и доступного дерева, а не просто уезжают за край. При переключении кнопкой фокус остается на ней; при необходимости изменение позиции сообщается скринридеру без чтения всего баннера заново.
- По умолчанию автопрокрутка выключена. Если она нужна, добавьте доступную паузу; останавливайте смену при наведении и попадании фокуса внутрь. После фокуса она возобновляется только явным действием пользователя. При ограничении движения не запускайте её автоматически. Частота смены не должна лишать человека времени прочитать предложение.
- Резервируйте размеры баннера до загрузки изображения, сохраняйте текст и ссылку при ошибке файла. Не скачивайте сразу оригиналы всех скрытых слайдов; подбирайте размеры под отображение и загружайте следующие по мере необходимости. Без JavaScript остается рабочая ссылка хотя бы первого баннера или обычный список предложений.

## Пример применения

На главной странице размещены пять вымышленных сезонных подборок. Второй баннер целиком открывает свою категорию. Счетчик «2 / 5» и две стрелки находятся в отдельном слое управления. Свайп меняет подборку с анимацией, но не открывает категорию. Вертикальное движение пальцем продолжает прокрутку страницы.

## Как проверить

- Проверьте 0, 1, 2 и много баннеров: лишние элементы управления не появляются, счетчик и границы списка совпадают с данными.
- Нажмите на изображение, заголовок, фон и оформление «Подробнее»: каждое нажатие дает ровно одно одинаковое действие. Проверьте Enter и открытие ссылки в новой вкладке.
- Выполните длинный, короткий, отмененный и быстрый повторный свайпы; нажмите стрелки и индикаторы. Перелистывание не открывает ссылку и не вызывает двойное действие. Отдельно проверьте вертикальную прокрутку и pinch-to-zoom.
- Пройдите блок через Tab и Shift+Tab, проверьте скринридером названия и текущую позицию. Ссылки скрытых слайдов не получают фокус. Для индикатора на tabs дополнительно проверьте клавиши по выбранному APG-паттерну; не смешивайте его с обычными кнопками.
- Включите ограничение движения. При наличии автопрокрутки проверьте паузу, наведение, фокус и явное возобновление. Отключите загрузку изображения и JavaScript, проверьте резервное действие.
- Зафиксируйте результат на ширине 320–390 px и на компьютере, включая поворот устройства. Это критерии приемки компонента; публикация правила не означает, что конкретный сайт их уже прошёл.

## Человек

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

## Агент

Разделяет навигацию и управление, реализует жесты, индикатор, анимацию и альтернативу без движения. Проверяет отмену жестов, фокус, загрузку и отсутствие случайных переходов; перечисляет фактически проверенные устройства.

## Источники

- [WAI-ARIA APG: Carousel Pattern — управление, фокус и автопрокрутка](https://www.w3.org/WAI/ARIA/apg/patterns/carousel/)
- [WHATWG HTML: a — ссылка вокруг блока и запрет вложенных интерактивных элементов](https://html.spec.whatwg.org/multipage/text-level-semantics.html#the-a-element)
- [W3C, WCAG 2.2: Dragging Movements — альтернатива перетаскиванию](https://www.w3.org/WAI/WCAG22/Understanding/dragging-movements.html)
- [W3C, WCAG 2.2: Pointer Cancellation — отмена действия указателя](https://www.w3.org/WAI/WCAG22/Understanding/pointer-cancellation.html)
- [MDN: touch-action — прокрутка, масштабирование и Pointer Events](https://developer.mozilla.org/en-US/docs/Web/CSS/touch-action)
- [MDN: prefers-reduced-motion — настройка уменьшения движения](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@media/prefers-reduced-motion)

Уровень: Обязательно. Опубликовано: 2026-11-17. Проверено: 2026-11-17. Изменено: 2026-11-18.

[Исходный файл](https://github.com/sergey-from-riders/vibecoding-base/blob/f50fde03c6615c45530b5ab681a9b585c0c454d7/registry/standards/ui/admin-interface/rules/banner-carousel.md)
