jsontree — u_pbt_jsontree #

← Referência dos componentes · Índice do guia

jsontree mostra um valor JSON como uma árvore recolhível, colorida por tipo: um ecrã de configuração, uma resposta de API, uma depuração de integração. Define o texto JSON em is_json, o componente mostra-o; um clique num nó reporta o seu caminho (ue_node_clicked), um JSON inválido levanta ue_error. Não modifica nada: é um VISUALIZADOR.

▶ Ver ao vivo — Aplicação de demonstração, mosaico JSON tree, com o código e esta página lado a lado.

Em resumo #

Início 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

Propriedades #

Métodos #

Eventos #

Exemplo #

Explorar a resposta de uma 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

Ler o valor de um nó clicado #

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

Pesquisar palavras inteiras, com maiú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")

Boas práticas #

• É um visualizador, não um editor: mostra o JSON, não o altera. Para ler um valor, passe o caminho de ue_node_clicked a n_pbt_json.of_get_string sobre o mesmo texto, ou leia of_selected_text.
• Um JSON grande continua fluido: só se desenham as linhas no ecrã, uma resposta de várias centenas de KB percorre-se com o teclado sem esperas. of_collapse_all primeiro continua a ser o mais legível.
• Um JSON inválido não parte nada: ue_error di-lo (com a linha e a coluna do erro), a árvore fica vazia. É a resposta a mostrar, não uma falha.
• Uma chave vazia ou que contenha / não tem caminho: n_pbt_json também não a sabe endereçar. Duas chaves idênticas num mesmo objeto mostram-se ambas; o caminho designa a primeira.
• Da direita para a esquerda: um documento JSON é um texto da esquerda para a direita, e a árvore continua assim numa aplicação RTL (só a caixa de pesquisa segue o sentido da aplicação).
• O teclado fica com a árvore: Enter dobra um bloco ou «clica» numa folha (ue_node_clicked), nunca o botão predefinido da janela; Esc fecha primeiro a caixa de pesquisa aberta, depois volta à janela; as linhas de fecho (}, ]) não são posições da seleção; Ctrl+C copia a seleção (of_copy).
• Documentos muito grandes: acima de 1 500 000 linhas o documento é recusado com ue_error em vez de cortado em silêncio. A impressão (of_print, of_print_to_pdf) produz o documento inteiro, até 10 000 linhas.

Herdado da base comum #

Estes membros existem em todos os componentes visuais — não são próprios deste. São detalhados uma só vez, nos capítulos transversais; esta tabela apenas diz onde os ler.

← Referência dos componentes · Índice do guia