next up previous contents index
Next: Funktionen zum Erstellen von Up: Modulprogrammierung Previous: Der Eintrag 'prepare_function' im

HTML-Schnittstelle

Die Grundlagen für das Erzeugen von HTML-Code im System werden in der Bibliothek ´lib-html.inc.php´ gelegt. Im folgenden wird diese Library kurz ´lib-html´ genannt.

Die in ´lib-html´ enthaltenen Funktionen produzieren alle HTML-Code, d.h. sie liefern in aller Regel als Rückgabe einen String, der den erstellten HTML-Code enthält. Will der Benutzer der jeweiligen Funktion das Ergebnis dann tatsächlich auf der Standardausgabe darstellen, so muss er dies selbst noch tun - z.B. mit dem php-internen Befehl ´echo´ . In vielen Fällen wird er aber den HTML-Code erst durch mehrere Funktionsaufrufe in lib-html erst in einem oder mehreren Strings zusammenstellen, um diese Strings später weiterzuverarbeiten. Beispielsweise könnte man in einem String eine Schablone für einen bestimmten HTML-Code (z.B. für ein Formular) erstellen, in die erst später tatsächlich Werte aus der Datenbank eingesetzt werden. Daher liefern i.a. die Funktionen aus ´lib-html´ alle nur Strings zurück und machen selbst keine Ausgabe aus stdout.

Die Bibliothek ist so angelegt, das sie den gesamten für das System notwendigen HTML-Code vollständig selbst produziert, d.h. die ´libhtml´-Funktionen erzeugen alle HTML-Tags und derren korrekte Verschachtelung. Dies gilt nicht nur für Tabellen und Formulare, sondern ´libhtml´ kann auch zum Erstellen von weniger komplizierten HTML-Konstrukten, wie Links, Images, Überschriften, etc. verwendet werden. Der Benutzer muss selbst keinen HTML-Code erstellen, d.h. v.a. keine HTML-Tags selbst benutzen, geschweige denn auf derren Verschachtelung achten. Im Workflowsystem wird i.a. stets eingehalten, d.h. HTML-Code wird (fast) nur ´libhtml´-Funktionen produziert, und HTML-Tags nie außerhalb, direkt verwendet. Es steht jedoch jedem Benutzer, d.h. z.B. jemandem, der ein neues Workflowmodul erstellt, frei, in seinem Programm-Code selbst direkt HTML-Code zu verwenden. Dies gilt natürlich vor allem falls HTML-Konstrukte verwendet werden sollen, die ´libhtml´ nicht kennt. Gerade bei komplexeren Formularen und Tabellen sind die Funktionen aus ´libhtml´ aber auf alle Fälle zu empfehlen.

Alle von ´libhtml´-Funktionen erstellten HTML-Tags werden - konform zum XHTML-Standart - klein geschrieben.

Unter HTML-Encoding wird im folgenden die für HTML übliche Kodierung von Sonderzeichen (z.B. ``<'' als ``&gt;'') und Umlauten, etc. verstanden. Mit URL-Encoding ist die für Parameterübergaben per URL übliche Kodierung von Zeichen gemeint (z.B. `` `` als ``%20 ``).

Die Funktionen von ´libhtml´ lassen sich in die Bereiche Tabellenerzeugung, Formularerzeugung, Erzeugung von sonstigen HTML-Konstrukten, Erstellen von Parameter-Array-übergaben per Link oder Form, Ersetzen von Variablenwerten und Debugmeldungs-Generierung einteilen. Das Ersetzen von Variablenwerten findet vor allem Anwendung bei Tabellen und Formularen.

Im folgenden wird auf die einzelnen Bereiche genauer eingegangen.

Die Namen der ´libhtml´-Funktionen beginnen immer mit ´html_´.



 
next up previous contents index
Next: Funktionen zum Erstellen von Up: Modulprogrammierung Previous: Der Eintrag 'prepare_function' im
Copyright Munich Network Management Team