Convertir JSON a lista HTML ul/li: reglas y errores

Contenido
Cuando toca pasar los datos de un array JSON a etiquetas de lista <ul> u <ol>, el tiempo se pierde no por desconocer la sintaxis, sino porque la forma de procesar cada elemento cambia según si el ítem del array es una cadena o un objeto. A medida que crece el número de elementos, también es habitual equivocarse: abrir y cerrar etiquetas <li> una por una acaba dejando una etiqueta sin cerrar o un valor mal copiado. Este artículo explica, solo con hechos verificables, con qué regla exacta cada elemento de un array JSON se convierte en el texto de un <li> y hasta cómo reproducir esa regla con tu propio código.
Resumen ① Los elementos que son cadenas se convierten en texto tal cual; de los elementos que son objetos se extrae el valor del «Nombre de clave del objeto» indicado, y si esa clave no existe, el objeto completo se sustituye por su cadena JSON. ② Las etiquetas que envuelven el resultado dependen de si eliges ul u ol, y los valores introducidos en «Clase de li» y «Clase de ul/ol» se añaden tal cual al atributo class de todos los li y de la etiqueta exterior, respectivamente. ③ Un JSON con comillas simples o comas finales da un error de análisis, y si en lugar de un array pegas un objeto completo aparece el error «El valor de entrada debe ser un array (Array) en formato JSON».
Cuándo necesitas esta conversión
Los datos que devuelve una API o los que exportas de una hoja de cálculo suelen estar en forma de array JSON. Para pegar una lista de títulos de avisos o de nombres de productos en una página HTML estática o en el cuerpo de un CMS, tienes que envolver cada elemento en <li>...</li> y agrupar todo en <ul> o <ol>.
Con tres o cuatro elementos, poner las etiquetas a mano se termina rápido; con decenas, ya no. Y si te falta una etiqueta o cierras en el lugar equivocado, el navegador lo renderiza con indulgencia, así que el problema no salta a la vista: lo descubres más tarde, cuando se rompe el estilo.
Cuando los elementos del array son objetos, hay un paso más. En un array de objetos como { "name": "manzana", "price": 1200 }, para sacar solo el nombre del producto y convertirlo en li tienes que decidir cada vez de qué clave tomas el valor y copiar únicamente ese valor.
Cómo convertir a mano, sin herramienta
Esta conversión se puede reproducir tal cual en unas pocas líneas desde la consola de las herramientas de desarrollo del navegador. El orden es el siguiente.
Paso 1 — Comprueba la sintaxis JSON. Escribe JSON.parse(textoOriginal) en la consola y ejecútalo. Si devuelve un valor sin error, la sintaxis es correcta; si aparece un error, significa que hay notaciones que se salen del estándar JSON, como comillas simples o comas finales.
Paso 2 — Comprueba que sea un array. Fíjate en si Array.isArray(resultado) es true. Si es false, has pegado un objeto completo entre llaves, y en ese caso tienes que seleccionar aparte solo la parte del array que te interesa.
Crear el texto de cada li y envolver el resultado final
Paso 3 — Crea el texto del li para cada elemento. El código siguiente aplica las mismas reglas que esta herramienta.
const toLiText = (item, key) => {
if (typeof item === "object" && item !== null) {
return item[key] !== undefined ? String(item[key]) : JSON.stringify(item);
}
return String(item);
};
const items = parsed.map((item) => `<li>${toLiText(item, "name")}</li>`);
Paso 4 — Envuelve con la etiqueta exterior. Decide si usas ul u ol y, si lo necesitas, añade un nombre de clase.
const html = `<ul class="my-list">\n ${items.join("\n ")}\n</ul>`;
Si sigues estos cuatro pasos tal cual, puedes obtener el mismo resultado a mano, sin herramienta. Eso sí, cuanto más crece el número de elementos, más engorroso resulta escribir el código y ejecutarlo en la consola.
Compruébalo con nuestra herramienta.
Convierte tu matriz JSON en marcado HTML ul/li u ol/li directamente en el navegador, sin instalar nada ni registrarte.

Errores de entrada más frecuentes
Al usar esta herramienta hay varias situaciones que se repiten. Todas son comportamientos verificables que se explican por la sintaxis JSON o por las reglas de conversión descritas arriba.
| Situación | Ejemplo de entrada | Resultado |
|---|---|---|
| Uso de comillas simples | ['manzana','plátano'] | Error de sintaxis en JSON.parse; la conversión falla |
| Coma final | ["manzana","plátano",] | Error de sintaxis en JSON.parse; la conversión falla |
| Pegar un objeto completo en lugar de un array | {"name":"manzana"} | Error «El valor de entrada debe ser un array (Array) en formato JSON.» |
| Nombre de clave del objeto mal escrito | El campo real es name y escribes title | En lugar del valor indicado, en el li se muestra el objeto completo como cadena JSON |
La primera y la segunda situación tienen que ver con el estándar JSON. JSON solo admite comillas dobles para las cadenas y no permite una coma después del último elemento de un array o de un objeto. Si pegas tal cual las comillas simples o las comas finales que se usan habitualmente en el código JavaScript, se incumple esa regla y el análisis falla desde el principio.
La tercera situación aparece cuando confundes un array con un objeto. Si la respuesta de la API es un objeto que envuelve el array, como { "items": [...] }, no pegues también las llaves exteriores: introduce solo la parte del array, la que empieza con el corchete.
La cuarta es un punto que se presta a malentendidos. Es fácil suponer que, si escribes mal el nombre de la clave, en el resultado aparecerá la palabra «undefined»; sin embargo, cuando la clave no existe, esta herramienta pone en el li el objeto completo convertido en cadena JSON en lugar del valor. Así que si dentro del li ves la forma original del objeto, eso mismo es la señal de que el nombre de la clave está mal.
En resumen
- Si el elemento del array es una cadena, ese valor pasa tal cual; si es un objeto, el texto del li es el valor del «Nombre de clave del objeto» que indiques.
- Si el objeto no tiene esa clave, en el li entra el objeto completo como cadena JSON en lugar del valor. Si ves la forma original del objeto y no «undefined», es señal de que tienes que revisar el nombre de la clave.
- La elección de ul/ol y los nombres de clase que introduzcas se reflejan tal cual en la etiqueta exterior y en el atributo class del marcado resultante.
- Las comillas simples y las comas finales se salen del estándar JSON y producen un error de análisis; si pegas un objeto completo en lugar de un array, aparece un mensaje de error específico.
- Aunque cambies los valores de entrada, el resultado no se actualiza solo: tienes que pulsar el botón «Convertir a lista HTML» para que se refleje.
Convierte tu matriz JSON en marcado HTML ul/li u ol/li directamente en el navegador, sin instalar nada ni registrarte.
Preguntas frecuentes
Si el array solo contiene cadenas, ¿también tengo que rellenar el nombre de clave del objeto?
No. Si los elementos son valores primitivos, como cadenas o números, el valor se convierte en texto tal cual y pasa a ser el texto del li, independientemente de lo que pongas en el campo del nombre de clave del objeto. El nombre de clave del objeto solo se aplica cuando los elementos son objetos.
¿Puedo generar ul y ol a la vez?
En cada conversión, la etiqueta exterior del resultado es solo una: la ul o la ol que elijas en «Tipo de lista». Si necesitas las dos formas, tienes que cambiar el tipo y volver a convertir.
¿La clase de li y la clase de ul/ol se configuran por separado?
Sí, los dos campos se aplican en lugares distintos. El valor que escribas en «Clase de li» se añade al atributo class de todas las etiquetas li, y el de «Clase de ul/ol» se añade solo a la etiqueta ul u ol exterior.
¿El resultado cambia en cuanto modifico los valores de entrada?
No, no cambia al momento. El análisis, la conversión y el renderizado en pantalla solo se ejecutan cuando pulsas el botón «Convertir a lista HTML». Después de editar los valores tienes que volver a pulsar el botón para que se reflejen en el resultado.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano