Версия источника: d69b9006cd250b109de4a44a5f811da1244f4387
Синхронизировано: 2026-11-19T02:42:04.913Z
Источник: https://github.com/sergey-from-riders/vibecoding-base/tree/d69b9006cd250b109de4a44a5f811da1244f4387

<a id="interface-cart-confirmation"></a>

# Подтверждение добавления в корзину

## Коротко

После успешного добавления товара кнопкой «Купить» или «В корзину» откройте окно с подтверждением и двумя действиями: «Продолжить покупки» и «Перейти в корзину». Успех показывается после подтверждения операции, а не сразу после нажатия.

## Плохо

```text
Нажатие «Купить» → сразу «Товар добавлен».
Сервер отказал: нужного варианта нет.
Окно закрывается, но корзина пуста.
Повторный клик создает лишнее количество.
«Продолжить» сбрасывает фильтры каталога.
```

## Хорошо

```text
«Купить» → ожидание подтверждения.
Сервер принял вариант и количество.
Окно: «Товар добавлен в корзину».
[Продолжить покупки] [Перейти в корзину]
Закрытие сохраняет фильтры и прокрутку.
Ошибка → причина и безопасный способ повтора.
```

## Почему

Подтверждение снимает неопределенность: покупатель видит результат и выбирает следующий шаг. Ложный успех, потерянный выбор варианта и случайное удвоение количества разрушают этот сценарий. Добавление в корзину само по себе не означает оформленный или оплаченный заказ.

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

Для интернет-магазина, где действие «Купить» означает добавление в корзину. Диалог с двумя действиями — выбранный UX-контракт справочника, а не универсальное требование WCAG или всех платформ электронной торговли.

«Купить сейчас», оформление в один шаг, подписка и реальная оплата — другие операции с отдельными названиями и подтверждениями. Если товар требует выбора размера, даты или комплектации, сначала получите этот выбор. Для серверной корзины источником результата служит её серверное состояние; если проект использует локальную корзину, сначала подтвердите сохранение в принятом хранилище и явно определите последующую сверку цены и доступности.

### Требования

- До команды проверьте обязательные параметры товара и доступное пользователю количество. Сервер повторно проверяет вариант, ограничения и актуальные условия; клиентская проверка не заменяет серверную.
- Во время отправки показывайте состояние ожидания и предотвращайте случайную повторную отправку той же операции. Одно отключение кнопки не защищает от повторного запроса по сети: при риске двойного эффекта требуется серверный контракт идемпотентности либо иной подтвержденный механизм дедупликации.
- Открывайте успешное окно только после проверки успешного результата по контракту API и сохранения состояния корзины. Изменение счетчика на экране, запуск запроса или один HTTP 200 без проверки содержимого ответа не подтверждают добавление.
- Покажите название товара, выбранный вариант и фактически добавленное количество. Если показаны цена, итог или валюта, они соответствуют подтвержденному результату. Счетчик корзины обновляется из того же состояния во всех панелях.
- «Продолжить покупки» закрывает окно и возвращает к текущему контексту: фильтрам, выбранному варианту, месту прокрутки и кнопке. «Перейти в корзину» ведет обычной ссылкой на страницу актуальной корзины. Не перенаправляйте туда автоматически.
- Крестик и Escape дают тот же выход из окна, что и продолжение покупок; они не удаляют добавленный товар. Отмена добавления, если нужна, является отдельным явно названным действием. Диалог не закрывается по короткому таймеру.
- Используйте именованный модальный диалог с фокусом внутри, недоступным фоном и возвратом фокуса при закрытии. Обе основные кнопки доступны без hover и с клавиатуры. На телефоне допустима нижняя панель-диалог, если она сохраняет этот контракт и обе опции.
- Если сервер отказал, показывайте причину рядом с действием: выбранного варианта нет, количество недоступно или операция временно не выполнена. Не показывайте успешный popup; сохраните выбор пользователя и возможность исправления.
- При потере ответа исход может быть неизвестным. Сначала восстановите подтвержденное состояние или результат той же операции; не создавайте новый эффект вслепую. Намеренное последующее добавление — новая операция, случайный повтор — прежняя. Сам по себе POST не дает гарантии идемпотентности.
- Учтите одновременные изменения в другой вкладке и смену гостевой/авторизованной сессии. Устаревший ответ не должен откатывать более новое состояние; перед переходом корзина отображает состояние текущего пользователя. Частичный результат массового добавления нельзя выдавать за успех всей подборки.

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

В вымышленном магазине покупатель выбирает вариант товара и нажимает «Купить». После подтверждения появляется окно с выбранным вариантом и двумя действиями. Продолжение оставляет его в отфильтрованном каталоге. При исчерпанном остатке показывается ошибка, а не пустая корзина за сообщением об успехе.

Shopify Ajax Cart API служит конкретным примером API с добавлением вариантов и ошибками наличия. Его адреса, коды и поведение не объявляются универсальным контрактом всех магазинов; проверяются документация и версия выбранной платформы.

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

- Добавьте выбранный вариант в тестовую корзину; сверьте фактическую позицию и количество с окном и счетчиком, затем обновите страницу корзины.
- Проверьте обе кнопки, крестик и Escape. Продолжение сохраняет контекст и фокус, переход открывает корзину; закрытие не отменяет покупательский выбор.
- Проверьте отсутствие варианта, неверное количество, отказ сервера и медленную сеть: ложного успеха нет, данные выбора не теряются.
- Выполните двойное нажатие и повтор одного запроса. Затем потеряйте ответ после принятия команды: восстановление не добавляет товар второй раз. Проверьте отдельное намеренное добавление.
- Измените корзину в двух вкладках и смените сессию; проверьте согласованность, права и порядок ответов.
- Пройдите диалог клавиатурой и скринридером, на 320–390 CSS px и при крупном тексте. Проверка выполняется на тестовой корзине без оформления и оплаты реального заказа.

## Человек

Определяет смысл «Купить», состав подтверждения, правила вариантов и количества. Принимает переходы и сообщения об отказах.

## Агент

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

## Источники

- [WAI-ARIA APG: Modal Dialog — фокус и закрытие](https://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/)
- [Shopify: Ajax Cart API — добавление, варианты и ошибки корзины](https://shopify.dev/docs/api/ajax/reference/cart)
- [RFC 9110, §9.2.2: идемпотентные методы и повторы](https://www.rfc-editor.org/rfc/rfc9110.html#section-9.2.2)

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

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