html_table_head($cols = array(), $param = array()):

Mit dieser Funktion wird der HTML-Quelltext für den Kopf einer HTML-Tabelle, d.h. den Beginn der Tabelle (<table...>-Tag) und eine Kopfzeile, erzeugt. Die Parameter von ´html_table_head´ sind:

• [$cols:]Liste von Spaltennamen der Tabelle. Diese Bezeichner werden an anderer Stelle als Referenz benutzt. Die Reihenfolge in dieser Liste bestimmt die Reihenfolge der Spalten in der HTML-Tabelle (von links nach rechts).
• [$param:]assoziatives Array, das weitere Parameter für die Tabelle enthalten kann:
  • [border:]boolsches Flag, falls false, so erhält die Tabelle keinen Rand (border-Attribut im Table-Tag)
  • [bgcolor:]Hintergrundfarbe der Tabelle (bgcolor-Attribut im Table-Tag)
  • [bordercolor:]Farbe des Tabellenrandes (bordercolor-Attribut im Table-Tag)
  • [alignment:]Ausrichtung der Tabelle (align-Attribut im Table-Tag): right, left, top, bottom oder center
  • [width:]Weite der Tabelle (width-Attribut im Table-Tag), z.b. 50%
  • [cellpadding:]Randabstand vom Zelleninhalt zum Zellenrand (cellpadding-Attributes im Table-Tag)
  • [cellspacing:]Dicke der Gitternetzlinien (cellspacing-Attributes im Table-Tag)
  • [rules:]Wert des rules-Attributes im table-Tag ?, z.B none?
  • [caption_top:]mögliche obere Beschriftung der Tabelle (<caption align=top>...</caption>)
  • [caption_bottom:]mögliche untere Beschriftung der Tabelle (<caption align=bottom>...</caption>)
  • [caption_left:]mögliche linke Beschriftung der Tabelle (<caption align=left>...</caption>)
  • [caption_right:]mögliche rechte Beschriftung der Tabelle (<caption align=right>...</caption>)
  • [no_empty_headline:]boolsches Flag, falls 'true', wird eine Kopfzeile nicht erzeugt, falls $cols leer ist, d.h. eine leere Kopfzeile entstehen würde. Findet z.B. Anwendung, wenn ´html_table_head´ direkt aufgerufen wird.
  • [head_bgcolor:]Hintergrundfarbe der Kopfzeile (bgcolor-Attribut im tr-Tag)
  • [head_fgcolor:]Standart-Vordergrundfarbe der Kopfzeile (<font color=..>)
  • [head_valign:]valign-Ausrichtung der Kopfzeile (valign-Attribut im tr-Tag)
  • [headcell_bgcolor:]assoziatives Array, das für eine Spalte anhand ihres Namens aus $cols eine eigene Hintergrundfarbe festlegt (bgcolor-Attribut im th-Tag)
  • [headcell_fgcolor:]assoziatives Array, das für eine Spalte anhand ihres Namens aus $cols eine eigene Vordergrundfarbe festlegt (<font color=...>)
  • [headcell_format:]assoziatives Array, das für eine Spalte anhand ihres Namens aus $cols ein Ausgabe-Text festlegt, der Standart hierfür ist jeweils der Name der Spalte selbst
  • [headcell_param:]assoziatives Array, das für eine Spalte anhand ihres Namens aus $cols weitere Parameter für die Spalte festlegt, d.h. Wert zu einem Key (Spaltenname) ist selbst assoziatives Array mit folgenden möglichen Parametern:
    • [width:]Weite der Kopfspalte (width-Attribut im th-Tag)
    • [p_align:]Ausrichtung des Inhalts der Kopfspalte mit <p align=..>-Tag
    • [bold:]Inhalt der Kopfspalte wird fett gedruckt (<b>..</b>)

Als Rückgabe liefert die Funktion einen String, der den HTML-Quelltext für den Tabellen-Kopf und die Kopfzeile enthält.