Eventi
I cinque eventi che l'app attiva nel negozio online, ciascuno con un esempio pratico.
L’app attiva questi eventi su document, quindi rimani in ascolto con document.addEventListener. Inserisci il codice in una risorsa del tema oppure in theme.liquid sopra </body>.
| Evento | detail | Attivato quando |
|---|---|---|
gpoRenderCompleted | { form, product } | Le opzioni hanno terminato il rendering |
gpoElementChanged | {} | Il cliente ha modificato un'opzione |
gpoProductPriceUpdated | {} | Il prezzo mostrato è stato ricalcolato |
gpoValidated | { success } | È stata eseguita la convalida all'aggiunta al carrello |
gpoAddedToCart | {} | L'articolo e i suoi add-on sono stati aggiunti al carrello |
gpoRenderCompleted
Attivato non appena i campi delle opzioni esistono nel DOM. È quello su cui basarti. L’app esegue il rendering in modo asincrono, quindi il codice eseguito su DOMContentLoaded viene eseguito prima che le opzioni esistano e non trova nulla.
detail contiene form, il modulo del prodotto in cui sono state renderizzate le opzioni, e product, il prodotto per cui sono state renderizzate.
document.addEventListener('gpoRenderCompleted', function (event) { const { form, product } = event.detail; if (!form) return; // nessun set di opzioni si applica a questo prodotto
// Ora puoi interrogare i campi delle opzioni in sicurezza form.querySelectorAll('.gpo-form__group').forEach(function (group) { group.classList.add('my-theme-option'); });});Viene attivato di nuovo ogni volta che le opzioni vengono renderizzate di nuovo: dopo un cambio di variante nei temi che ridisegnano il prodotto, o dopo che chiami GPOConfigs.initialize(). Scrivi il gestore in modo che eseguirlo due volte non causi problemi.
gpoElementChanged
Attivato ogni volta che il cliente modifica un’opzione: digitando in un campo, scegliendo un campione, selezionando una casella di controllo.
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() === '';});Viene attivato a ogni tasto premuto in un campo di testo, quindi applica il debounce a qualsiasi operazione onerosa, come una richiesta di rete o un ricalcolo pesante del layout.
gpoProductPriceUpdated
Attivato dopo che l’app ha riscritto il prezzo mostrato per includere le opzioni scelte dal cliente. Usalo per mantenere allineata la tua visualizzazione del prezzo: una barra fissa, un blocco di riepilogo, una stima delle rate.
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;});Il prezzo mostrato sulla pagina è un’anteprima. L’importo effettivamente addebitato al cliente viene applicato da Shopify al checkout, quindi non considerare mai questa cifra come l’importo finale. Consulta Come vengono applicati i prezzi.
gpoValidated
Attivato quando il cliente prova ad aggiungere al carrello e l’app ha controllato le opzioni. detail.success è false quando qualcosa non va: un’opzione obbligatoria vuota, un limite di caratteri superato, troppo poche selezioni.
document.addEventListener('gpoValidated', function (event) { if (event.detail.success) return;
// L'aggiunta al carrello è stata bloccata if (window.analytics) { window.analytics.track('Option validation failed', { product: window.GPOConfigs?.product?.handle }); }});L’app scorre già fino al primo errore quando Scorrimento automatico al primo messaggio di errore è attivato, quindi non devi farlo tu. Consulta Comportamento del widget.
gpoAddedToCart
Attivato dopo che l’articolo ed eventuali prodotti add-on sono stati aggiunti. È il momento in cui il carrello è davvero cambiato, quindi è il punto giusto per aprire il carrello e per l’analisi dei dati.
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; });});Un add-on basato su un prodotto è una riga del carrello separata, quindi una sola aggiunta al carrello può aggiungere più righe. Rileggi il carrello invece di presumere che sia stato aggiunto un solo articolo. Consulta Unire prodotto principale e add-on.
Note
- Tutti e cinque richiedono l’incorporamento app attivato. Senza di esso l’app non viene mai eseguita e non viene attivato nulla.
- Gli eventi non contengono dati dei clienti oltre a quelli già presenti nella pagina. Leggi window.GPOConfigs per prodotto, carrello e cliente.
- Il codice che colleghi qui è a tuo carico ed è la prima cosa da controllare quando il negozio online si comporta in modo anomalo dopo un aggiornamento del tema o dell’app.
Questa pagina ti è stata utile?
Grazie per il feedback! Dicci cosa mancava
Segnala un problema