Link para um texto específico da página: gerador

O que é um text fragment

Um text fragment é um link que abre uma página e pula direto para uma frase dentro dela, destacando a correspondência. Não é preciso que a página tenha uma âncora ali, nem que a página seja sua: o alvo são as próprias palavras. Ele é escrito dentro do fragmento normal da URL, depois de um delimitador de três caracteres, então parece um link comum com um rabicho no fim.

Isso importa porque a alternativa é mandar alguém abrir um artigo longo e procurar uma frase. O text fragment faz isso por ele, e é por isso que os navegadores adicionaram um comando de copiar link para o trecho destacado, e por isso a mesma sintaxe aparece em resultados de busca que te deixam no parágrafo certo em vez do topo da página.

Esta página monta um a partir do texto que você quer destacar, e desmonta outro no sentido inverso. As duas metades importam, porque a sintaxe tem duas arestas que produzem em silêncio um link apontando para outro lugar.

Como usar

1. Informe a URL da página e o texto. Copie a frase exatamente como aparece na página, com a pontuação. O resto é opcional: um termo final transforma em intervalo, e os dois campos de contexto desambiguam uma frase que aparece mais de uma vez.
2. Copie o link. Se o seu texto tiver um caractere que a sintaxe reserva, a ferramenta mostra também o que o codificador comum do JavaScript teria produzido e o que aquela versão significa de fato — raramente a mesma coisa.
3. Ou cole um link para analisar. O analisador mostra cada diretiva encontrada e, separadamente, a URL que a página de destino recebe, que não é a que você colou.

A parte que a página de destino não enxerga

A diretiva é separada do resto do fragmento por três caracteres: dois-pontos, til e dois-pontos de novo. Esse delimitador existe para a sintaxe poder ser acrescentada às URLs sem quebrar páginas que já usam o fragmento para os próprios fins, e tem uma segunda consequência fácil de passar batido.

A norma é explícita: a diretiva é removida das APIs que uma página consegue alcançar, para impedir que ela interaja com o script do autor. Então a página para onde você aponta nunca vê a frase que você usou. O código dela, ao ler a URL atual, recebe tudo até o delimitador e nada depois. A seção que descreve o mecanismo é intitulada justamente em torno de esconder a diretiva do script.

É uma decisão de privacidade deliberada — um link contendo a frase que alguém estava lendo diz mais do que um link para uma página — e é também o que permite o formato crescer. Como as páginas não conseguem observar diretivas, os navegadores podem definir novas sem quebrar nada, e por isso uma diretiva desconhecida é permitida em vez de ser erro. O analisador aqui as mostra como desconhecidas em vez de rejeitá-las.

O caractere que o codificador óbvio erra

O texto de um fragmento precisa ser codificado por porcentagem, e a norma nomeia três caracteres que devem ser escapados dentro de um parâmetro de texto: o hífen, o e comercial e a vírgula. Eles têm significado na sintaxe, então um literal muda o que o link diz.

O codificador padrão do JavaScript escapa dois desses três. Ele deixa o hífen em paz, porque em qualquer outro ponto de uma URL o hífen é um caractere perfeitamente comum — e é exatamente o que a sintaxe usa para marcar os termos de contexto. Um prefixo se escreve como texto, hífen e vírgula; um sufixo, como vírgula, hífen e texto. Ou seja, hífen colado em vírgula é estrutura.

A consequência é um link que funciona, abre a página, destaca a coisa errada e não dá sinal nenhum de que algo deu errado. Peça um intervalo do bem-conhecido- até problema, codifique do jeito habitual, e o resultado se lê como prefixo do bem-conhecido seguido de início problema: outros termos, outra correspondência, nenhum erro. A ferramenta mostra as duas versões lado a lado sempre que o seu texto puder disparar isso, e cala quando não pode — a maioria dos textos não contém nenhum dos três caracteres e codifica igual dos dois jeitos.

Quem já montou um link mailto vai reconhecer o formato disso. Aquele formato também parece uma query string e também trata um caractere de modo diferente do codificador que todo mundo usa.

Limitações honestas

Esta ferramenta não consegue dizer se o texto está mesmo na página. Ela não tem como buscar o destino — um navegador não deixa um site ler o conteúdo de outro — então monta um link correto pela sintaxe e não diz nada sobre encontrar correspondência. Se a frase mudou desde que você copiou, o navegador abre a página normalmente e não rola para lugar nenhum.

Também não promete que o navegador vai agir sobre ele. O suporte é verificado como a norma sugere, procurando a interface de diretiva de fragmento no documento, e essa resposta aparece acima para o navegador em que você está lendo. Além do suporte, os navegadores aplicam restrições próprias sobre quando um fragmento é honrado, e um link que funciona clicado de um lugar pode não fazer nada aberto de outro.

Por fim, a correspondência é sobre o texto renderizado, não sobre a marcação. O espaço em branco entre os termos de contexto e o alvo pode variar, o que deixa uma frase cruzar limites de elementos, mas uma frase partida por marcação bem no meio ainda pode não casar. Quando uma frase longa falha, um intervalo com início curto e fim curto costuma ser mais robusto do que um único termo de início muito longo.

Por que é grátis?

Montar um link é codificar por porcentagem algumas strings e juntá-las, e o seu navegador faz isso enquanto você digita. Nenhum servidor entra na história, então não há nada a medir nem conta a criar.

Nada é enviado. O texto que você digitar e qualquer URL que colar ficam nesta aba.