Como descodificar entidades HTML em texto
Introduza texto HTML codificado, execute a descodificação e consulte os caracteres correspondentes no resultado. Sem uma entrada não vazia, a operação não devolve texto descodificado.
Para que serve a descodificação de entidades HTML
O HTML Decode transforma entidades HTML presentes num texto nos caracteres correspondentes. Uma entidade HTML é uma forma codificada de representar um caráter dentro de texto, como & para & ou < para <. Esta operação é útil quando o conteúdo que recebeu ou guardou ainda mostra essas sequências e pretende consultar o texto descodificado.
A ferramenta trabalha sobre o texto fornecido. Não confunda esta tarefa com a remoção de etiquetas HTML, a conversão de um documento HTML completo em texto simples ou a validação da estrutura de HTML. O objetivo é apenas descodificar as entidades que aparecem na entrada. Assim, deve selecionar um conteúdo textual concreto e observar como o resultado representa os caracteres correspondentes.
Como descodificar entidades HTML
- Abra o controlo de descodificação de HTML.
- No campo de texto, introduza o conteúdo que quer processar. A entrada pode conter texto HTML codificado, incluindo sequências como
&e<. Se estiver a trabalhar com uma mensagem, um excerto de dados ou uma cadeia copiada de outro local, reveja o conteúdo antes de o submeter para confirmar que não ficou vazio. - Confirme a operação de descodificação através do controlo disponível.
- Consulte o resultado apresentado. Quando existe texto não vazio e a descodificação é concluída, as entidades HTML presentes no texto são convertidas nos respetivos caracteres. O resultado deve ser lido como texto descodificado, não como uma limpeza geral de HTML.
- Compare, se necessário, a entrada com o resultado. Esta comparação ajuda a identificar quais as sequências que foram apresentadas na forma correspondente. Não é necessário alterar manualmente o restante texto que não fazia parte de uma entidade.
- Se a entrada estiver vazia, escreva primeiro algum conteúdo e repita a operação. Embora o texto seja opcional no contrato de entrada, o processamento requer uma entrada não vazia. Uma tentativa sem conteúdo não produz texto descodificado.
- Se a operação terminar sem êxito, reveja o conteúdo introduzido e tente novamente. Um resultado sem êxito também pode ocorrer se surgir uma exceção durante a descodificação; nesse caso, não trate a resposta como se fosse texto convertido.
A entrada deve ser o texto que pretende descodificar, e não uma instrução sobre o que fazer. Pode manter palavras, espaços e outros caracteres do conteúdo original enquanto fornece as sequências codificadas no mesmo campo. O passo decisivo é garantir que há texto para processar e, depois, interpretar o resultado como a conversão das entidades presentes nessa entrada.
Como interpretar o resultado
Num resultado bem-sucedido, o texto apresentado contém os caracteres correspondentes às entidades HTML que estavam na entrada. Por exemplo, uma sequência usada para representar & deixa de ser mostrada nessa forma codificada e passa a aparecer como o caráter correspondente. O restante conteúdo deve ser entendido no contexto do texto fornecido; a ferramenta não transforma a operação numa análise ou numa edição abrangente do documento.
Se o campo estiver vazio, não há texto descodificado para consultar: a operação termina sem êxito. Por isso, uma resposta sem texto convertido não confirma que o conteúdo original já estivesse descodificado. Verifique primeiro se introduziu uma entrada não vazia e repita o processamento.
Também deve separar dois casos. Uma entidade HTML pode ser convertida no caráter correspondente quando a descodificação é concluída. Já uma operação sem êxito, incluindo uma que termine devido a uma exceção durante a descodificação, não deve ser interpretada como uma conversão parcial ou como uma indicação sobre o conteúdo final.
A capacidade tem um limite claro: trata entidades HTML no texto fornecido. Não serve para retirar etiquetas, converter um documento HTML completo em texto simples, limpar marcação ou validar HTML. Se precisa de uma dessas tarefas, o resultado desta descodificação não responde por si só a essa necessidade. Use-o apenas para avaliar a representação descodificada do texto que submeteu.
Exemplo prático
Está a rever uma mensagem guardada com & e quer ver o caráter correspondente no texto apresentado.
Introduza A & B no campo de texto e confirme a operação de descodificação.
Um resultado bem-sucedido com o texto A & B, em que & foi convertido no caráter &.
Limitações
- A capacidade limita-se à descodificação de entidades HTML no texto fornecido; não abrange a remoção de etiquetas, a conversão de documentos HTML completos para texto simples nem a validação de HTML.
Erros comuns
- Introduzir um campo vazio e esperar texto convertido. Escreva algum conteúdo não vazio no campo e repita a operação; sem texto, o resultado termina sem êxito.
Perguntas frequentes
Posso executar a descodificação sem introduzir texto?
A entrada de texto é opcional no contrato, mas o processamento requer conteúdo não vazio. Se o campo estiver vazio, a operação termina sem êxito e não apresenta texto descodificado.
O que acontece às entidades HTML no texto?
Quando a operação é concluída com êxito, as entidades HTML presentes no texto fornecido são convertidas nos caracteres correspondentes. Por exemplo, & pode aparecer como & no resultado.
Esta ferramenta remove etiquetas HTML?
Não. A ferramenta descodifica entidades HTML no texto fornecido, mas não deve ser usada para remover etiquetas, converter documentos HTML completos em texto simples ou validar HTML.