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 #

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

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

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.
• Una chiave vuota o che contiene / non ha percorso: nemmeno n_pbt_json sa indirizzarla. Due chiavi identiche in uno stesso oggetto si mostrano entrambe; 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).
• 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 il documento intero, fino a 10.000 righe.

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