jsontree — u_pbt_jsontree #

← Riferimento dei componenti · Sommario della guida

jsontree mostra un valore JSON come un albero comprimibile, colorato per tipo: una schermata di configurazione, una risposta API, un debug di integrazione. Imposti il testo JSON in is_json, il componente lo mostra; un clic su un nodo riporta il suo percorso (ue_node_clicked), un JSON non valido solleva ue_error. Non modifica nulla: è un VISUALIZZATORE.

▶ Vederlo dal vivo — Applicazione dimostrativa, tessera JSON tree, con il codice e questa pagina fianco a fianco.

In breve #

Avvio rapido #

// 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

Proprietà #

Metodi #

Eventi #

Esempio #

Esplorare una risposta 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

Leggere il valore di un nodo cliccato #

// Instance variable of the window : the response, parsed ONCE by n_pbt_json
n_pbt_json inv_doc

// When the response arrives : the tree shows it, n_pbt_json parses the same text once
uo_json.is_json = inv_rest.of_response_text()
inv_doc.of_load(/*json*/ inv_rest.of_response_text())

// ue_node_clicked of uo_json : the value at the clicked path, nothing parsed again
st_value.text = inv_doc.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()

Cercare parole intere, maiuscole comprese #

// 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")

Mantenere le pieghe quando la risposta viene aggiornata #

// Local variables
string ls_layout

// The folds, the selected node and the line at the top, kept before the new text
ls_layout = uo_json.of_get_layout()
uo_json.is_json = inv_rest.of_response_text()

// The same blocks fold again ; a path the new text no longer has is ignored
uo_json.of_set_layout(/*layout_json*/ ls_layout)

Un menu su un nodo #

// ue_node_rclicked of uo_json : the node is selected, open YOUR menu at that point of the screen
uo_menu.of_show(/*x*/ al_x, /*y*/ al_y)

// ue_item_selected of uo_menu : copy the value, or the path for n_pbt_json
choose case as_keys
	case "copy"
		uo_json.of_copy()
	case "copypath"
		uo_json.of_copy_path()
end choose

Buone pratiche #

• È un visualizzatore, non un editor: mostra il JSON, non lo cambia. Per leggere un valore, passate il percorso di ue_node_clicked a n_pbt_json.of_get_string sullo stesso testo, oppure leggete of_selected_text.
• Un JSON grande resta fluido: si disegnano solo le righe sullo schermo, una risposta di diverse centinaia di KB si percorre da tastiera senza attese. of_collapse_all per primo resta il più leggibile.
• Un JSON non valido non rompe nulla: ue_error lo dice (con la riga e la colonna dell'errore), l'albero resta vuoto. È il riscontro da mostrare, non un crash.
• Ogni chiave ha un percorso: un / o un ~ vi si scrive ~1 o ~0 (JSON Pointer), e n_pbt_json lo legge così — paths/~1users~1{id} per una specifica OpenAPI. Una chiave VUOTA è un livello vuoto (a//b, / per quella alla radice). Un'eccezione, che of_selected_addressable segnala: ciò che sta sotto la seconda di due chiavi identiche (il percorso designa la prima).
• Da destra a sinistra: un documento JSON è un testo da sinistra a destra, e l'albero lo resta in un'applicazione RTL (solo la casella di ricerca segue il verso dell'applicazione).
• La tastiera resta all'albero: Invio piega un blocco o «clicca» una foglia (ue_node_clicked), mai il pulsante predefinito della finestra; Esc chiude prima la casella di ricerca aperta, poi torna alla finestra; le righe di chiusura (}, ]) non sono posizioni della selezione; Ctrl+C copia la selezione (of_copy), o il pezzo di testo evidenziato col mouse; Spazio piega un blocco e non fa mai scorrere la vista; il tasto Menu (Maiusc+F10) solleva ue_node_rclicked.
• Documenti molto grandi: oltre 1.500.000 righe il documento è rifiutato con ue_error invece di essere troncato in silenzio. La stampa (of_print, of_print_to_pdf) produce ciò che è aperto, fino a 10.000 righe: un blocco piegato si stampa piegato (prima of_expand_all, per stampare tutto).

Ereditato dalla base comune #

Questi membri esistono su tutti i componenti visivi — non sono propri di questo. Sono descritti una sola volta, nei capitoli trasversali; questa tabella dice solo dove leggerli.

← Riferimento dei componenti · Sommario della guida