window.aftersell.cart.events.
Assinar é uma chamada de configuração, então é seguro no topo do seu script, sem precisar esperar por ready().
events.on(event, handler) registra um handler e retorna uma função que cancela a assinatura:
events.once(event, handler): dispara uma vez e cancela a si mesmo.events.off(event, handler): remove um handler específico.
Quase todo bug de evento tem origem em uma destas. Alterar o carrinho dentro de um handler de
cart_updated dispara cart_updated de novo. Se esse handler alterar o carrinho novamente, você tem um loop infinito. O comprador vê o carrinho oscilando enquanto a página martela o Shopify.
registerLineTransform.
Dispara uma vez, quando o carrinho carrega pela primeira vez na página. O payload é o objeto de carrinho completo.
cart_loaded é reproduzido para assinantes atrasados. Se você assinar depois que o carrinho já carregou, seu handler é chamado imediatamente com o carrinho atual. A ordem de assinatura nunca importa, então você não precisa se preocupar se o seu script chegou antes do carrinho.
Dispara toda vez que o conteúdo do carrinho muda após o primeiro carregamento, seja pelo drawer, pelas suas próprias ações, pelo tema ou por outro app. O payload é o objeto de carrinho completo.
{ item }, onde item é a linha do carrinho.
cart_loaded. Adicionar vários produtos distintos de uma vez dispara o evento uma vez por linha.
Dispara quando uma linha desaparece do carrinho. O payload é { item }, a linha como estava logo antes de sumir, então você ainda pode ler seu key, variantId e title.
item_added: reduzir uma quantidade sem chegar a zero não é uma remoção.
Disparam quando o drawer abre e fecha. Sem payload.
Todo evento também é despachado como um
CustomEvent do DOM em window, então você pode escutar sem tocar em window.aftersell.cart. Isso é útil em um arquivo de tema, um app de terceiros ou um script que carrega independentemente do carrinho.
Atenção à nomenclatura: o bus usa
snake_case, os eventos do DOM usam kebab-case atrás de um prefixo aftersell:cart:.
event.detail e corresponde ao objeto de carrinho. Os eventos são despachados em window, então um listener em qualquer lugar da página os recebe. O carrinho é renderizado em um shadow root, mas a fronteira do shadow nunca está no caminho do evento. Cada despacho clona o payload, então um listener que muta event.detail não afeta ninguém mais, e um listener que lança um erro não perturba o SDK.
Separadamente, o carrinho publica os eventos padrão de carrinho do Shopify em document sempre que altera o carrinho, para que o código do tema e outros apps possam reagir às mutações do Aftersell da mesma forma que reagem às do tema:
Cada evento também carrega uma
promise que o Aftersell resolve quando a escrita subjacente é concluída, seguindo o padrão do Shopify — aguarde-a, não a resolva você. Eles são despachados em document e propagam (bubble), então um listener em window também os recebe.
- Objeto de carrinho: o formato completo dos payloads acima.
- Ações: como alterar o carrinho a partir de um handler.
- Hooks: para mudar como o carrinho renderiza, em vez de reagir a ele.
- Casos de uso: rastreamento de analytics, brindes e outros exemplos completos.