Pular para o conteúdo
Instalar app
Português (Brasil)

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>.

EventodetailDisparado 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?

Relatar um problema