Aller au contenu
Installer l’app
Français

Événements

Les cinq événements déclenchés par l’app sur la boutique en ligne, chacun avec un exemple complet.

L’app déclenche ces événements sur document : écoutez-les donc avec document.addEventListener. Placez le code dans une ressource du thème, ou dans theme.liquid au-dessus de </body>.

ÉvénementdetailDéclenché lorsque
gpoRenderCompleted{ form, product }Les options ont fini de s’afficher
gpoElementChanged{}Le client a modifié une option
gpoProductPriceUpdated{}Le prix affiché a été recalculé
gpoValidated{ success }La validation a eu lieu lors de l’ajout au panier
gpoAddedToCart{}L’article et ses suppléments ont été ajoutés au panier

gpoRenderCompleted

Déclenché une fois que les champs d’option existent dans le DOM. C’est sur celui-ci qu’il faut s’appuyer. L’app effectue son rendu de manière asynchrone : le code qui s’exécute sur DOMContentLoaded s’exécute donc avant que les options n’existent et ne trouve rien.

detail contient form, le formulaire produit dans lequel les options ont été affichées, et product, le produit pour lequel elles ont été affichées.

document.addEventListener('gpoRenderCompleted', function (event) {
const { form, product } = event.detail;
if (!form) return; // aucun ensemble d’options ne s’applique à ce produit
// Vous pouvez maintenant interroger les champs d’option en toute sécurité
form.querySelectorAll('.gpo-form__group').forEach(function (group) {
group.classList.add('my-theme-option');
});
});

Il se déclenche à nouveau chaque fois que les options sont réaffichées — après un changement de variante sur les thèmes qui réaffichent le produit, ou après un appel à GPOConfigs.initialize(). Écrivez le gestionnaire de sorte qu’une double exécution soit sans conséquence.

gpoElementChanged

Déclenché chaque fois que le client modifie une option : saisie dans un champ, choix d’un échantillon, case cochée.

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() === '';
});

Il se déclenche à chaque frappe dans un champ de texte : appliquez donc un délai (debounce) à toute opération coûteuse — une requête réseau, une mise en page lourde.

gpoProductPriceUpdated

Déclenché après que l’app a réécrit le prix affiché pour y inclure les options choisies par le client. Utilisez-le pour synchroniser votre propre affichage de prix — une barre fixe, un bloc récapitulatif, une estimation de paiement en plusieurs fois.

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

Le prix affiché sur la page est un aperçu. Le montant réellement facturé au client est appliqué par Shopify au moment du paiement : ne considérez donc jamais ce chiffre comme le montant final. Consultez Application de la tarification.

gpoValidated

Déclenché lorsque le client tente d’ajouter au panier et que l’app a vérifié les options. detail.success vaut false en cas de problème — une option obligatoire vide, une limite de caractères dépassée, un nombre de sélections insuffisant.

document.addEventListener('gpoValidated', function (event) {
if (event.detail.success) return;
// L’ajout au panier a été bloqué
if (window.analytics) {
window.analytics.track('Option validation failed', {
product: window.GPOConfigs?.product?.handle
});
}
});

L’app fait déjà défiler la page jusqu’à la première erreur lorsque Défilement automatique jusqu’au premier message d’erreur est activé : inutile donc de le faire vous-même. Consultez Comportement du widget.

gpoAddedToCart

Déclenché après l’ajout de l’article et des éventuels produits suppléments. C’est à ce moment que le panier a réellement changé, ce qui en fait le bon endroit pour l’ouverture du panier et les analyses.

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 supplément associé à un produit constitue sa propre ligne de panier : un seul ajout au panier peut donc ajouter plusieurs lignes. Relisez le panier plutôt que de supposer qu’un seul article a été ajouté. Consultez Fusionner le produit principal et les suppléments.

Remarques

  • Les cinq nécessitent que l’intégration d’application soit activée. Sans elle, l’app ne s’exécute jamais et rien n’est déclenché.
  • Les événements ne transmettent aucune donnée client au-delà de ce qui figure déjà sur la page. Lisez window.GPOConfigs pour le produit, le panier et le client.
  • Le code que vous associez ici est à votre charge, et c’est la première chose à vérifier lorsque la boutique en ligne se comporte mal après une mise à jour du thème ou de l’app.

Cette page vous a-t-elle aidé ?

Signaler un problème