Blog

Como codificar símbolos para exibi-los literalmente em HTML

Converta operadores de comparação e sinais de e comercial com a ferramenta de entidades HTML. As capturas mostram como codificar, decodificar e salvar o resultado e quando observar o escape duplo.

A interface em inglês mostra uma expressão de comparação ao lado de suas entidades HTML.
O exemplo usa a interface em inglês. Os controles ficam no mesmo lugar neste idioma.

Imagine que você queira mostrar 5 > 3 && 2 < 4 em uma explicação em HTML. O caractere < também abre uma tag. Para mostrar o sinal de menor como texto, escreva &lt; no código-fonte.

O codificador e decodificador de entidades HTML exibe a entrada e o resultado lado a lado. A conversão é feita no navegador e a entrada não é enviada a um servidor.

Codifique uma expressão de comparação

  1. Abra a ferramenta e digite 5 > 3 && 2 < 4 em Texto de entrada. O exemplo 1 insere a mesma expressão.
  2. Selecione Codificar e deixe o formato de saída padrão, Nomeadas.
  3. Com Conversão automática (atraso de 200 ms) ativo, o resultado é atualizado após a digitação. Se a opção estiver desativada, clique em Executar conversão.

O resultado é 5 &gt; 3 &amp;&amp; 2 &lt; 4. Os dois sinais & viram duas referências &amp; consecutivas.

Na interface em inglês, Input text mostra a expressão e Output text mostra as referências gt, amp e lt.
Escolha Encode e compare a entrada e a saída para ver quais caracteres foram substituídos.

Os cinco caracteres básicos são &, <, >, aspas duplas e aspas simples. É possível converter caracteres fora de ASCII em referências numéricas ou adicionar outros caracteres. Neste exemplo, mantenha as opções atuais.

Decodifique o resultado e confira o texto original

  1. Clique em Trocar entrada/saída.
  2. Mude para Decodificar. Trocar o conteúdo dos campos não altera o modo.
  3. Veja se a saída voltou a ser 5 > 3 && 2 < 4. Se a conversão automática estiver desativada, clique novamente em Executar conversão.
Na interface em inglês, as referências de entidades aparecem na entrada e a expressão recuperada aparece na saída.
O modo Decode converte as referências do exemplo em caracteres legíveis.

Use Copiar saída para copiar para a área de transferência ou Baixar saída para salvar como texto UTF-8. Se as permissões do navegador bloquearem a cópia, selecione o texto de saída e copie manualmente.

Verifique como o destino trata o resultado

Se a entrada já contém &amp;, decida o que mostrar ao leitor. Para exibir &, ative Detectar entidades pré-codificadas e evitar recodificação e preserve &amp;. Para exibir literalmente a escrita &amp;, converta também o & inicial. Nesse caso, o HTML fonte terá &amp;amp;.

Se o modelo já aplica escape automaticamente, converter antes à mão pode transformar o mesmo caractere duas vezes. URLs, JavaScript e JSON têm convenções próprias. Use o escape apropriado para o destino.

O decodificador carrega a entrada em um elemento HTML temporário e extrai o texto. Enviar um documento inteiro com tags não recupera a marcação original. Se tiver dúvidas sobre a aparência no destino, teste antes com um texto curto.