xmltree — u_pbt_xmltree #

← Komponentenreferenz · Inhalt des Handbuchs

xmltree zeigt einen XML-Wert als einklappbaren Baum, farbcodiert: ein Konfigurationsbildschirm, eine API-Antwort, ein Integrations-Debug. Sie setzen den XML-Text in is_xml, die Komponente zeigt ihn; ein Klick auf einen Knoten meldet seinen Pfad (ue_node_clicked), ungültiges XML löst ue_error aus. Sie ändert nichts: sie ist ein BETRACHTER.

▶ Live sehen — Demoanwendung, Kachel XML tree, mit dem Code und dieser Seite nebeneinander.

Auf einen Blick #

Schnellstart #

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

Eigenschaften #

Methoden #

Ereignisse #

Beispiel #

Eine API-Antwort erkunden #

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

Den Wert eines angeklickten Knotens lesen #

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

Ganze Wörter suchen, Groß-/Kleinschreibung beachtet #

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

Bewährte Praxis #

• Es ist ein Betrachter, kein Editor: er zeigt das XML, er ändert es nicht. Um einen Wert zu lesen, übergeben Sie den Pfad aus ue_node_clicked an n_pbt_xml.of_get_value auf demselben Text, oder lesen Sie of_selected_value.
• Ein großes XML bleibt flüssig: nur die Zeilen auf dem Bildschirm werden gezeichnet, ein Export von mehreren tausend Zeilen lässt sich ohne Wartezeit mit der Tastatur durchlaufen. Zuerst of_collapse_all bleibt am lesbarsten.
• Ungültiges XML bricht nichts: ue_error sagt es (mit Zeile und Spalte des Fehlers, in der Anzeigesprache), und der Baum zeigt die Quelle um die fehlerhafte Zeile. Das ist die zu zeigende Rückmeldung, kein Absturz.
• Ein Standard-Namensraum (xmlns="urn:…", eine SOAP-Antwort): der Pfad wird *[local-name()='Body'] geschrieben, die einzige Form, die ein XPath ohne registriertes Präfix lesen kann; ein mit anderer URI erneut deklariertes Präfix oder ein gleichnamiges Geschwister in einem anderen Namensraum wird *[local-name()='x' and namespace-uri()='urn:…'] geschrieben. @xml:lang wird unverändert gelesen. Eine xmlns-Deklaration wird angezeigt, hat aber keinen Pfad: XPath sieht sie nicht als Attribut.
• Was angezeigt wird, ist XML: ein Attributwert behält seine Anführungszeichen und seine kodierten Zeilenumbrüche (
), ein Text seine & und < und seine bedeutsamen Leerzeichen; nur die Layout-Zeilenumbrüche um einen Text entfallen.
• Mit der Tastatur: die Pfeile gehen von Zeile zu Zeile, Pfeil rechts durchläuft die Attribute eines Tags, bevor er absteigt, Bild ab springt um einen Bildschirm (ein CDATA-Abschnitt von dreihundert Zeilen zählt mit seiner Höhe), Strg+C kopiert das XML der Auswahl.
• Von rechts nach links: ein XML-Dokument ist ein Text von links nach rechts, der Baum bleibt so in einer RTL-Anwendung (nur das Suchfeld folgt der Richtung der Anwendung).

Vom gemeinsamen Sockel geerbt #

Diese Mitglieder gibt es bei jeder visuellen Komponente — sie sind nicht dieser eigen. Sie werden einmal in den übergreifenden Kapiteln beschrieben; diese Tabelle sagt nur, wo man sie liest.

← Komponentenreferenz · Inhalt des Handbuchs