Eventos
Os cinco eventos que o app dispara na loja virtual, cada um com um exemplo prático.
O app dispara estes eventos em document, então escute-os com document.addEventListener. Coloque o código em um arquivo do tema ou em theme.liquid, acima de </body>.
| Evento | detail | Disparado quando |
|---|---|---|
gpoRenderCompleted | { form, product } | As opções terminaram de ser renderizadas |
gpoElementChanged | {} | O cliente alterou uma opção |
gpoProductPriceUpdated | {} | O preço exibido foi recalculado |
gpoValidated | { success } | A validação foi executada ao adicionar ao carrinho |
gpoAddedToCart | {} | O item e seus complementos chegaram ao carrinho |
gpoRenderCompleted
Disparado assim que os campos das opções existem no DOM. É nele que você deve se basear. O app renderiza de forma assíncrona, então um código executado em DOMContentLoaded roda antes de as opções existirem e não encontra nada.
detail traz form, o formulário do produto em que as opções foram renderizadas, e product, o produto para o qual elas foram renderizadas.
document.addEventListener('gpoRenderCompleted', function (event) { const { form, product } = event.detail; if (!form) return; // nenhum conjunto de opções se aplica a este produto
// Agora é seguro consultar os campos das opções form.querySelectorAll('.gpo-form__group').forEach(function (group) { group.classList.add('my-theme-option'); });});Ele é disparado novamente sempre que as opções são renderizadas de novo — após uma mudança de variante em temas que renderizam o produto de novo, ou depois que você chama GPOConfigs.initialize(). Escreva o handler de forma que executá-lo duas vezes não cause problemas.
gpoElementChanged
Disparado sempre que o cliente altera uma opção: digitando em um campo, escolhendo uma amostra, marcando uma caixa de seleção.
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() === '';});Ele é disparado a cada tecla digitada em um campo de texto, então aplique debounce a qualquer coisa pesada — uma solicitação de rede, um novo cálculo de layout pesado.
gpoProductPriceUpdated
Disparado depois que o app reescreve o preço exibido para incluir as opções escolhidas pelo cliente. Use-o para manter a sua própria exibição de preço sincronizada — uma barra fixa, um bloco de resumo, uma estimativa de parcelamento.
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;});O preço mostrado na página é uma prévia. O valor realmente cobrado do cliente é aplicado pela Shopify no checkout, então nunca trate esse valor como o total final. Consulte Como os preços são aplicados.
gpoValidated
Disparado quando o cliente tenta adicionar ao carrinho e o app já verificou as opções. detail.success é false quando há algo errado — uma opção obrigatória vazia, um limite de caracteres excedido, poucas seleções.
document.addEventListener('gpoValidated', function (event) { if (event.detail.success) return;
// A adição ao carrinho foi bloqueada if (window.analytics) { window.analytics.track('Option validation failed', { product: window.GPOConfigs?.product?.handle }); }});O app já rola até o primeiro erro quando Rolar automaticamente para a primeira mensagem de erro está ativado, então não é preciso fazer isso por conta própria. Consulte Comportamento do widget.
gpoAddedToCart
Disparado depois que o item e todos os produtos complementares foram adicionados. É nesse momento que o carrinho realmente mudou, o que faz dele o lugar certo para abrir o carrinho e para análises.
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; });});Um complemento vinculado a um produto é uma linha própria do carrinho, então uma única adição ao carrinho pode adicionar várias linhas. Leia o carrinho de volta em vez de supor que um único item foi adicionado. Consulte Mesclar produto principal e complementos.
Observações
- Os cinco precisam da incorporação do app ativada. Sem ela, o app nunca é executado e nada é disparado.
- Os eventos não trazem nenhum dado do cliente além do que já está na página. Leia window.GPOConfigs para obter o produto, o carrinho e o cliente.
- O código que você anexa aqui fica sob sua responsabilidade e é a primeira coisa a verificar quando a loja virtual se comporta de forma estranha após uma atualização do tema ou do app.
Esta página foi útil?
Obrigado pelo feedback! Conte o que faltou
Relatar um problema