Olaylar
Uygulamanın vitrinde tetiklediği beş olay ve her biri için çalışan bir örnek.
Uygulama bu olayları document üzerinde tetikler. Bu yüzden document.addEventListener ile dinleyin. Kodu bir tema varlığına veya theme.liquid dosyasında </body> etiketinin üstüne koyun.
| Olay | detail | Ne zaman tetiklenir |
|---|---|---|
gpoRenderCompleted | { form, product } | Seçeneklerin çizimi tamamlandığında |
gpoElementChanged | {} | Müşteri bir seçeneği değiştirdiğinde |
gpoProductPriceUpdated | {} | Gösterilen fiyat yeniden hesaplandığında |
gpoValidated | { success } | Sepete eklemede doğrulama çalıştığında |
gpoAddedToCart | {} | Ürün ve eklentileri sepete ulaştığında |
gpoRenderCompleted
Seçenek alanları DOM’da oluştuğunda tetiklenir. Üzerine geliştirme yapmanız gereken olay budur. Uygulama eşzamansız çizer. Bu yüzden DOMContentLoaded sırasında çalışan kod, seçenekler oluşmadan çalışır ve hiçbir şey bulamaz.
detail, seçeneklerin çizildiği ürün formu olan form ile seçeneklerin çizildiği ürün olan product bilgisini taşır.
document.addEventListener('gpoRenderCompleted', function (event) { const { form, product } = event.detail; if (!form) return; // bu ürüne hiçbir seçenek kümesi uygulanmıyor
// Seçenek alanlarını artık güvenle sorgulayabilirsiniz form.querySelectorAll('.gpo-form__group').forEach(function (group) { group.classList.add('my-theme-option'); });});Seçenekler her yeniden çizildiğinde tekrar tetiklenir: ürünü yeniden çizen temalarda varyasyon değiştikten sonra veya GPOConfigs.initialize() çağırdıktan sonra. İşleyiciyi, iki kez çalışması zarar vermeyecek şekilde yazın.
gpoElementChanged
Müşteri bir seçeneği her değiştirdiğinde tetiklenir: bir alana yazarken, bir renk örneği seçerken, bir onay kutusunu işaretlerken.
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() === '';});Bir metin alanında her tuş vuruşunda tetiklenir. Bu yüzden ağ isteği veya ağır bir yeniden yerleşim gibi maliyetli işlemleri geciktirin (debounce).
gpoProductPriceUpdated
Uygulama, gösterilen fiyatı müşterinin seçtiği seçenekleri içerecek şekilde yeniden yazdıktan sonra tetiklenir. Kendi fiyat gösteriminizi uyumlu tutmak için kullanın: yapışkan çubuk, özet bloğu, taksit tahmini.
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;});Sayfada gösterilen fiyat bir önizlemedir. Müşteriden gerçekte alınan tutarı Shopify ödeme sırasında uygular. Bu yüzden bu rakamı asla nihai tutar olarak değerlendirmeyin. Fiyatlandırma nasıl uygulanır sayfasına bakın.
gpoValidated
Müşteri sepete eklemeye çalıştığında ve uygulama seçenekleri kontrol ettiğinde tetiklenir. Bir sorun olduğunda detail.success değeri false olur: boş bırakılmış zorunlu bir seçenek, aşılmış bir karakter sınırı, çok az seçim.
document.addEventListener('gpoValidated', function (event) { if (event.detail.success) return;
// Sepete ekleme engellendi if (window.analytics) { window.analytics.track('Option validation failed', { product: window.GPOConfigs?.product?.handle }); }});İlk hata mesajına otomatik kaydır açık olduğunda uygulama zaten ilk hataya kaydırır. Bunu sizin yapmanıza gerek yoktur. Widget davranışı sayfasına bakın.
gpoAddedToCart
Ürün ve varsa eklenti ürünleri eklendikten sonra tetiklenir. Sepetin gerçekten değiştiği an budur. Bu yüzden sepeti açma ve analiz işlemleri için doğru yer burasıdır.
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; });});Arkasında bir ürün bulunan eklenti kendi sepet satırıdır. Bu yüzden tek bir sepete ekleme işlemi birkaç satır ekleyebilir. Tek bir ürün eklendiğini varsaymak yerine sepeti yeniden okuyun. Ana ürünü ve eklentileri birleştirme sayfasına bakın.
Notlar
- Beş olayın tümü uygulama yerleştirmesinin etkin olmasını gerektirir. O olmadan uygulama hiç çalışmaz ve hiçbir olay tetiklenmez.
- Olaylar, sayfada zaten bulunanların ötesinde müşteri verisi taşımaz. Ürün, sepet ve müşteri için window.GPOConfigs nesnesini okuyun.
- Buraya bağladığınız kodun bakımı size aittir. Bir tema veya uygulama güncellemesinden sonra vitrin hatalı davrandığında ilk kontrol edilecek yerdir.
Bu sayfa yardımcı oldu mu?
Geri bildiriminiz için teşekkürler! Neyin eksik olduğunu bize söyleyin
Sorun bildir