Fortschrittsbalkens mit PHP

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

ProgressClass

Download
Den Quellcode gibts hier

In einem Fenster im Windows-Stil kann noch während der Laufzeit des Scripts der Fortschritt angezeigt werden, z.B. beim Laden/Ausgeben der Seite, Versenden von E-Mails oder Bearbeiten von Datenbanken. Am Ende der Seite kann der Fortschrittsbalken wieder ausgeblendet werden. Features: optionaler Abbrechen-Button; dynamische Änderung von Beschriftung, Farbe, Prozent; freie Größe und Positionierung.

Systemvoraussetzungen

Der Server benötigt PHP 4.x oder höher incl. korrekt installierter aktueller browscap.ini. Der Client benötigt den IE 5.x oder höher bzw. Netscape 6.x oder höher. Andere Browser-Hersteller sind nicht getestet. ProgressClass prüft selbständig die Browserversion und zeigt bei zu alter Version keinen Fortschrittsbalken an; eine eigene Browserüberprüfung brauchen Sie nicht zu verwenden.

Installation

Kopieren Sie einfach die Dateien ProgressClass.php und js.inc.php auf ihren Webspace.

Anwendung

ProgressClass ist komplett objektorientiert. Es stellt eine Klasse zum Erzeugen, Bearbeiten und Löschen des Fortschrittsbalkens zur Verfügung. Wenn mehrere Fortschrittsbalken benötigt werden, kann die Klasse auch ohne Probleme mehrmals instanziert werden (auch gleichzeitig). Grundsätzlich stellt sich der Einsatz folgendermaßen dar:

  1. Einbinden der Klasse:

    require('ProgressClass.php');


  2. Erzeugen einer Instanz der Klasse:

    $progress=new ProgressClass();


  3. Einstellen der gewünschten Optionen (siehe unten). Dieser Schritt ist optional, die Klasse ist mit Standardeinstellungen vorbelegt. Beispiel:

    $progress->setWidth(300);
    $progress->setPosition('center',20);
    ... usw.


  4. Fortschrittsbalken generieren und ausgeben:

    $progress->make();


  5. Ändern der Prozentanzeige oder anderer Einstellungen:

    $progress->setPercent(10);
    ...
    $progress->setPercent(45);
    ...
    $progress->setPercent(80);
    $progress->setLabel('Speicher wird aufgeräumt ...');
    ...
    $progress->setPercent(100);
    $progress->setLabel('Fertig!');


  6. Fortschrittsbalken löschen, so daß er nicht mehr im Browser angezeigt wird:

    $progress->hide();

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-&gt;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-&gt;setPosition(100,30);
       

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

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

          $progress-&gt;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-&gt;setButton('Abbrechen','/seiten/abbruch.php');

          $progress-&gt;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-&gt;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-&gt;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-&gt;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-&gt;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-&gt;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-&gt;make();
      

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

Ratings

There are no comments available yet.

Here you can write a comment


Please enter at least 10 characters.
Loading... Please wait.
* Pflichtangabe

Related topics

Verschlüsslung bzw. Codierung von HTML Code in ASCII

HTML Code können wir ebenso gut in ASCII Code umwandeln. Zunächst einmal ein paar Sätze dazu, wozu man ASCII Zeichen benötigt und wozu Ihnen dieses Script dient. ...

Lukas Beck

Autor : Lukas Beck
Category: PHP-Tutorials

Variablen über mehrere Seiten hinweg verwenden - der Session-Befehl macht 's möglich!

Oberste Voraussetzung um Session-Befehle korrekt auszuführen ist, dass der Provider a) PHP und b) das speichern von Sessions auf dem Server überhaupt erlaubt. Wird der Session-Befehl unterstützt jedoch nicht das direkte speichern von Sessions bzw. Sess ...

ndo@

Autor : ndo@
Category: PHP-Tutorials

PHP 7 Virtual Machine

Dieser Artikel zielt darauf ab, einen Überblick über die Zend Virtual Machine, wie es in PHP 7 gefunden wird. ...

admin

Autor : admin
Category: PHP-Tutorials

SVN Server einrichten

Wie man unter Linux einen Subversion Server einrichtet. ...

admin

Autor : admin
Category: Linux & Server Tutorials

Templates mit PHP

Dieses Tutorial beschreibt in mehreren Teilen wie man Templates in PHP verwendet. Ferner erhält man eine Einführung in die Entwicklung eines eigenen Templatesystems. ...

mortalan@

Autor : mortalan@
Category: PHP-Tutorials

Login/Memberbereich mit Sessions

Adminmodul für das eigene Gästebuch, Controlpanel eines Forum oder einfach nur für ein geschützer Bereich. ...

webmaster1@

Autor : webmaster1@
Category: PHP-Tutorials

Dateien per Userinterface hochladen

Um Dateien per Userinterface hochladen zu können, benötigt man vergleichbar wenige Kenntnisse in der Programmiersprache PHP ...

Lukas Beck

Autor : Lukas Beck
Category: PHP-Tutorials

Tutorials zu Facebook Anwendungen mit PHP

In mehreren Tutorials wird der Zugriff auf Facebook Daten mittels Graph API, FQL und REST API erklärt. Alle Codebeispiele liegen zum Ausprobieren in einem SVN, bzw. github Repository bereit. ...

abouttheweb

Autor : abouttheweb
Category: PHP-Tutorials

Publish a tutorial

Share your knowledge with other developers worldwide

Share your knowledge with other developers worldwide

You are a professional in your field and want to share your knowledge, then sign up now and share it with our PHP community

learn more

Publish a tutorial