Gå til indhold
Installer app
Dansk

Hændelser

De fem hændelser, appen udløser i webshoppen, hver med et gennemgået eksempel.

Appen udløser disse på document, så lyt med document.addEventListener. Placer koden i en temaressource eller i theme.liquid over </body>.

HændelsedetailUdløses, når
gpoRenderCompleted{ form, product }Optionerne er færdige med at blive vist
gpoElementChanged{}Kunden har ændret en option
gpoProductPriceUpdated{}Den viste pris er blevet genberegnet
gpoValidated{ success }Valideringen er kørt ved Læg i kurv
gpoAddedToCart{}Varen og dens tilføjelser er nået frem til kurven

gpoRenderCompleted

Udløses, så snart optionsfelterne findes i DOM’en. Det er den, du skal bygge videre på. Appen gengiver asynkront, så kode, der kører ved DOMContentLoaded, kører, før optionerne findes, og finder ingenting.

detail indeholder form, den produktformular, som optionerne blev gengivet i, og product, det produkt, de blev gengivet for.

document.addEventListener('gpoRenderCompleted', function (event) {
const { form, product } = event.detail;
if (!form) return; // intet optionssæt gælder for dette produkt
// Nu er det sikkert at forespørge optionsfelterne
form.querySelectorAll('.gpo-form__group').forEach(function (group) {
group.classList.add('my-theme-option');
});
});

Den udløses igen, hver gang optionerne gengives på ny – efter et variantskift i temaer, der gentegner produktet, eller efter at du kalder GPOConfigs.initialize(). Skriv handleren, så det ikke gør noget, at den kører to gange.

gpoElementChanged

Udløses, hver gang kunden ændrer en option: skriver i et felt, vælger en farveprøve, sætter flueben i et afkrydsningsfelt.

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 udløses ved hvert tastetryk i et tekstfelt, så brug debounce på alt, der er tungt – en netværksanmodning, en omfattende ny layoutberegning.

gpoProductPriceUpdated

Udløses, når appen har omskrevet den viste pris, så den inkluderer de optioner, kunden har valgt. Brug den til at holde din egen prisvisning i takt – en fastgjort bjælke, en opsummeringsblok, et estimat for afbetaling.

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, der vises på siden, er en forhåndsvisning. Det, kunden faktisk bliver opkrævet, anvendes af Shopify på betalingssiden, så behandl aldrig dette tal som det endelige beløb. Se Sådan anvendes priserne.

gpoValidated

Udløses, når kunden forsøger at lægge i kurven, og appen har tjekket optionerne. detail.success er false, når noget er forkert – en obligatorisk option er tom, en tegngrænse er overskredet, der er for få valg.

document.addEventListener('gpoValidated', function (event) {
if (event.detail.success) return;
// Læg i kurv blev blokeret
if (window.analytics) {
window.analytics.track('Option validation failed', {
product: window.GPOConfigs?.product?.handle
});
}
});

Appen ruller allerede til den første fejl, når Automatisk rulning til første fejlmeddelelse er slået til, så det behøver du ikke selv at gøre. Se Widgetadfærd.

gpoAddedToCart

Udløses, når varen og eventuelle tilføjelsesprodukter er blevet tilføjet. Det er her, kurven reelt er ændret, og derfor er det det rette sted at åbne kurven og spore analyser.

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;
});
});

En tilføjelse, der er baseret på et produkt, er sin egen kurvlinje, så ét Læg i kurv kan tilføje flere linjer. Læs kurven tilbage i stedet for at antage, at der blev tilføjet én vare. Se Flet hovedprodukt og tilføjelser.

Bemærkninger

  • Alle fem kræver, at appintegrationen er aktiveret. Uden den kører appen aldrig, og intet udløses.
  • Hændelserne indeholder ingen kundedata ud over det, der allerede er på siden. Læs window.GPOConfigs for produktet, kurven og kunden.
  • Kode, du knytter til her, skal du selv vedligeholde, og den er det første, du skal tjekke, når webshoppen opfører sig forkert efter en tema- eller appopdatering.

Var dette nyttigt?

Rapportér et problem