Ao modernizar um site clássico do SharePoint, o menu de navegação frequentemente para de funcionar corretamente. Links desaparecem, nós personalizados não carregam ou toda a barra de navegação fica em branco. Isso acontece porque a interface moderna usa um mecanismo de navegação diferente da experiência clássica. Este artigo explica por que a navegação quebra durante a modernização e fornece soluções específicas para restaurar e estabilizar sua estrutura de menu.
Principais Conclusões: Navegação de Site Clássico Após Modernização
- Navegação estrutural vs. navegação gerenciada: A navegação estrutural de sites clássicos não é compatível com páginas modernas e deve ser substituída.
- Central de administração do SharePoint > Configurações > Configurações de site clássico: A opção de ativar navegação estrutural em páginas modernas está disponível, mas é limitada.
- Comando PowerShell Set-SPOModernNavigation: Use para forçar um tipo específico de navegação em uma coleção de sites.
- Scripts personalizados e links JavaScript: Eles param de funcionar após a modernização porque a interface moderna os bloqueia por padrão.
Por que a Modernização Quebra a Navegação Clássica
Sites clássicos do SharePoint usam navegação estrutural, que exibe subsites e páginas em uma árvore hierárquica. A experiência moderna usa navegação de hub e estilos de megamenu que dependem de uma estrutura plana no nível da coleção de sites. Ao aplicar um modelo moderno a um site clássico, o SharePoint tenta converter a navegação antiga, mas a conversão é incompleta. A interface moderna lê a navegação de uma fonte de dados diferente: o repositório de termos de navegação do SharePoint Online, em vez das configurações de navegação do estilo SharePoint Server do site.
Três causas específicas levam à quebra da navegação:
Navegação Estrutural Não é Compatível
Sites clássicos frequentemente usam navegação estrutural para exibir subsites em uma lista suspensa. Páginas modernas não suportam esse modo de exibição. Se seu site clássico dependia de navegação estrutural, o menu aparecerá vazio ou incompleto após a mudança para um modelo moderno.
Links de Script Personalizado São Bloqueados
Muitos sites clássicos adicionam JavaScript ou CSS personalizado por meio das configurações de navegação. O SharePoint moderno bloqueia scripts personalizados por padrão por motivos de segurança. Qualquer link que aponte para um arquivo de script ou uma URL externa com um manipulador de script será quebrado.
Alterações no Repositório de Termos Não São Aplicadas Automaticamente
A navegação moderna é orientada pelo repositório de termos na central de administração do SharePoint. Ao modernizar um site, os nós de navegação existentes não são migrados automaticamente para o repositório de termos. Você precisa recriar manualmente a hierarquia de navegação no repositório de termos ou usar o PowerShell para movê-la.
Passos para Restaurar a Navegação Após a Modernização
Siga estes passos em ordem para corrigir a navegação que quebrou durante a modernização do site.
- Verifique o tipo de navegação atual
Vá em Configurações do Site > Navegação. Se a página exibir uma mensagem como “Navegação estrutural não é compatível com páginas modernas”, você tem uma estrutura de navegação clássica. Observe se ela usa navegação estrutural ou gerenciada. - Mude para navegação gerenciada, se necessário
Se seu site usa navegação estrutural, você precisa convertê-la para navegação gerenciada. Na central de administração do SharePoint, vá em Conteúdo > Repositório de termos. Crie um novo grupo de termos para a navegação do seu site. Adicione termos e subtermos que correspondam à sua estrutura de menu antiga. Depois, no site, vá em Configurações do Site > Navegação e selecione Navegação Gerenciada. Aponte a navegação para seu novo conjunto de termos. - Ative a navegação moderna via PowerShell
Abra o SharePoint Online Management Shell. Execute o comandoSet-SPOModernNavigation -SiteUrl "https://suaempresa.sharepoint.com/sites/seosite" -NavigationType "Hub". Isso força o site a usar navegação de hub. Se preferir o estilo megamenu, use"Megamenu"em vez disso. Este passo garante que o site leia do repositório de termos. - Readicione links personalizados como links simples
Se sua navegação clássica incluía links personalizados para sites externos ou páginas internas, adicione-os novamente no editor de navegação moderna. Vá em Configurações do Site > Navegação. Em Navegação Gerenciada, clique em Adicionar Link. Insira a URL e o texto de exibição. Não adicione JavaScript ou referências a scripts. - Teste a navegação em vários dispositivos
Abra o site em uma janela anônima do navegador. Clique em cada item do menu para verificar se ele vai para a página correta. Verifique se a visualização móvel mostra um menu hambúrguer com todos os links. Se algum link estiver faltando, volte ao repositório de termos e verifique se o termo está publicado e a URL está correta.
Se a Navegação Ainda Tiver Problemas Após a Correção Principal
Alguns problemas de navegação exigem passos adicionais além da conversão básica. Os seguintes problemas são comuns após a modernização do site.
Navegação Mostra Apenas o Nome do Site e Nenhum Link
Isso geralmente significa que a navegação do repositório de termos está configurada, mas o site ainda está usando navegação estrutural. Execute o comando PowerShell Get-SPOModernNavigation -SiteUrl "https://suaempresa.sharepoint.com/sites/seosite" para ver o tipo de navegação atual. Se retornar “Structural”, execute o comando Set novamente com o tipo de navegação correto.
Links de Subsites Desaparecem Após a Modernização
A navegação moderna não inclui automaticamente subsites. Você deve adicionar cada subsite como um termo no repositório de termos. Crie um termo para cada subsite e defina a URL para o endereço do subsite. Depois, publique o grupo de termos. Os links dos subsites aparecerão após o cache do site ser atualizado, o que pode levar até 15 minutos.
CSS Personalizado para Navegação Para de Funcionar
O SharePoint moderno não carrega arquivos CSS personalizados que foram referenciados nas configurações de navegação clássica. Para aplicar estilos personalizados, use o recurso de temas modernos do SharePoint. Vá em Configurações do Site > Alterar a Aparência. Selecione um tema que corresponda à sua marca. Para CSS avançado, crie uma extensão do SharePoint Framework que injete estilos personalizados no componente de navegação moderna.
Links de Navegação Apontam para Páginas Erradas
Isso ocorre quando a URL no repositório de termos está desatualizada. Abra o repositório de termos na central de administração do SharePoint. Encontre o termo com a URL errada. Edite o termo e atualize a URL. Clique em Salvar e depois em Publicar. A alteração entra em vigor imediatamente para a maioria dos usuários, mas alguns podem precisar limpar o cache do navegador.
| Item | Navegação Clássica | Navegação Moderna |
|---|---|---|
| Mecanismo de navegação | Estrutural (subsites hierárquicos) | Repositório de termos (plano ou baseado em hub) |
| Suporte a script personalizado | Permite JavaScript e CSS na navegação | Bloqueia scripts personalizados por padrão |
| Exibição de subsites | Automática com navegação estrutural | Manual via entradas no repositório de termos |
| Renderização móvel | Menu completo no celular | Menu hambúrguer com os mesmos links |
| Interface de administração | Configurações do Site > Navegação | Repositório de termos + PowerShell |
Agora você pode restaurar a navegação em qualquer site clássico modernizado, mudando para navegação gerenciada e reconstruindo o menu no repositório de termos. Verifique primeiro o tipo de navegação do seu site com o comando PowerShell Get-SPOModernNavigation. Se você tiver muitos sites, considere usar um site de hub para compartilhar uma única estrutura de navegação em todos os sites modernizados. O recurso de navegação de hub sincroniza automaticamente e reduz a necessidade de editar o conjunto de termos de cada site individualmente.