Como converter CSV numa tabela HTML

Para que serve

Este conversor transforma texto CSV fornecido por si numa tabela HTML. É útil quando já tem os dados em formato CSV e precisa de obter uma estrutura de tabela para integrar numa página ou inspeccionar o resultado gerado. Pode decidir se a primeira linha representa os títulos das colunas e definir a classe da tabela, em vez de ficar limitado ao valor predefinido.

O resultado é uma tabela HTML acompanhada das contagens de linhas e colunas identificadas. Essas contagens ajudam a verificar se a estrutura produzida corresponde à organização dos dados introduzidos.

Instruções passo a passo

1. Prepare o conteúdo CSV como texto. Inclua a primeira linha como cabeçalho se quiser que os nomes das colunas apareçam nas células de cabeçalho da tabela.
2. Cole o texto CSV no campo de entrada. Se o deixar vazio ou inserir apenas espaços em branco, o resultado será uma saída HTML vazia, com zero linhas e zero colunas.
3. Verifique a opção de tratamento da primeira linha. Esta opção começa activada: nesse estado, a primeira linha analisada é usada como cabeçalho e as restantes tornam-se linhas do corpo. Se a desactivar, todas as linhas são tratadas como linhas do corpo, sem células de cabeçalho.
4. Se necessário, altere a classe da tabela. Quando não indicar outra, é usada a classe csv-table. Escolha um valor adequado ao CSS que pretende aplicar à tabela.
5. Inicie a conversão e consulte o HTML produzido, bem como as contagens apresentadas. Compare-as com a estrutura que esperava a partir do texto fornecido.

Tenha em atenção que o número de colunas corresponde ao maior número de campos encontrado numa linha analisada. As linhas do corpo que tiverem menos campos recebem células vazias para acompanhar essa largura. Uma linha de cabeçalho mais curta não é preenchida da mesma forma. O texto das células e a classe fornecida são escapados para HTML antes de serem incluídos na tabela.

Como ler o resultado

Num CSV não vazio, a contagem de linhas exclui a primeira linha quando o tratamento de cabeçalho está activado. Com essa opção desactivada, todas as linhas analisadas entram na contagem do corpo. A contagem de colunas reflecte a linha com mais campos, não necessariamente a primeira linha.

Por isso, uma contagem inesperada pode resultar de linhas com comprimentos diferentes ou da escolha feita para a primeira linha. Uma linha curta do corpo será representada com células vazias adicionais, enquanto um cabeçalho curto não será completado. Se a entrada estiver vazia ou contiver apenas espaços, não haverá linhas nem colunas no HTML devolvido.

Também existe uma fronteira importante no tratamento de problemas: uma excepção ocorrida durante o processamento devolve um resultado indicado como bem-sucedido, mas com HTML vazio, zero linhas, zero colunas e um detalhe do erro. Assim, o estado indicado como bem-sucedido não basta, por si só, para confirmar que foi gerada uma tabela com dados.

Exemplo prático

Uma pessoa tem uma lista curta de produtos em CSV e precisa de a apresentar numa tabela HTML com nomes de colunas.

Cole um CSV com a primeira linha Produto,Preço,Stock e duas linhas de produtos, mantenha o tratamento de cabeçalho activado e converta o conteúdo.

O resultado tem uma tabela HTML com três células de cabeçalho e duas linhas no corpo, além das contagens correspondentes.

Limitações

• Linhas com comprimentos diferentes podem originar células vazias nas linhas do corpo, enquanto um cabeçalho curto não é preenchido; além disso, um problema durante o processamento pode devolver HTML vazio com um detalhe de erro.

Erros comuns

• A contagem de linhas não corresponde ao número de linhas coladas. Causa: a opção de cabeçalho está activa e a primeira linha é excluída da contagem do corpo. Acção: desactive esse tratamento quando a primeira linha também dever ser considerada uma linha de dados.

Perguntas frequentes

O que acontece se eu não introduzir CSV?

A entrada vazia produz HTML vazio e zero linhas e colunas. Este resultado ocorre antes do tratamento de excepções do processamento.

A primeira linha do CSV é usada como cabeçalho?

Com o tratamento de cabeçalho activado, a primeira linha analisada torna-se o cabeçalho e as restantes ficam no corpo. Se o desactivar, todas as linhas ficam no corpo, sem células de cabeçalho.

Posso personalizar a classe HTML da tabela?

A classe predefinida é csv-table, mas pode fornecer outra. O valor indicado é escapado para HTML antes de ser inserido na tabela.