window.aftersell.cart.events.
Подписка — это вызов настройки, поэтому её безопасно размещать в начале вашего скрипта, без необходимости ждать ready().
events.on(event, handler) регистрирует обработчик и возвращает функцию, которая отменяет подписку:
events.once(event, handler): срабатывает один раз, затем отписывается сам.events.off(event, handler): удаляет конкретный обработчик.
Почти каждая ошибка с событиями сводится к одному из них. Изменение корзины внутри обработчика
cart_updated снова вызывает cart_updated. Если этот обработчик снова изменяет корзину, у вас бесконечный цикл. Покупатель наблюдает, как его корзина лихорадочно меняется, пока страница бомбардирует Shopify.
registerLineTransform.
Срабатывает один раз, когда корзина впервые загружается на странице. Payload — полный объект корзины.
cart_loaded повторно воспроизводится для поздних подписчиков. Если вы подпишетесь после того, как корзина уже загрузилась, ваш обработчик вызывается немедленно с текущей корзиной. Порядок подписки никогда не имеет значения, поэтому вам не нужно беспокоиться о том, успел ли ваш скрипт раньше корзины.
Срабатывает каждый раз, когда содержимое корзины меняется после первой загрузки, будь то из drawer, из ваших собственных действий, из темы или из другого приложения. Payload — полный объект корзины.
{ item }, где item — это позиция корзины.
cart_loaded. Добавление нескольких разных товаров сразу вызывает событие один раз на каждую позицию.
Срабатывает, когда позиция исчезает из корзины. Payload — { item }, позиция в том виде, в каком она была непосредственно перед исчезновением, поэтому вы всё ещё можете прочитать её key, variantId и title.
item_added: уменьшение количества без достижения нуля не является удалением.
Срабатывают при открытии и закрытии drawer. Без payload.
Каждое событие также отправляется как DOM
CustomEvent на window, поэтому вы можете слушать, не касаясь window.aftersell.cart. Это полезно из файла темы, стороннего приложения или скрипта, загружающегося независимо от корзины.
Обратите внимание на именование: шина использует
snake_case, DOM-события используют kebab-case с префиксом aftersell:cart:.
event.detail и соответствует объекту корзины. События отправляются на window, поэтому слушатель в любом месте страницы их получает. Корзина отрисовывается в shadow root, но граница shadow никогда не находится на пути события. Каждая отправка клонирует payload, поэтому слушатель, мутирующий event.detail, не может повлиять на других, а слушатель, выбросивший исключение, не может нарушить работу SDK.
Отдельно корзина публикует стандартные события корзины Shopify на document всякий раз, когда она изменяет корзину, поэтому код темы и другие приложения могут реагировать на мутации Aftersell так же, как они реагируют на мутации темы:
Каждое событие также несёт
promise, который Aftersell разрешает, когда завершается базовая запись, в соответствии со стандартом Shopify — ожидайте его, не разрешайте сами. Они отправляются на document и всплывают, поэтому слушатель на window тоже их получает.
- Объект корзины: полная структура payload выше.
- Действия: как изменить корзину из обработчика.
- Хуки: для изменения отрисовки корзины, а не реакции на неё.
- Сценарии использования: отслеживание аналитики, бесплатные подарки и другие полные примеры.