window.aftersell.cart.events.
Subskrybowanie to wywołanie konfiguracyjne, więc jest bezpieczne na górze Twojego skryptu, bez potrzeby czekania na ready().
events.on(event, handler) rejestruje handler i zwraca funkcję, która go wyrejestrowuje:
events.once(event, handler): uruchamia się raz, a potem sam się wyrejestrowuje.events.off(event, handler): usuwa konkretny handler.
Prawie każdy błąd związany ze zdarzeniami sprowadza się do jednej z nich. Zmiana koszyka wewnątrz handlera
cart_updated ponownie uruchamia cart_updated. Jeśli ten handler znów zmienia koszyk, masz nieskończoną pętlę. Klient patrzy, jak jego koszyk się miota, podczas gdy strona bombarduje Shopify.
registerLineTransform.
Uruchamia się raz, gdy koszyk po raz pierwszy ładuje się na stronie. Payload to pełny obiekt koszyka.
cart_loaded jest odtwarzane dla spóźnionych subskrybentów. Jeśli zasubskrybujesz po tym, jak koszyk już się załadował, Twój handler jest natychmiast wywoływany z bieżącym koszykiem. Kolejność subskrypcji nigdy nie ma znaczenia, więc nie musisz się martwić, czy Twój skrypt wyprzedził koszyk.
Uruchamia się za każdym razem, gdy zawartość koszyka zmienia się po pierwszym załadowaniu, czy to z drawera, z Twoich własnych akcji, z motywu, czy z innej aplikacji. Payload to pełny obiekt koszyka.
{ item }, gdzie item to pozycja koszyka.
cart_loaded. Dodanie kilku różnych produktów naraz uruchamia zdarzenie raz na pozycję.
Uruchamia się, gdy pozycja znika z koszyka. Payload to { item } — pozycja w stanie tuż przed zniknięciem, więc nadal możesz odczytać jej key, variantId i title.
item_added: obniżenie ilości bez osiągnięcia zera nie jest usunięciem.
Uruchamiają się, gdy drawer otwiera się i zamyka. Bez payloadu.
Każde zdarzenie jest też wysyłane jako DOM-owe
CustomEvent na window, więc możesz nasłuchiwać bez dotykania window.aftersell.cart. To przydatne z pliku motywu, aplikacji zewnętrznej lub skryptu ładującego się niezależnie od koszyka.
Zwróć uwagę na nazewnictwo: bus używa
snake_case, zdarzenia DOM używają kebab-case za prefiksem aftersell:cart:.
event.detail i odpowiada obiektowi koszyka. Zdarzenia są wysyłane na window, więc listener w dowolnym miejscu strony je otrzymuje. Koszyk renderuje się w shadow root, ale granica shadow nigdy nie znajduje się na ścieżce zdarzenia. Każde wysłanie klonuje payload, więc listener modyfikujący event.detail nie może wpłynąć na nikogo innego, a listener rzucający wyjątek nie może zakłócić SDK.
Osobno koszyk publikuje standardowe zdarzenia koszyka Shopify na document, ilekroć zmienia koszyk, dzięki czemu kod motywu i inne aplikacje mogą reagować na modyfikacje Aftersell tak samo, jak reagują na te z motywu:
Każde zdarzenie niesie też
promise, który Aftersell rozstrzyga, gdy podstawowy zapis się powiedzie, zgodnie ze standardem Shopify — czekaj na niego (await), nie rozstrzygaj go. Są one wysyłane na document i propagują się (bubble), więc listener na window też je otrzymuje.
- Obiekt koszyka: pełna struktura powyższych payloadów.
- Akcje: jak zmieniać koszyk z handlera.
- Hooki: do zmieniania sposobu renderowania koszyka, zamiast reagowania na niego.
- Przypadki użycia: śledzenie analityczne, darmowe prezenty i inne kompletne przykłady.