jsontree — u_pbt_jsontree #

← Referencia de componentes · Índice de la guía

jsontree muestra un valor JSON como un árbol plegable, coloreado por tipo: una pantalla de configuración, una respuesta de API, una depuración de integración. Fija el texto JSON en is_json, el componente lo muestra; un clic en un nodo reporta su ruta (ue_node_clicked), un JSON inválido lanza ue_error. No modifica nada: es un VISOR.

▶ Verlo en vivo — Aplicación de demostración, mosaico JSON tree, con el código y esta página lado a lado.

De un vistazo #

Inicio rápido #

// Show an API response as a tree
uo_json.is_json = inv_rest.of_response_text()

// Fold everything, then let the user open what interests them
uo_json.of_collapse_all()

// ue_node_clicked : the path of the node clicked ("lines/1/sku"), the path of
// n_pbt_json -> of_get_string(as_path) on the same text reads its value

Propiedades #

Métodos #

Eventos #

Ejemplo #

Explorar la respuesta de una API #

// Fetch the order : the tree shows the response, or empties on a failure
if inv_rest.of_get(/*url*/ "https://api.example.com/orders/4152") = 200 then
	uo_json.is_json = inv_rest.of_response_text()
	uo_json.of_collapse_all()          // the reader opens what interests them
else
	uo_json.of_clear()
end if

Leer el valor de un nodo pulsado #

// ue_node_clicked of uo_json : the path is the one n_pbt_json reads
n_pbt_json lnv_json

// Read the value at the clicked path with n_pbt_json
lnv_json.of_load(/*json*/ uo_json.is_json)
st_value.text = lnv_json.of_get_string(/*path*/ as_path)

// or, without a second parser : the value of the selected leaf, decoded
st_value.text = uo_json.of_selected_text()

Buscar palabras completas, con mayúsculas #

// Whole words only, with the same case : "id" is not found inside "user_id"
uo_json.ib_find_match_case = true
uo_json.ib_find_whole_word = true
uo_json.of_search(/*query*/ "id")

Buenas prácticas #

• Es un visor, no un editor: muestra el JSON, no lo cambia. Para leer un valor, pase la ruta de ue_node_clicked a n_pbt_json.of_get_string sobre el mismo texto, o lea of_selected_text.
• Un JSON grande sigue fluido: solo se dibujan las líneas en pantalla, una respuesta de varios cientos de KB se recorre con el teclado sin esperas. of_collapse_all primero sigue siendo lo más legible.
• Un JSON inválido no rompe nada: ue_error lo dice (con la línea y la columna del error), el árbol queda vacío. Es la respuesta que mostrar, no un fallo.
• Una clave vacía o que contiene / no tiene ruta: n_pbt_json tampoco sabe direccionarla. Dos claves idénticas en un mismo objeto se muestran las dos; la ruta designa la primera.
• De derecha a izquierda: un documento JSON es un texto de izquierda a derecha, y el árbol lo sigue siendo en una aplicación RTL (solo el cuadro de búsqueda sigue el sentido de la aplicación).
• El teclado se queda en el árbol: Intro pliega un bloque o «hace clic» en una hoja (ue_node_clicked), nunca el botón por defecto de la ventana; Esc cierra primero el cuadro de búsqueda abierto y luego vuelve a la ventana; las líneas de cierre (}, ]) no son posiciones de la selección; Ctrl+C copia la selección (of_copy).
• Documentos muy grandes: por encima de 1.500.000 líneas el documento se rechaza con ue_error en lugar de cortarse en silencio. La impresión (of_print, of_print_to_pdf) saca el documento entero, hasta 10.000 líneas.

Heredado de la base común #

Estos miembros existen en todos los componentes visuales — no son propios de este. Se detallan una sola vez, en los capítulos transversales; esta tabla solo dice dónde leerlos.

← Referencia de componentes · Índice de la guía