Como encontrar e corrigir links de âncora quebrados e fragmentos ausentes
Corrija links que carregam a página certa mas não chegam ao título, seção ou elemento previsto.
Sumário
O que é um link de âncora ou fragmento de URL?#
Um link de âncora usa um identificador de fragmento após # para indicar uma posição ou estado dentro do recurso. Em uma URL como /help/#installation, o caminho identifica o documento e o fragmento um alvo dentro dele.
Em um link convencional para seção HTML, o fragmento normalmente corresponde ao ID de um elemento. Se o documento carrega mas o alvo deixou de existir, o visitante pode ficar no topo ou chegar a um ponto inesperado. A resposta ainda pode ser bem-sucedida porque o documento existe.
Por que links de âncora quebram após editar conteúdo#
Muitos sistemas geram IDs a partir do texto dos títulos. Renomear «Instalação» para «Primeiros passos» pode mudar o fragmento gerado mesmo se o assunto continuar na mesma página. Reordenar ou duplicar títulos também pode alterar IDs automáticos.
Outros problemas vêm de copiar endereços incompletos, alterar pontuação ou colocar o alvo em conteúdo carregado só após interação. Um link funcionando na página aberta pode falhar quando alguém digita a URL diretamente em uma nova aba. Trate como condições diferentes e teste ambas.
| Sintoma | Verificação provável | Possível correção |
|---|---|---|
| A página abre no topo | O fragmento corresponde a um ID existente? | Atualize o fragmento ou restaure o ID antigo. |
| A seção errada recebe o foco | Há IDs duplicados ou gerados inesperadamente? | Dê ao alvo previsto um ID único e estável. |
| Funciona apenas após interação | O alvo é criado após carregar ou expandir o conteúdo? | Disponibilize um alvo estável ou melhore a navegação. |
| Links de um artigo antigo pararam de funcionar | O título ou endereço do documento mudou? | Atualize o link direto e preserve âncoras úteis de compatibilidade. |
Investigar uma âncora ausente#
Abra a URL completa de destino, incluindo o fragmento. Aguarde o documento carregar e confira se a seção prevista existe e se o navegador a alcança. Compare o fragmento com o ID exato usado pela página; não presuma que o texto visível do título e o ID gerado sejam idênticos.
Use Linky para identificar âncoras ausentes e confira manualmente o estado relevante. O inspetor de URLs e fragmentos deste site separa componentes do endereço colado, mas não acessa o destino nem prova que exista um elemento lá.
- Copie o link de origem completo, incluindo o fragmento.
- Abra em uma nova aba e espere terminar de carregar.
- Identifique o título ou elemento pretendido.
- Compare seu ID com o fragmento.
- Corrija origem ou alvo e teste de novo o percurso publicado.
Escolher IDs estáveis para conteúdo referenciado#
Na documentação frequentemente citada, escolha IDs estáveis que descrevam o assunto e sobrevivam a mudanças editoriais. O título visível pode melhorar sem quebrar todos os favoritos. Registre IDs importantes ao mover conteúdos entre sistemas.
Se uma âncora antiga tem muitas referências, considere preservar um alvo compatível perto da seção substituta. Evite IDs duplicados e interferências na acessibilidade. Se for inviável, atualize os links que controla e comunique o novo destino quando necessário.
Exemplo: renomear uma seção de configuração
Um título pode passar de «Instalação» para «Instalar Linky» mantendo id="installation". Referências existentes a /help/#installation podem continuar funcionando sem manter o título visível inalterado.
Exemplo: combinar dois documentos
Quando duas páginas viram uma, associe os fragmentos importantes às seções novas. Não confira apenas o redirecionamento da página; verifique se as referências diretas ainda chegam à informação prevista.
Fragmentos, roteamento e formatos especiais de links#
Nem todo fragmento é um simples ID. Alguns aplicativos usam fragmentos para roteamento no cliente ou estado da aplicação. Links para fragmentos de texto também identificam texto em vez de um elemento convencional. Identifique o formato antes de interpretar o resultado.
Se a aplicação depende de uma rota especial por fragmento, teste navegação direta e atualização. Para uma referência comum, prefira um destino estável que visitantes abram e compartilhem sem depender de estado anterior. Documente exceções na auditoria em vez de impor uma regra a todas as URLs.
Verificar links diretos em migrações e publicações#
Inclua fragmentos importantes na lista de migração junto dos caminhos. Navegação de documentação, sumários e notas de versão costumam conter links de seção. Uma migração de URLs pode parecer bem-sucedida enquanto deixa essas referências ineficazes.
Antes de publicar, teste links de outra página, não só o sumário local. Depois de publicar, verifique a página e referências diretas conhecidas. Mantenha assunto previsto, origem e novo alvo juntos no registro para que outro redator entenda a mudança.
- Confira IDs de títulos gerados após edições.
- Evite IDs duplicados no mesmo documento.
- Preserve alvos estáveis para seções compartilhadas frequentemente.
- Teste navegação direta para conteúdos carregados dinamicamente.
- Revise fragmentos ao mover ou combinar documentação.
Perguntas frequentes#
Uma âncora pode estar quebrada se a página retorna 200?
Sim. O servidor pode devolver corretamente uma página cujo alvo de fragmento está ausente. Confira separadamente a resposta do documento e a chegada à seção.
Devo usar o texto do título como fragmento?
Use o ID realmente exposto pela página publicada. Sistemas podem normalizar pontuação, acrescentar sufixos ou usar um ID personalizado diferente do título.
Um redirecionamento do servidor corrige todo problema de fragmento?
Não automaticamente. O navegador e o contexto da página controlam os fragmentos. Verifique o percurso completo, especialmente se documentos antigos e novos usam IDs diferentes.
Coloque este procedimento em prática
Leia a documentação relacionada do Linky para conhecer os comandos e limites usados neste artigo. Contatar o suporte se um resultado exigir investigação adicional.
Referências e leituras adicionais
Consulte estas fontes primárias sobre o comportamento dos mecanismos de busca. Os procedimentos e listas acima explicam como aplicar a auditoria à manutenção prática do site.
Encontre os links que precisam de correção
Instale a extensão Linky para examinar a página aberta ou auditar páginas acessíveis de um site. Revise destinos quebrados, âncoras ausentes e redirecionamentos e encontre a origem que precisa de correção.
Comece grátis. Comparar planos para auditorias repetidas, Estrutura do site e exportações.
