IS HTMLB TREE
Funktionalität
Dieses BSP-Element ordnet eine Reihe von Einträgen hierarchisch in Baumform an.
Eine hierarchische Darstellung von Daten findet man auf Web-Seiten häufig, z.B. bei Navigationsleisten, Menüstrukturen oder Indizes. Stellen Sie sich z.B. vor, Sie möchten ein umfangreiches Handbuch mit vielen Kapiteln, Abschnitten, Bildern und Tabellen präsentieren. Ein solches Dokument können Sie mit dem tree -Element strukturieren.
Zentrales Element des tree-Elements ist der Knoten. Ein Knoten kann ein 'Blatt' oder ein 'Ordner' sein. Ein Blatt stellt einzelne Informationen dar, z.B. eine URL, ein Buchtitel oder ein Dateiname, während ein Ordner weitere Knotenelemente enthält. Ein Baum definiert bestimmte Beziehungen zwischen seinen Knoten: Jeder Knoten hat einen einzelnen 'Eltern'knoten, d.h. ein Element auf der nächsthöheren Ebene in der Hierarchie. Ein Ordner hat 'Kind'knoten, d.h. eine Reihe von Knoten auf der nächsttieferen Ebene in der Hierarchie. Ein Knoten kann außerdem 'Geschwister' haben, die sich auf derselben Hierarchieebene befinden.
Jeder Knoten in einem tree-Element wird durch ein Element treeNode repräsentiert. Dieses Element bestimmt beispielsweise, welcher Textbezeichner als Knoteninhalt angezeigt werden sollund ob es sich bei dem Knoten um einen Ordner oder um ein Blatt handelt. Außerdem trägt jeder Knoten das Attribut id. Dabei handelt es sich um einen eindeutigen Namen, mit dem der Knoten in der Hierarchie identifiziert wird.
Das tree-Element zeigt ein komplexes visuelles Design und Verhalten. Klickt der Benutzer auf das Expandiersymbol eines Ordnerknotens, wird der entsprechende Teilbaum sichtbar. Das Umschalten des Zustands erfolgt lokal im Client-Browser. Wenn der Benutzer den Inhalt eines Knotens anklickt, d.h. den Textbezeichner oder das eventuell vorhandene Symbol, löst der Knoten das Ereignis onNodeClick aus.
Die innere Element-Struktur besteht aus treeNode-Elementen. Alternativ können Sie einen tree füllen, indem Sie eine Tabelle mit dem Typ TVIEW einsetzen.
Attribute
Name Obligatorisch Beschreibung
id x Eindeutiger Name, der das BSP-Element identifiziert. Dieses Attribut wird im Eventhandling und im Datenhandling verwendet.
title Mit diesem Attribut legen Sie den Titel für den Baum fest. Standardmäßig ist hierfür "Tree" festgelegt.
tooltip Mit diesem Attribut legen Sie den Text für die Quick-Info fest, der erscheint, wenn der Cursor über den Baum bewegt wird.
width Mit diesem Attribut legen Sie die Breite des Baums fest.
height Mit diesem Attribut legen Sie die Höhe des Baums fest.
table Mit diesem Attribut spezifizieren Sie die Tabelle, aus der die Werte für den Baum gezogen werden sollen. Diese Tabelle hat den Typ TVIEW (siehe Dicitionary).
onTreeClick Mit diesem Attribut setzen Sie den Eventhandler, der aufgerufen wird, wenn der Baum angeklickt wird.
toggle Mit diesem Attribut können Sie, sofern Ihr Browser dies unterstützt, das Auf- und Zuklappen des Baums Browser-seitig aktivieren, ohne dass auf den Server zugegriffen werden muss.
Beispiel
Siehe BSP-Applikation SBSPEXT_HTMLB, Seite treeExample.bsp
Ereignisbehandlung
Für dieses BSP-Element werden keine Events unterstützt.
Datenextraktion bei eingehenden Requests
Für dieses BSP-Element wird kein Datenhandling unterstützt.
Tipps und Tricks
Das tree-Element ist nicht für die Anzeige von Baumstrukturen mit Tausenden von Knoten und Blättern vorgesehen. Generell sollte ein Baum nie mehr als 30 bis 50 Einträge enthalten. Beachten Sie, dass die Größe Ihrer HTML-Seiten proportional zur Anzahl der Einträge wächst.
Netscape 4.x-Browser unterstützen nicht das lokale Umschalten der Sichtbarkeit von Knoten. Das tree -Element wird daher immer vollständig expandiert dargestellt.
Weiterführende Informationen
Die Dokumentation finden Sie auf dem SAP Help Portal (
http://help.sap.com/) unter SAP NetWeaver -> SAP Web Application Server . In der SAP-Bibliothek wählen Sie dann z.B. für SAP Web Application Server 6.20, Support Package 25, den Pfad: SAP-NetWeaver-Komponenten -> SAP Web Application Server -> Business Server Pages (BC-BSP) -> Web Application Server -> Web-Applikationen und Business Server Pages -> Programmiermodell -> BSP-Extensions.