Přeskočit na obsah
Nainstalovat aplikaci
Čeština

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álostdetailVyvolá 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?

Nahlásit problém