Zdarzenia
Pięć zdarzeń wywoływanych przez aplikację w sklepie, każde z przykładem.
Aplikacja wywołuje je na document, więc nasłuchuj ich przez document.addEventListener. Umieść kod w zasobie motywu albo w theme.liquid nad </body>.
| Zdarzenie | detail | Kiedy jest wywoływane |
|---|---|---|
gpoRenderCompleted | { form, product } | Opcje zostały wyrenderowane |
gpoElementChanged | {} | Klient zmienił opcję |
gpoProductPriceUpdated | {} | Wyświetlana cena została przeliczona |
gpoValidated | { success } | Przy dodawaniu do koszyka przeprowadzono walidację |
gpoAddedToCart | {} | Produkt i jego dodatki trafiły do koszyka |
gpoRenderCompleted
Wywoływane, gdy pola opcji są już w DOM. Na tym zdarzeniu warto budować. Aplikacja renderuje asynchronicznie, więc kod uruchamiany na DOMContentLoaded działa, zanim opcje istnieją, i niczego nie znajduje.
detail zawiera form — formularz produktu, w którym wyrenderowano opcje — oraz product, czyli produkt, dla którego je wyrenderowano.
document.addEventListener('gpoRenderCompleted', function (event) { const { form, product } = event.detail; if (!form) return; // żaden zestaw opcji nie dotyczy tego produktu
// Teraz można bezpiecznie odpytywać pola opcji form.querySelectorAll('.gpo-form__group').forEach(function (group) { group.classList.add('my-theme-option'); });});Wywoływane jest ponownie przy każdym ponownym renderowaniu opcji — po zmianie wariantu w motywach, które ponownie renderują produkt, albo po wywołaniu GPOConfigs.initialize(). Napisz obsługę tak, aby dwukrotne uruchomienie było nieszkodliwe.
gpoElementChanged
Wywoływane przy każdej zmianie opcji przez klienta: wpisaniu tekstu w pole, wybraniu próbki, zaznaczeniu pola wyboru.
document.addEventListener('gpoElementChanged', function () { const engraving = document.querySelector('[name="properties[Engraving text]"]'); const note = document.querySelector('.my-engraving-note'); if (!engraving || !note) return;
note.hidden = engraving.value.trim() === '';});Wywoływane jest przy każdym naciśnięciu klawisza w polu tekstowym, więc wszystko, co kosztowne — żądanie sieciowe, ciężkie przeliczenie układu — opóźniaj (debounce).
gpoProductPriceUpdated
Wywoływane, gdy aplikacja zaktualizuje wyświetlaną cenę o opcje wybrane przez klienta. Użyj go, aby utrzymać własną prezentację ceny w zgodzie — przyklejony pasek, blok podsumowania, szacunek raty.
document.addEventListener('gpoProductPriceUpdated', function () { const main = document.querySelector('[data-gpo-product-unit-price]'); const sticky = document.querySelector('.my-sticky-bar .price'); if (main && sticky) sticky.textContent = main.textContent;});Cena widoczna na stronie to podgląd. Kwotę, którą klient faktycznie płaci, nalicza Shopify przy realizacji zakupu, więc nigdy nie traktuj tej wartości jako ostatecznej. Zobacz Jak naliczane są ceny.
gpoValidated
Wywoływane, gdy klient próbuje dodać produkt do koszyka, a aplikacja sprawdziła opcje. detail.success ma wartość false, gdy coś jest nie tak — puste pole wymagane, przekroczony limit znaków, za mało wyborów.
document.addEventListener('gpoValidated', function (event) { if (event.detail.success) return;
// Dodanie do koszyka zostało zablokowane if (window.analytics) { window.analytics.track('Option validation failed', { product: window.GPOConfigs?.product?.handle }); }});Aplikacja sama przewija do pierwszego błędu, gdy włączona jest opcja Automatyczne przewijanie do pierwszego komunikatu o błędzie, więc nie musisz robić tego sam. Zobacz Działanie widżetu.
gpoAddedToCart
Wywoływane po dodaniu produktu i ewentualnych produktów dodatkowych. To moment, w którym koszyk rzeczywiście się zmienił, więc to właściwe miejsce na otwieranie koszyka i analitykę.
document.addEventListener('gpoAddedToCart', function () { fetch(window.Shopify.routes.root + 'cart.js') .then(function (res) { return res.json(); }) .then(function (cart) { document.querySelector('.my-cart-count').textContent = cart.item_count; });});Dodatek oparty na produkcie to osobna pozycja koszyka, więc jedno dodanie do koszyka może dodać kilka pozycji. Odczytaj koszyk ponownie, zamiast zakładać, że dodano jeden produkt. Zobacz Łączenie produktu głównego i dodatków.
Uwagi
- Wszystkie pięć wymaga włączonego osadzenia aplikacji. Bez niego aplikacja się nie uruchamia i nic nie jest wywoływane.
- Zdarzenia nie przenoszą żadnych danych klienta poza tymi, które już są na stronie. Produkt, koszyk i klienta odczytasz z window.GPOConfigs.
- Kod, który tu podłączysz, utrzymujesz sam i to od niego warto zacząć sprawdzanie, gdy sklep działa nieprawidłowo po aktualizacji motywu lub aplikacji.
Czy to było pomocne?
Dziękujemy za opinię! Powiedz nam, czego zabrakło
Zgłoś problem