Ao modernizar um site de equipe ou de publicação clássico do SharePoint, o menu de navegação pode parar de funcionar corretamente. Links desaparecem, o menu não expande ou nós de navegação personalizados são perdidos. Isso acontece porque o processo de modernização substitui a página mestra clássica e o provedor de navegação por um framework moderno do SharePoint que não carrega automaticamente as configurações de navegação personalizadas. Este artigo explica por que a navegação quebra durante a modernização de sites clássicos e o que os proprietários do site devem verificar para restaurar e preservar a navegação do site.
Principais Conclusões: O que Verificar Após a Modernização do Site Clássico
- Configurações de navegação do site em Configurações do Site > Elementos de Navegação: Após a modernização, você deve reativar a navegação estrutural e escolher qual tipo de navegação usar.
- Central de administração do SharePoint > Sites ativos > Coleção de sites > Navegação moderna: A configuração de navegação moderna em todo o locatário deve estar habilitada para que o site use o novo menu.
- Cmdlet do PowerShell Set-SPOHomeSite: Use para designar um site inicial e habilitar a barra de navegação global que aparece nos sites modernos.
Por que a Modernização do Site Clássico Remove a Navegação Personalizada
Os sites clássicos do SharePoint usam uma página mestra e um provedor de navegação no servidor que lê os nós de navegação do mapa do site ou da estrutura do portal. Ao modernizar um site, o SharePoint remove a página mestra clássica e muda para um mecanismo de renderização no cliente. O framework moderno não lê o XML de navegação antigo nem as configurações de navegação clássicas armazenadas nos recursos da coleção de sites. Como resultado, todos os links personalizados, cabeçalhos ou menus suspensos adicionados na interface clássica são perdidos.
O processo de modernização também altera o modelo do site. Um site de equipe clássico usa o modelo STS#0, enquanto um site de equipe moderno usa o STS#3. O novo modelo não ativa o recurso de Infraestrutura de Publicação do SharePoint Server, necessário para a navegação estrutural. Sem esse recurso, o site reverte para a navegação moderna padrão, que mostra apenas uma lista plana de páginas e bibliotecas de documentos.
Além disso, se o seu site era um site de publicação com navegação gerenciada baseada em um repositório de termos, a interface moderna não oferece suporte à navegação gerenciada. Você deve mudar para um método de navegação diferente ou usar a barra de navegação global fornecida pelo recurso de site inicial.
Etapas para Restaurar a Navegação Após a Modernização
- Verifique o modelo do site e os recursos
Vá em Configurações do Site > Recursos da coleção de sites. Confirme se o recurso de Publicação do SharePoint Server está ativo. Se não estiver, clique em Ativar. Esse recurso habilita as configurações de navegação estrutural na página de configurações de navegação. - Ative a navegação estrutural
Navegue até Configurações do Site > Elementos de Navegação. Em Navegação Global, selecione Navegação Estrutural: Exibir os itens de navegação abaixo do site atual. Em Navegação Atual, selecione Navegação Estrutural: Exibir o site atual, os itens de navegação abaixo do site atual e os sites irmãos do site atual. Clique em OK. - Recrie os nós de navegação personalizados
Vá em Configurações do Site > Navegação e selecione a guia Navegação Estrutural. Clique em Adicionar Cabeçalho ou Adicionar Link para recriar cada nó personalizado. Insira a URL, o título e a dica de ferramenta. Defina a opção de abrir em nova janela, se necessário. Clique em OK para cada nó. - Ative a navegação moderna na central de administração do SharePoint
Faça login na central de administração do SharePoint com uma conta de administrador do locatário. Expanda Políticas e selecione Coleções de sites. Encontre seu site e clique no nome dele. Na guia Configurações, role até Navegação moderna e defina como Ativado. Clique em Salvar. - Defina um site inicial para a navegação global
Abra o SharePoint Online Management Shell como administrador. Conecte-se ao SharePoint com Connect-SPOService -Url https://[locatario]-admin.sharepoint.com. Execute Set-SPOHomeSite -HomeSiteUrl https://[locatario].sharepoint.com/sites/seosite. Isso ativa a barra de navegação global exibida no topo de todos os sites modernos do locatário. - Teste a navegação em vários dispositivos
Abra o site em uma janela anônima do navegador. Clique em cada link de navegação para confirmar que abre a página correta. Verifique se os menus suspensos aparecem ao passar o mouse. Teste em um navegador móvel para garantir que o menu recolha corretamente.
Se a Navegação Ainda Tiver Problemas Após a Correção Principal
Nós de navegação aparecem, mas os links não funcionam
Isso geralmente acontece quando a URL no nó de navegação aponta para uma página que não existe mais ou usa uma URL absoluta com o domínio errado. Abra cada nó de navegação no modo de edição e verifique a URL. Para páginas internas, use uma URL relativa como /sites/seosite/SitePages/Home.aspx. Para links externos, use a URL completa com https://.
A navegação moderna está desabilitada na central de administração
A configuração de navegação moderna está disponível apenas para coleções de sites que usam um modelo moderno. Se o seu site ainda exibe o modelo clássico na central de administração, você deve concluir o processo de modernização primeiro. Use a ferramenta SharePoint Modernization Scanner para identificar e converter páginas clássicas restantes. Após a conversão, o modelo do site muda e a configuração de navegação moderna se torna editável.
A barra de navegação global não aparece
A barra de navegação global aparece apenas no site inicial e nos sites associados a ele. Execute Get-SPOHomeSite para confirmar a URL do site inicial. Se o comando não retornar resultado, execute Set-SPOHomeSite novamente com a URL correta. Confirme também que o site é um site de comunicação ou um site de equipe moderno. Sites clássicos não exibem a barra de navegação global.
Menus suspensos se sobrepõem ou aparecem cortados
Isso é um problema de CSS causado pelos estilos da página mestra clássica que permanecem no site. Limpe o cache da coleção de sites indo em Configurações do Site > Página mestra e clicando em Redefinir para a página mestra padrão. Em seguida, reaplique o tema moderno em Configurações do Site > Alterar a aparência. Isso remove o CSS clássico residual que interfere no layout da navegação moderna.
Navegação Clássica vs Navegação Moderna: Principais Diferenças
| Item | Navegação Clássica | Navegação Moderna |
|---|---|---|
| Provedor de navegação | Controle ASP.NET no servidor | SharePoint Framework (SPFx) no cliente |
| Tipos de navegação suportados | Estrutural, gerenciada (repositório de termos), baseada em metadados | Apenas estrutural (lista plana ou navegação de hub) |
| Cabeçalhos personalizados e menus suspensos | Suportado via página de Configurações de Navegação | Não suportado em menus modernos padrão |
| Barra de navegação global | Não disponível | Disponível quando um site inicial é definido |
| Responsividade móvel | Requer CSS personalizado | Menu hambúrguer responsivo integrado |
| Desempenho | Mais lento devido à renderização no servidor | Mais rápido com cache no cliente |
Após a modernização, você pode restaurar a navegação do seu site ativando a navegação estrutural e recriando os nós personalizados. Em seguida, defina um site inicial para ativar a barra de navegação global que conecta todos os sites modernos do seu locatário. Para personalização avançada, considere usar uma extensão do SharePoint Framework para criar um componente de navegação personalizado que corresponda exatamente ao seu layout clássico.