Der Eintrag appearance im Detail

 Wie bereits beschrieben zerfällt ein DB-Table-Submodul in eine Haupttabelle (anzeige) und je nach Aktionsart in die Zwischentabellen aendern und loeschen, sowie in das Formular neues_tupel. Diese vier Bestandteile bestehen wiederum aus einzelnen Elementen. Tabelle listet die Elemente auf und gibt Auskunft darüber, wann die einzelnen Elemente zur Verfügung stehen.

 

Element Beschreibung

tabelle Damit ist die Haupttabelle bzw. die Zwischentabellen oder das Formular für neues_tupel gemeint. ja ja ja ja

blaettern_a Navigationsleiste für das seitenweise Blättern. ja nein ja ja

blaettern_b Navigationsleiste für das tupelweise Blättern ja nein ja ja

suchen Formular zum Suchen, Einschränken und Sortieren ja nein nein nein

neues_tupel Button, über den die Aktion 'neues_tupel' ausgelöst werden kann ja nein nein nein

Die Elemente werden, wie das häufig bei der HTML-Programmierung der Fall ist, mit Hilfe einer unsichtbaren Tabelle angeordnet. Die damit möglichen Layoutdetails, sowie weitere Gestaltungsmöglichkeiten können mit dem Array 'appearance' bei Bedarf beeinflusst werden. In der Regel sollten jedoch die Standardeinstellungen ausreichen. Die Einträge 'nur_diese_aktion', 'nur_bei_link_aktion' und 'no_buttons' sind hingegen mehr als reine Layoutparameter. Tabelle zeigt die im Array 'appearance' möglichen Einträge und Tabelle in welchen Submodul-Bestandteilen welche Einträge zur Verfügung stehen.

 

Eintrag Beschreibung Default

nur_diese_aktion Wird eine der Aktionen 'neues_tupel', 'aendern' oder 'loeschen' ausgelöst, wird die zugehörige Zwischentabelle bzw. das Formular zusammen mit der Haupttabelle angezeigt. Setzt man diesen Eintrag auf '1' wird die Haupttabelle nicht angzeigt. Setzt man diesen Eintrag auf '2', werden die anderen DB-Table-Submodule nicht angezeigt (nur bei Verwendung von 'modul_tabelle_list'). '0'

nur_bei_link_aktion Boolscher Wert, der bei 'true' bewirkt, dass das zugehörige DB-Table-Submodul nur angezeigt wird, wenn in einem DB-Table-Submodul die Aktion 'aendern' oder 'loeschen' ausgelöst wurden (siehe Beschreibung von 'required_attribs' in Abschnitt ) false

zeilen_pro_seite Integer, der festlegt wieviel Datentupel auf einer Seite jeweils dargestellt werden sollen. 10, bei 'loeschen' 2

reihenfolge Array, das die Reihenfolge der einzelnen Elemente vorgibt. Hierbei kann für das 'suchen' sogar noch die Reihenfolge der Zeilen für das Suchen und Sortieren verändert werden. ('neues_tupel', 'tabelle', 'blaettern_a', blaettern_b', 'suchen', 'sortieren')

bgcolor Hintergrundfarbe '#FFFFFF'

param Array, das einem table_param-Array (siehe ) entspricht, nur das dies für die Layout-Tabelle verwendet wird. siehe 'lib-dbtable.inc.php'

abstaende Array mit den Abstände (in Pixel) jedes einzelnen Elements nach oben. Für den Abstand nach unten gibt es noch den Index 'bottom'. Die Abstände werden mit dem unsichtbaer Image 'blank.gif' realisiert. english (neues_tupel=>2, blaettern_a=>5, blaettern_b=>0, tabelle=>20, suchen=>20, bottom=>80 ) german

neues_tupel_text String, der vor dem neues_tupel-Buttom erscheint. siehe HTML-Ausgabe

max_rows_for_mtable Integer, der bestimmt, ab wieviel Tupel statt einer mtable eine normale Tabelle verwendet werden soll. 2

 

Eintrag anzeige neues_tupel aendern loeschen

nur_diese_aktion nein ja ja ja

nur_bei_link_aktion ja nein nein nein

zeilen_pro_seite ja nein ja ja

reihenfolge ja nein ja ja

bgcolor ja ja ja ja

param ja ja ja ja

abstaende ja ja ja ja

neues_tupel_text ja nein nein nein

max_rows_for_mtable nein nein ja ja

Im Beispiel werden in der 'anzeige'-Tabelle statt der üblichen 10 jeweils 20 Tupel pro Seite dargestellt. Beim Aufruf der 'aendern'-Tabelle wird die Haupttabelle ausgeblendet:

• []$modul_param = array ( 

    tabellenid => "student", 

    leittabelle => "student", 

    anzeige => array ( 

      query => array ( 

        array ( 

          SELECT => "vorname, name as nachname, 

            matrikelnummer, hauptfach", 

        ), 

      ), 

      appearance => array ( 

        zeilen_pro_seite => 20 

      ), 

      aktionen => array( 

        aendern => 1, 

      ), 

    ), 

    aendern => array ( 

      appearance => array ( 

        nur_diese_aktion => 1, 

      ), 

    ), 

  ); 
  

  modul_tabelle_list($modul_param);