Como corrigir o erro do Mobile Menu no Astra Pro
O que é o Astra mobile menu que não funciona?
O Astra mobile menu que não funciona e a falha em que o icone de hamburguer some no celular ou aparece mas não abre o painel de navegação. No Astra Pro o menu mobile e montado pelo Header Builder: a largura definida em Header Breakpoint decide a partir de quantos pixels o menu desktop colapsa para o icone de hamburguer, e o componente Off Canvas, posicionado na linha Mobile Header, e o painel que desliza quando o Toggle Button e tocado. Quando o Off Canvas não esta na linha mobile, quando o breakpoint esta mal calibrado ou quando o JavaScript do Astra e combinado pelo cache, o toque no hamburguer não tem efeito e a navegação fica inacessivel no smartphone.
Como identificar
- No celular, o icone de hamburguer aparece no cabeçalho mas, ao tocar, o painel de navegação não desliza e nada acontece.
- O icone de hamburguer nem aparece no mobile: o menu continua na horizontal cortado, ou some por inteiro abaixo de uma certa largura de tela.
- O Toggle Button abre um painel vazio, sem nenhum item de menu, porque o componente Off Canvas esta sem o menu atribuido.
- No console do navegador (F12) surge um erro de JavaScript do tipo ‘astra is not defined’ ou ‘Uncaught TypeError’ logo ao tocar no hamburguer.
- O menu mobile funciona no preview do Customizer, mas para de abrir no site publicado depois que o cache ou a otimização de JS e ativada.
Como prevenir
- Mantenha o tema Astra e o Astra Pro sempre atualizados para preservar o Mobile Header e o Off Canvas do Header Builder
- Sempre que configurar o cache, exclua os scripts do Astra da combinacao e do delay de JavaScript desde o inicio
- Depois de qualquer ajuste no menu, teste o hamburguer em um celular real e no modo responsivo do navegador antes de publicar
- Confirme que ha um menu atribuido ao local Off Canvas em Aparencia -> Menus toda vez que criar um novo menu
Causa
- Componente Off Canvas ausente da linha Mobile Header no Header Builder do Astra, deixando o Toggle Button sem painel para acionar quando o icone de hamburguer e tocado.
- Header Breakpoint definido abaixo da largura do dispositivo em Aparencia -> Personalizar -> Header Builder -> Mobile Header, fazendo o menu nunca colapsar para o hamburguer em tablets e celulares maiores.
- Combinacao ou minificacao do JavaScript do Astra pelo plugin de cache (WP Rocket, LiteSpeed, W3 Total Cache) removendo o script que liga o Toggle Button ao Off Canvas.
- Menu não atribuido ao componente Off Canvas: o painel mobile abre vazio porque nenhum local de menu foi vinculado ao Off Canvas em Aparencia -> Menus.
- Tema Astra ou complemento Astra Pro desatualizados, em versão anterior a que separou o Mobile Header do desktop no Header Builder, gerando o menu mobile antigo sem o Off Canvas.
- Erro de JavaScript de outro plugin interrompendo a fila de scripts antes do astra-theme-js carregar, o que impede o handler do hamburguer de ser registrado na página.
Como resolver
- Adicione o componente Off Canvas a linha Mobile Header: abra o Header Builder do Astra e confira a linha do cabeçalho mobile. O Off Canvas e o painel que desliza no celular e precisa estar posicionado junto ao Toggle Button, senao o hamburguer não tem o que abrir.
Aparencia -> Personalizar -> Header Builder -> aba Mobile Arraste o componente Off Canvas para a linha Mobile Header, ao lado do Toggle Button - Atribua o menu ao Off Canvas e ao local mobile: garanta que existe um menu vinculado ao painel mobile. Sem um menu atribuido ao local do Off Canvas, o painel desliza vazio mesmo com o Toggle funcionando.
Aparencia -> Menus -> aba Gerenciar locais Vincular o menu desejado ao local Off Canvas / Mobile Menu - Calibre o Header Breakpoint: ajuste a largura em que o menu desktop vira hamburguer. Se o breakpoint estiver baixo demais, tablets e celulares grandes nunca recebem o icone de hamburguer e ficam com o menu desktop cortado.
Aparencia -> Personalizar -> Header Builder -> Mobile Header -> Header Breakpoint Defina um valor próximo de 921 px para cobrir tablets e celulares - Exclua o JavaScript do Astra da combinacao do cache: no plugin de cache, exclua os scripts do Astra da combinacao e do adiamento (delay) de JavaScript, limpe o cache do site e do CDN e recarregue sem cache do navegador. A combinacao agressiva quebra o handler do Toggle Button.
No plugin de cache: excluir astra-theme-js e /astra-addon/ da combinacao e do delay de JS Limpar cache do site + cache do CDN/Cloudflare Recarregar com Ctrl+F5 (sem cache do navegador) - Atualize o Astra e isole conflito de JS: atualize o tema Astra e o Astra Pro para a versão mais recente e abra o console do navegador para checar erros de JavaScript de outros plugins. Um erro anterior na fila de scripts impede o handler do hamburguer de registrar.
Painel -> Atualizações -> atualizar Astra e Astra Pro Abrir F12 -> aba Console -> tocar no hamburguer e ler o primeiro erro em vermelho
/* Forca o painel Off Canvas do Astra a ficar visivel quando um CSS de tema/plugin o ocultou apos o toque no Toggle Button. Cole em Aparencia > Personalizar > CSS adicional. */
.ast-mobile-popup-drawer.active .ast-mobile-popup-inner {
transform: none !important;
visibility: visible !important;
opacity: 1;
}
.ast-header-break-point .main-header-menu-toggle {
display: flex !important;
}














