window.aftersell.cart.events.
Abonneren is een set-up-aanroep, dus veilig bovenaan je script, zonder dat je op ready() hoeft te wachten.
events.on(event, handler) registreert een handler en geeft een functie terug die het abonnement opzegt:
events.once(event, handler): gaat één keer af en schrijft zichzelf daarna uit.events.off(event, handler): verwijdert een specifieke handler.
Bijna elke event-bug is terug te voeren op een van deze. De winkelwagen wijzigen binnen een
cart_updated-handler laat cart_updated opnieuw afgaan. Als die handler de winkelwagen opnieuw wijzigt, heb je een oneindige loop. De shopper ziet zijn winkelwagen wild heen en weer gaan terwijl de pagina Shopify bestookt.
registerLineTransform.
Gaat één keer af, wanneer de winkelwagen voor het eerst op de pagina laadt. De payload is het volledige cart-object.
cart_loaded wordt herafgespeeld voor late abonnees. Als je je abonneert nadat de winkelwagen al is geladen, wordt je handler direct aangeroepen met de huidige winkelwagen. De volgorde van abonneren maakt nooit uit, dus je hoeft je geen zorgen te maken of je script sneller was dan de winkelwagen.
Gaat elke keer af dat de inhoud van de winkelwagen verandert na de eerste load, of dat nu via de drawer is, via je eigen actions, via het thema of via een andere app. De payload is het volledige cart-object.
{ item }, waarbij item de winkelwagenregel is.
cart_loaded. Meerdere verschillende producten tegelijk toevoegen laat het event één keer per regel afgaan.
Gaat af wanneer een regel uit de winkelwagen verdwijnt. De payload is { item }, de regel zoals hij was net voordat hij verdween, dus je kunt nog steeds zijn key, variantId en title lezen.
item_added: een aantal verlagen zonder nul te raken is geen verwijdering.
Gaan af wanneer de drawer opent en sluit. Geen payload.
Elk event wordt ook gedispatcht als een DOM-
CustomEvent op window, dus je kunt luisteren zonder window.aftersell.cart aan te raken. Dat is handig vanuit een themabestand, een externe app of een script dat onafhankelijk van de winkelwagen laadt.
Let op de naamgeving: de bus gebruikt
snake_case, de DOM-events gebruiken kebab-case achter een aftersell:cart:-prefix.
event.detail en komt overeen met het cart-object. Events worden gedispatcht op window, dus een listener waar dan ook op de pagina ontvangt ze. De winkelwagen rendert in een shadow root, maar de shadow-grens zit nooit in het pad van het event. Elke dispatch kloont de payload, dus een listener die event.detail muteert kan niemand anders beïnvloeden, en een listener die een fout gooit kan de SDK niet verstoren.
Daarnaast publiceert de winkelwagen Shopify’s standaard cart-events op document telkens wanneer hij de winkelwagen wijzigt, zodat themacode en andere apps op Aftersell’s mutaties kunnen reageren op dezelfde manier als op die van het thema:
Elk event draagt ook een
promise die Aftersell settelt wanneer de onderliggende write landt, conform Shopify’s standaard — await hem, resolve hem niet. Deze worden gedispatcht op document en bubbelen, dus een window-listener ontvangt ze ook.
- Cart-object: de volledige vorm van de payloads hierboven.
- Actions: hoe je de winkelwagen wijzigt vanuit een handler.
- Hooks: om te wijzigen hoe de winkelwagen rendert, in plaats van erop te reageren.
- Use cases: analytics-tracking, gratis geschenken en andere complete voorbeelden.