Como codificar entidades HTML em texto

Para que serve a codificação de entidades HTML

O HTML Encode serve para transformar caracteres especiais num texto em entidades HTML, uma etapa útil quando precisa de preparar texto para um contexto que reconhece essa representação. Para leitores em Portugal, a utilização é direta: introduza o conteúdo, peça a codificação e verifique o texto devolvido antes de o copiar para o seu fluxo de trabalho.

Como codificar o texto passo a passo

1. Prepare o texto de entrada. Cole ou escreva o conteúdo no campo de texto. Inclua os caracteres que pretende converter, como sinais de menor e maior ou o e comercial. O campo de texto é opcional e tem uma cadeia vazia como valor predefinido, mas a operação não é bem-sucedida se não fornecer texto.

2. Reveja o conteúdo. Confirme que o texto introduzido está completo e que não ficaram partes de fora. Esta verificação é especialmente importante quando cola excertos de HTML ou texto com vários símbolos reservados.

3. Execute a codificação. Selecione o controlo disponível para iniciar a operação. A ferramenta analisa o texto fornecido e tenta codificar os caracteres especiais como entidades HTML.

4. Copie o resultado devolvido. Quando a operação é bem-sucedida, é apresentado o texto codificado. Utilize esse resultado no local pretendido e mantenha o texto original separado para poder comparar as duas versões.

Como interpretar o resultado

O resultado deve ser lido como uma nova representação do texto, não como o texto original sem alterações. Por exemplo, os sinais de menor e maior passam a ser representados por < e >, enquanto o e comercial passa a ser representado por &. Assim, pode confirmar a operação procurando essas formas no resultado quando os caracteres correspondentes existiam na entrada.

Se nada for devolvido como resultado bem-sucedido, reveja primeiro se forneceu texto e se a entrada foi realmente submetida. Uma cadeia vazia não produz uma operação bem-sucedida. Se o resultado existir, compare-o com a entrada carácter a carácter: o conteúdo deve manter-se reconhecível, mas alguns caracteres especiais aparecem na forma de entidades.

A presença de entidades no resultado não significa, por si só, que o texto foi apresentado como HTML ou que ficou preparado para qualquer finalidade diferente da codificação. Use a saída de acordo com o contexto onde será inserida e confirme nesse contexto se a representação pretendida é a adequada.

Exemplo prático

Um programador precisa de representar um pequeno excerto de marcação como texto antes de o reutilizar noutro contexto.

Introduza <p>A & B</p> no campo de texto e execute a codificação.

O resultado bem-sucedido devolve o texto codificado, representando os sinais de menor e maior por < e >, e o e comercial por &.

Limitações

• A capacidade descrita limita-se à codificação de caracteres especiais como entidades HTML. O resultado não deve ser interpretado, por si só, como uma confirmação de descodificação, apresentação ou limpeza de HTML.

Erros comuns

• Submeter o campo vazio. Como o texto é opcional, pode parecer que é possível executar a operação sem conteúdo; nesse caso, o resultado não é bem-sucedido. Introduza o texto que pretende codificar e submeta-o novamente.

Perguntas frequentes

O que acontece se deixar o campo de texto vazio?

Se não fornecer texto, a operação não é bem-sucedida. Introduza conteúdo no campo de texto antes de executar a codificação.

Que forma assumem os caracteres especiais no resultado?

Quando a entrada contém sinais de menor e maior ou e comercial, o resultado representa-os como <, > e &, respetivamente.

A ferramenta descodifica ou apresenta HTML?

A capacidade descrita codifica caracteres especiais como entidades HTML e devolve o texto codificado quando a operação é bem-sucedida. Não trate essa saída como prova de que o conteúdo foi descodificado ou apresentado como HTML.