Události
Pět událostí, které aplikace vyvolává v obchodě, každá s funkčním příkladem.
Aplikace tyto události vyvolává na document, takže je zachytávejte pomocí document.addEventListener. Kód vložte do prostředku motivu nebo do theme.liquid nad </body>.
| Událost | detail | Vyvolá se, když |
|---|---|---|
gpoRenderCompleted | { form, product } | Vykreslení možností bylo dokončeno |
gpoElementChanged | {} | Zákazník změnil možnost |
gpoProductPriceUpdated | {} | Zobrazená cena byla přepočítána |
gpoValidated | { success } | Proběhlo ověření při přidání do košíku |
gpoAddedToCart | {} | Položka a její doplňky byly přidány do košíku |
gpoRenderCompleted
Vyvolá se, jakmile pole možností existují v DOM. Na této události stavějte. Aplikace vykresluje asynchronně, takže kód spuštěný při DOMContentLoaded běží dříve, než možnosti existují, a nic nenajde.
detail obsahuje form, formulář produktu, do kterého byly možnosti vykresleny, a product, produkt, pro který byly vykresleny.
document.addEventListener('gpoRenderCompleted', function (event) { const { form, product } = event.detail; if (!form) return; // na tento produkt se nevztahuje žádná sada možností
// Nyní lze pole možností bezpečně vyhledávat form.querySelectorAll('.gpo-form__group').forEach(function (group) { group.classList.add('my-theme-option'); });});Vyvolá se znovu pokaždé, když se možnosti znovu vykreslí — po změně varianty u motivů, které produkt znovu vykreslují, nebo po zavolání GPOConfigs.initialize(). Napište obslužnou funkci tak, aby dvojí spuštění nevadilo.
gpoElementChanged
Vyvolá se pokaždé, když zákazník změní možnost: píše do pole, vybere vzorník, zaškrtne zaškrtávací políčko.
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() === '';});V textovém poli se vyvolá při každém stisku klávesy, takže cokoli náročného — síťový požadavek, rozsáhlé přeuspořádání — omezte pomocí debounce.
gpoProductPriceUpdated
Vyvolá se poté, co aplikace přepsala zobrazenou cenu tak, aby zahrnovala možnosti vybrané zákazníkem. Použijte ji k synchronizaci vlastního zobrazení ceny — přichyceného panelu, souhrnného bloku, odhadu splátek.
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 zobrazená na stránce je náhled. Částku, která se zákazníkovi skutečně účtuje, uplatní Shopify v pokladně, takže tuto hodnotu nikdy nepovažujte za konečnou částku. Viz Jak se ceny uplatňují.
gpoValidated
Vyvolá se, když se zákazník pokusí přidat produkt do košíku a aplikace zkontrolovala možnosti. detail.success má hodnotu false, když je něco špatně — povinná možnost je prázdná, je překročen limit znaků, je vybráno příliš málo hodnot.
document.addEventListener('gpoValidated', function (event) { if (event.detail.success) return;
// Přidání do košíku bylo zablokováno if (window.analytics) { window.analytics.track('Option validation failed', { product: window.GPOConfigs?.product?.handle }); }});Když je zapnuté Automaticky přejít na první chybovou zprávu, aplikace na první chybu posune stránku sama, takže to nemusíte dělat vy. Viz Chování widgetu.
gpoAddedToCart
Vyvolá se poté, co byla přidána položka a případné doplňkové produkty. V tomto okamžiku se košík skutečně změnil, proto je to správné místo pro otevření košíku a analytiku.
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; });});Doplněk založený na produktu tvoří samostatný řádek košíku, takže jedno přidání do košíku může přidat několik řádků. Košík si znovu načtěte, místo abyste předpokládali, že byla přidána jedna položka. Viz Sloučení hlavního produktu a doplňků.
Poznámky
- Všech pět vyžaduje zapnuté vložení aplikace. Bez něj se aplikace nikdy nespustí a nic se nevyvolá.
- Události nenesou žádná data o zákaznících nad rámec toho, co už je na stránce. Produkt, košík a zákazníka najdete ve window.GPOConfigs.
- Kód, který sem připojíte, si udržujete sami a je to první věc, kterou je třeba zkontrolovat, když se obchod po aktualizaci motivu nebo aplikace chová nesprávně.
Pomohla vám tato stránka?
Děkujeme za zpětnou vazbu! Napište nám, co chybělo
Nahlásit problém