Skip to main content

​
Visão geral

Se a página da sua loja fica impossível de rolar depois de fechar o Upcart, provavelmente a causa é a lógica do seu tema que bloqueia a rolagem da página quando um cart drawer está aberto. Além disso, o Upcart agora oferece configurações integradas para resolver esses problemas, como sobrescrever a lógica de bloqueio de rolagem existente. Você pode corrigir isso usando as configurações integradas do Upcart ou adicionando uma pequena personalização para remover o comportamento de bloqueio de rolagem.
Como corrigir

​
Usando as soluções integradas

Na maioria dos casos, as opções integradas nas configurações do Upcart podem resolver os problemas de rolagem sem precisar de código personalizado.
  1. Ative “Override existing scroll locking logic”:
    • Abra o Cart Editor nas configurações do Upcart.
    • Acesse Settings → Cart settings e expanda Advanced Settings.
    • Ative Override existing scroll locking logic. A descrição dela cobre exatamente este caso: um tema ou app de terceiros deixando a página com a rolagem bloqueada depois que o carrinho fecha.
    Não existe uma configuração separada de rolagem para celular ou overlay — essa única opção cobre ambos.
Siga estas etapas para aplicar uma personalização que restaura a rolagem da página depois que o carrinho fecha.

​
Acessando as configurações de Custom HTML

  1. Abra o app Upcart no painel da Shopify.
  2. Acesse o Cart Editor.
  3. Abra Settings e selecione a aba Custom HTML. Settings é uma fileira de abas — se você não vir Custom HTML, ela está atrás de More settings.

​
Adicionando o código

  1. Para casos avançados ou específicos em que as soluções integradas não resolvem o problema, você pode aplicar código HTML personalizado no Upcart. Escolha onde aplicar o código HTML no Upcart. Para esta correção, selecione a seção Above Announcements/Rewards.
  2. Adicione o seguinte trecho de código:
Nota sobre versões antigas: os callbacks window.upcartOnCartOpened e window.upcartOnCartClosed ainda funcionam, mas estão obsoletos e registram avisos no console. Use upcartSubscribeCartOpened e upcartSubscribeCartClosed em todos os scripts novos.
  1. Salve as alterações.
  2. Atualize sua loja e teste fechar o carrinho para confirmar que a rolagem foi restaurada.

​
Por que isso acontece

Quando o Upcart abre, ele oculta o cart drawer nativo da sua loja e assume o espaço visual dele. No entanto, alguns temas incluem código que bloqueia a rolagem da página sempre que um drawer está ativo. Depois que o Upcart fecha, esse bloqueio pode permanecer ativo, impedindo a rolagem da página. Em dispositivos móveis, podem ocorrer problemas adicionais, como overlays que persistem ou fazem a página ficar inclicável. Esses problemas costumam estar ligados a comportamentos de bloqueio de rolagem específicos de celular ou a overlays não redefinidos. O script acima restaura o comportamento normal de rolagem redefinindo manualmente a propriedade overflow da página quando o carrinho é aberto ou fechado.
Precisa de ajuda ou de mais solução de problemas

​
Etapas adicionais antes de contatar o suporte

  1. Verifique se Override existing scroll locking logic está ativado.
  2. Confira se código personalizado ou scripts de terceiros podem estar interferindo.
Se você ainda tiver problemas de rolagem depois de aplicar a correção, seu tema pode usar um seletor diferente ou uma lógica de rolagem personalizada. Entre em contato com o suporte do Upcart para ajuda na identificação do seletor correto, ou fale com o desenvolvedor do seu tema para ajustar as configurações de rolagem do tema.