Hendelser
De fem hendelsene appen utløser i nettbutikken, hver med et gjennomgått eksempel.
Appen utløser disse på document, så lytt med document.addEventListener. Legg koden i en temaressurs eller i theme.liquid over </body>.
| Hendelse | detail | Utløses når |
|---|---|---|
gpoRenderCompleted | { form, product } | Alternativene er ferdig gjengitt |
gpoElementChanged | {} | Kunden endret et alternativ |
gpoProductPriceUpdated | {} | Den viste prisen ble beregnet på nytt |
gpoValidated | { success } | Valideringen kjørte ved Legg i handlekurven |
gpoAddedToCart | {} | Varen og tilleggene kom i handlekurven |
gpoRenderCompleted
Utløses når alternativfeltene finnes i DOM-en. Det er denne du bør bygge på. Appen gjengir asynkront, så kode som kjører på DOMContentLoaded, kjører før alternativene finnes og finner ingenting.
detail inneholder form, produktskjemaet alternativene ble gjengitt i, og product, produktet de ble gjengitt for.
document.addEventListener('gpoRenderCompleted', function (event) { const { form, product } = event.detail; if (!form) return; // ingen alternativsett gjelder for dette produktet
// Nå er det trygt å hente alternativfeltene form.querySelectorAll('.gpo-form__group').forEach(function (group) { group.classList.add('my-theme-option'); });});Den utløses igjen hver gang alternativene gjengis på nytt – etter et variantbytte i temaer som gjengir produktet på nytt, eller etter at du kaller GPOConfigs.initialize(). Skriv behandleren slik at det ikke skader å kjøre den to ganger.
gpoElementChanged
Utløses hver gang kunden endrer et alternativ: skriver i et felt, velger en fargeprøve eller krysser av i en avmerkingsboks.
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() === '';});Den utløses ved hvert tastetrykk i et tekstfelt, så bruk debounce på alt som er tungt – en nettverksforespørsel eller en tung ny layout.
gpoProductPriceUpdated
Utløses etter at appen har skrevet om den viste prisen slik at den inkluderer alternativene kunden valgte. Bruk den til å holde din egen prisvisning i takt – en fast linje, en oppsummeringsblokk eller et anslag for delbetaling.
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;});Prisen som vises på siden, er en forhåndsvisning. Det kunden faktisk belastes, brukes av Shopify i kassen, så behandle aldri dette tallet som det endelige beløpet. Se Slik brukes prisene.
gpoValidated
Utløses når kunden prøver å legge i handlekurven og appen har sjekket alternativene. detail.success er false når noe er feil – et obligatorisk alternativ er tomt, en tegnbegrensning er overskredet eller det er for få valg.
document.addEventListener('gpoValidated', function (event) { if (event.detail.success) return;
// Legg i handlekurven ble blokkert if (window.analytics) { window.analytics.track('Option validation failed', { product: window.GPOConfigs?.product?.handle }); }});Appen ruller allerede til den første feilen når Rull automatisk til første feilmelding er på, så du trenger ikke gjøre det selv. Se Widgetens oppførsel.
gpoAddedToCart
Utløses etter at varen og eventuelle tilleggsprodukter er lagt til. Det er her handlekurven faktisk har endret seg, og derfor er dette rett sted for å åpne handlekurven og for analyse.
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; });});Et tillegg som er knyttet til et produkt, er en egen handlekurvlinje, så én Legg i handlekurven kan legge til flere linjer. Les handlekurven på nytt i stedet for å anta at én vare ble lagt til. Se Slå sammen hovedprodukt og tillegg.
Merknader
- Alle fem krever at appinnbyggingen er aktivert. Uten den kjører appen aldri, og ingenting utløses.
- Hendelsene inneholder ingen kundedata utover det som allerede er på siden. Les window.GPOConfigs for produktet, handlekurven og kunden.
- Kode du kobler til her, må du vedlikeholde selv, og den er det første du bør sjekke når nettbutikken oppfører seg rart etter en oppdatering av temaet eller appen.
Var dette nyttig?
Takk for tilbakemeldingen! Fortell oss hva som manglet
Rapporter et problem