Fortschrittsbalkens mit PHP

ProgressClass stellt eine PHP-Klasse für die dynamische Anzeige und Veränderung eines Fortschrittsbalkens zur Verfügung.

|31.01.2003 | what@ | 19473 | KAT : PHP | | 0
Tweet

2

2

Beschreibung der Funktionen

ProgressClass()

Die Funktion wird durch Instanzieren der Klasse aufgerufen und nimmt interne Initialisierungen vor. Sie können beliebig viele Fortschrittsbalken (auch gleichzeitig) durch Instanzieren neuer Klassen erzeugen. Alle Fortschrittsbalken haben voneinander unabhänge Einstellungen und können getrennt angezeigt und geändert werden.

Benötigt keine Parameter.

          <p>$progress-&gt;new ProgressClass();</p>

setWidth($width);

Definiert die Breite des Fortschrittbalkens (äußerer Rand des Fensters) in Pixeln. Standardeinstellung sind 350 Pixel.

Der Aufruf dieser Funktion nach make() hat keine Wirkung.

          $progress->setWidth(300);
     

setPosition($left=NULL,$top=NULL);

Definiert die Position (obere linke Ecke) des Fortschrittsbalkens (äußerer Rand des Fensters) innerhalb des angezeigten Dokuments/Frames in Pixeln. Standardeinstellung ist 'center','center-65'.

Der erste Parameter bezeichnet den Abstand der oberen linken Ecke zum linken Seitenrand, der zweite zum oberen Seitenrand. Sie können auch nur einen der Parameter angeben, der zweite behält dann die Standardeinstellung. Wenn Sie nur den zweiten Parameter angeben möchten, muß der erste NULL sein.

Anstelle von absoluten Zahlen können Sie auch 'center' angeben, so daß das Fenster zentriert im Anzeigebereich angezeigt wird. Möglich ist sogar eine Kombination z.B. 'center-30'.

Der Aufruf dieser Funktion nach make() hat keine Wirkung.

          $progress->setPosition(100,30);
       

          $progress->setPosition(NULL,30); //
          Standardeinstellung für $left beibehalten
        

          $progress->setPosition(100); // Standardeinstellung
          für $top beibehalten

          $progress->setPosition('center','center-30'); //
          Zentriert, etwas nach oben verschoben
 

setButton($label,$url,$target='_self')

Fügt dem Fortschrittsbalken einen Button hinzu, auf dessen Klick eine neue Seite geöffnet wird. Der Button kann z.B. mit "Abbrechen" beschriftet werden. Wenn er angeklickt wird, wird eine neue Seite geladen, so daß die Ausführung der aktuellen Seite abgebrochen wird (nur wenn target='_self').

Mit dem ersten Parameter wird die Beschriftung des Buttons, mit dem zweiten die Ziel-URL angegeben. Der optionale dritte Parameter bezeichnet das für den Link verwendete Target.

Der Aufruf dieser Funktion nach make() hat keine Wirkung.

          $progress->setButton('Abbrechen','/seiten/abbruch.php');

          $progress->setButton('Info','info.php','_blank');

setPercent($percent)

Definiert die Prozentanzeige des Fortschrittsbalkens. Standardeinstellung ist 0.

Der Parameter muß als Zahl, ohne Prozentzeichen angegeben werden.

Diese Funktion kann auch nach make() noch öfter aufgerufen werden, um die Prozentanzeige dynamisch zu ändern (DHTML).

          $progress->setPercent(25);
 

setPerX($some,$all)

Definiert die Prozentanzeige des Fortschrittsbalkens und rechnet dafür die angegebenen Werte in Prozent um.

Der erste Parameter stellt die aktuelle Position von insgesamt soviel Positionen, wie der zweite Parameter bezeichnet, dar. Wenn Sie eine Datei oder ein MySQL-Result einlesen, übergeben Sie für $all die Anzahl der Einträge und für $some die aktuelle Position des Dateizeigers/Result-Zeigers.

Diese Funktion kann auch nach make() noch öfter aufgerufen werden, um die Prozentanzeige dynamisch zu ändern (DHTML).

          $gesamt=1500;<br>
          for ($i=1;$i&lt;=$gesamt;$i++)<br>
          $progress-&gt;setPerX($i,$gesamt);
      

setLabel($label)

Definiert die Beschriftung des Fortschrittsbalkens. Standardeinstellung ist "Bitte warten ..."

Diese Funktion kann auch nach make() noch öfter aufgerufen werden, um das Label dynamisch zu ändern (DHTML).

          $progress->setLabel('Seite wird geladen ...');
        

setBarColor($color)

Definiert die Farbe des Fortschrittsbalkens. Standardeinstellung ist dunkelblau.

Die Farbe muß als HTML-Color-Code angegeben werden.

Diese Funktion kann auch nach make() noch öfter aufgerufen werden, um die Farbe dynamisch zu ändern (DHTML).

          $progress->setBarColor('#FF0000'); // rot
        

hide()

Macht den Fortschrittsbalken unsichtbar. Sollte am Ende der Ausgabe aufgerufen werden, damit der Besucher die Seite ohne den Fortschrittsbalken betrachten kann.

Benötigt keine Parameter.

Diese Funktion sollte nur nach make() aufgerufen werden (DHTML).

          $progress->hide();
        

show()

Macht den Fortschrittsbalken sichtbar und ist z.B. sinnvoll, wenn vorher make(false) aufgerufen wurde.

Benötigt keine Parameter.

Diese Funktion sollte nur nach make() aufgerufen werden (DHTML).

          $progress->show();
  

make($show=true)

Erstellt den Fortschrittsbalken und gibt ihn an den Browser aus.

Wichtig: Die Funktion darf erst aufgerufen werden, nachdem der <body>-Tag an den Browser gesendet wurde!

Optional kann durch den Parameter angegeben werden, ob der Fortschrittsbalken auch gleich sichtbar angezeigt wird. Standardeinstellung ist true (= Ja).

          $progress->make();
      

          <p>$progress-&gt;make(false); // Nur ausgeben, noch nicht
          anzeigen.</p>
      

Kommentare zum Tutorial Tutorial kommentieren Neuen Kommentar schreiben Benutzen Sie [code] und [php] um Codes, SQL-Queries oder php korrekt darzustellen!