Como visualizar e verificar texto HTML com source e preview

Introduza o HTML e escolha source para consultar a representação escapada ou preview para receber o conteúdo fornecido juntamente com essa representação. Nos pedidos com HTML não vazio, veja também as contagens de caracteres e de segmentos separados por mudanças de linha.

Para que serve a consulta

O HTML Viewer permite consultar texto HTML através de duas representações: source fornece a versão escapada do conteúdo não vazio, enquanto preview reúne o HTML recebido e a respetiva versão escapada. A resposta inclui também contagens relacionadas com o texto enviado, o que ajuda a comparar a entrada com o resultado apresentado.

O campo HTML é opcional e assume um valor vazio quando não é preenchido. Nesse caso, o pedido é tratado com conteúdo vazio e não segue o processamento específico destinado a uma entrada não vazia. O modo também é opcional: quando não indicar uma opção, é aplicado source.

Esta consulta é útil quando precisa de observar as marcas HTML como texto ou de comparar o conteúdo recebido com a sua representação escapada. O nome preview deve ser entendido como uma combinação de formas textuais na resposta, não como uma página visual apresentada ao utilizador.

Como fazer a consulta

1. Separe o trecho HTML que pretende consultar. Pode trabalhar com um parágrafo, várias etiquetas ou um texto distribuído por várias linhas, consoante a comparação que deseja fazer.

2. Introduza esse conteúdo no campo HTML. Se o deixar vazio, o pedido continua a ser tratado com sucesso e o resultado contém conteúdo vazio; essa situação não corresponde ao processamento de HTML não vazio.

3. Selecione source quando quiser consultar a representação escapada do texto fornecido. Esta escolha permite observar as marcas HTML dentro da resposta como uma forma textual distinta.

4. Escolha preview quando precisar de receber, em conjunto, o conteúdo que introduziu e a representação escapada correspondente. Mantenha presente que as duas partes são formas textuais devolvidas na resposta.

5. Se não selecionar um modo, envie o pedido sem essa indicação para utilizar source por predefinição. Esta escolha automática do modo não altera o tratamento separado de uma entrada HTML vazia.

6. Envie o pedido e localize a representação adequada ao modo escolhido. Em source, procure a versão escapada; em preview, distinga o HTML fornecido da versão escapada que o acompanha.

7. Para uma entrada não vazia processada em source ou preview, consulte também o número de caracteres e o número de segmentos separados por mudanças de linha. Compare essas medidas com a organização do texto que submeteu.

8. Para comparar os modos, conserve o mesmo HTML e repita o pedido alternando entre source e preview. Assim, consegue observar a diferença entre uma resposta com a representação escapada e outra com ambas as formas.

9. Utilize apenas source ou preview como valor do modo. Se escolher outra opção, receberá uma resposta de erro; reveja a seleção antes de repetir a consulta.

O que significa o resultado

Ao ler uma resposta source para HTML não vazio, procure a representação escapada do conteúdo submetido. Ela conserva uma forma textual das marcas, permitindo distingui-las do restante da resposta sem as tratar como elementos de uma página.

Uma resposta preview contém duas referências ao mesmo envio: o HTML fornecido e a sua representação escapada. A comparação entre ambas ajuda a verificar a correspondência textual da entrada, mas não permite concluir que tenha sido criada uma apresentação visual do documento.

As contagens apresentadas em pedidos não vazios referem-se ao texto HTML recebido. Uma contagem indica o número de caracteres e a outra indica o número de segmentos separados por mudanças de linha, pelo que a segunda depende da forma como organizou o conteúdo introduzido.

Quando a entrada fica vazia, leia o resultado como conteúdo vazio, e não como uma consulta de source ou preview sobre um documento. Se aparecer um erro depois de indicar um modo, confirme primeiro o valor escolhido, porque uma opção diferente das duas suportadas conduz a esse tipo de resposta.

Exemplo prático

Uma pessoa quer confirmar como um parágrafo HTML surge nas duas representações antes de comparar os resultados.

Introduza <p>Olá</p> e consulte primeiro source; repita depois com preview, mantendo o mesmo conteúdo para comparar as formas textuais.

Para <p>Olá</p>, source apresenta uma representação escapada e contagens de caracteres e segmentos; preview acrescenta o HTML fornecido à resposta.

Limitações

• O resultado limita-se a representações textuais e contagens; preview não confirma apresentação visual, e os modos suportados são source e preview.

Erros comuns

• Escolher outro modo: uma opção diferente de source ou preview produz uma resposta de erro. Selecione um dos modos suportados e repita o pedido.

Perguntas frequentes

O modo preview apresenta o HTML como uma página?

Quando seleciona preview, a resposta reúne o HTML fornecido e a representação escapada correspondente. Esse resultado textual não confirma que o conteúdo seja apresentado como uma página.

Tenho de inserir HTML para utilizar a ferramenta?

Não é necessário preencher o campo: o HTML é opcional e uma entrada vazia é tratada com conteúdo vazio, sem o processamento destinado a texto não vazio.

Que modos posso selecionar?

Se não indicar um modo, é utilizado source; também pode selecionar preview. Uma opção diferente dessas duas produz uma resposta de erro.