xmltree — u_pbt_xmltree #

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

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

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

De un vistazo #

Inicio rápido #

// Show an XML response as a tree
uo_xml.is_xml = inv_rest.of_response_text()

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

// ue_node_clicked : the path of the node clicked, an XPath ("/order/lines/line[2]",
// "/order/@id" for an attribute) -> n_pbt_xml.of_get_value(as_path) reads its value

Propiedades #

Métodos #

Eventos #

Ejemplo #

Explorar la respuesta de una API #

// Show the XML an API answered, or nothing if the call failed
if inv_rest.of_get(/*url*/ "https://api.example.com/orders/4152") = 200 then
	uo_xml.is_xml = inv_rest.of_response_text()
	uo_xml.of_collapse_all()          // the reader opens what interests them
else
	uo_xml.of_clear()
end if

Leer el valor de un nodo pulsado #

// ue_node_clicked of uo_xml : the path is an XPath n_pbt_xml reads as it is
// (inv_xml is an n_pbt_xml created by the window, ipo_owner = the window)
inv_xml.of_load(/*xml*/ uo_xml.is_xml)
st_value.text = inv_xml.of_get_value(/*xpath*/ as_path)

// or, without a second parser : the value of the selection, decoded
st_value.text = uo_xml.of_selected_value()

Buscar palabras completas, con mayúsculas #

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

Buenas prácticas #

• Es un visor, no un editor: muestra el XML, no lo cambia. Para leer un valor, pase la ruta de ue_node_clicked a n_pbt_xml.of_get_value sobre el mismo texto, o lea of_selected_value.
• Un XML grande sigue fluido: solo se dibujan las líneas en pantalla, una exportación de varios miles de líneas se recorre con el teclado sin esperas. Primero of_collapse_all sigue siendo lo más legible.
• Un XML inválido no rompe nada: ue_error lo dice (con la línea y la columna del fallo, en el idioma de visualización), y el árbol muestra el origen alrededor de la línea errónea. Es el retorno a mostrar, no un fallo.
• Un espacio de nombres por defecto (xmlns="urn:…", una respuesta SOAP): la ruta se escribe *[local-name()='Body'], la única forma que un XPath sin prefijo registrado sabe leer; un prefijo redeclarado con otro URI, o un hermano del mismo nombre en otro espacio, se escribe *[local-name()='x' and namespace-uri()='urn:…']. @xml:lang se lee tal cual. Una declaración xmlns se muestra pero no tiene ruta: XPath no la ve como un atributo.
• Lo que se muestra es XML: el valor de un atributo conserva sus comillas y sus saltos de línea codificados (
), un texto sus & y < y sus espacios significativos; solo desaparecen los saltos de línea de maquetación alrededor de un texto.
• Con el teclado: las flechas pasan de línea en línea, Flecha derecha recorre los atributos de una etiqueta antes de bajar, Av Pág avanza una pantalla (una sección CDATA de trescientas líneas cuenta por su altura), Ctrl+C copia el XML de la selección.
• De derecha a izquierda: un documento XML es un texto de izquierda a derecha, el árbol sigue así en una aplicación RTL (solo el cuadro de búsqueda sigue la dirección de la aplicación).

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