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

PublicadoHerramientaConvertidor de Matriz JSON a Lista HTML

Contenido
  1. Cuándo necesitas esta conversión
  2. Cómo convertir a mano, sin herramienta
  3. Errores de entrada más frecuentes
  4. En resumen
  5. Preguntas frecuentes

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.

Convertidor de Matriz JSON a Lista HTML

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ónEjemplo de entradaResultado
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 escritoEl campo real es name y escribes titleEn 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.
Convertidor de Matriz JSON a Lista HTML

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

Artículos relacionados

  1. JSON inválido: cómo leer el error y repararlo automáticamentePor qué JSON.parse falla con comentarios, comas finales o claves sin comillas, cómo leer line y position en el error y qué hace la corrección automática.
  2. Escapar JSON en una línea: cómo convertir y pegar sin erroresPor qué el JSON se rompe al pegarlo en un argumento de CLI o en .env, qué escape sustituye cada carácter y cómo funcionan los modos JSON y Raw.
  3. Cómo aplanar JSON anidado: reglas de claves combinadasAprende cómo se combinan las claves anidadas (clave padre + separador + clave hija), por qué los arrays quedan intactos y qué falla al elegir separador.
  4. Convertir claves JSON de camelCase a snake_case: reglas y casosConvierte claves JSON a camelCase, snake_case, PascalCase o kebab-case: reglas, ejemplos y cómo aplicar el cambio en objetos y arrays anidados.
  5. Eliminar claves JSON: varias a la vez y en cualquier nivelAprende a borrar varias claves JSON a la vez y de forma recursiva: opción de mayúsculas, coincidencia exacta y resultado con un JSON no válido.
  6. Ordenar claves JSON alfabéticamente: qué cambia y qué noAl ordenar claves JSON solo cambia el orden de las propiedades; los arrays y los valores quedan igual. Mira cómo afectan la recursión y la indentación.

Herramientas relacionadas