window.aftersell.cart.actions.
Действия выполняются после готовности корзины, внутри
ready() или обработчика события.До загрузки корзины действия являются заглушками. Каждое из них выводит в консоль предупреждение с именем действия, например
cart.actions.addItem() called before the cart loaded, и ничего не делает. Асинхронные действия всё равно разрешают Promise, поэтому цепочка .then() выполняется нормально, а не выбрасывает исключение; getCart() возвращает null, а formatMoney() возвращает пустую строку.Ничего не ломается, если вызвать действие слишком рано, но и ничего не происходит. Следите за этим предупреждением в консоли, когда действие как будто ничего не делает.Открывают или закрывают drawer-корзину. Оба синхронны и не принимают аргументов.
Возвращает текущий объект корзины или
null до его загрузки. Результат является копией, поэтому его изменение не повлияет на настоящую корзину.
getCart() там избыточен.
Форматирует сумму в минимальных денежных единицах, используя денежный формат вашего магазина. Каждая цена в SDK указана в центах, поэтому именно так вы превращаете её в то, что можно отобразить.
configure({ money_format }).
Действия с позициями идентифицируют позицию по её Shopify
key, а не по ID варианта, потому что корзина может содержать один и тот же вариант в нескольких позициях с разными свойствами. Читайте его из getCart().items[n].key.quantity по умолчанию равен 1. Разрешается, когда корзина стабилизируется.
0 удаляет позицию.
cart_updated, потому что проверка > 1 даёт false при втором проходе. См. два правила.
Меняет вариант позиции, сохраняя её количество и свойства. Полезно для переключателя размера или вкуса внутри корзины.
key и оказывается в конце корзины. После этого заново прочитайте getCart() вместо повторного использования переданного вами ключа.
Повторно запрашивает корзину у Shopify. Используйте его после того, как что-то вне SDK изменило корзину, а drawer этого не заметил.
- Асинхронные действия разрешаются, когда изменение стабилизируется. Ожидание одного из них позволяет выстроить последовательность работы после фактического обновления корзины.
getCart()возвращает копию. Её изменение никак не влияет на настоящую корзину.- Нет действия для промокодов. Применённые коды доступны для чтения в корзине (
discountCodes,totalDiscount) и по позициям (discountAllocations); покупатели применяют их через блок Discount code. - Нет действия для атрибутов корзины или примечаний. Атрибуты доступны для чтения в объекте корзины; покупатели пишут примечания через блок Notes.
- Чтобы скрыть позицию, а не удалить её, используйте
registerLineTransform. Удаление меняет итоговую сумму покупателя; скрытие — нет.
- Объект корзины: что возвращает
getCart(). - События: когда запускать эти действия.
- Хуки: измените отрисовку позиции вместо изменения корзины.
- Сценарии использования: полные решения распространённых запросов.