Sponsor: www.methodica.ch
 

TICKER.CLASS
Beispiele

 

TICKER besteht aus einem Java-Applet (TICKER.CLASS), welches eine Textzeile rollend in einem Fenster ausgibt und mehreren Text-Servern, die das Applet mit Text beliefern. Selbstverständlich muss ein Browser für die Ausführung von Java geeignet sein und für Java konfiguriert sein, damit das Applet wirksam wird.
Das Ticker-Applet übernimmt die Textzeieln via HTML-Parameter oder von Text-Server Klassen. Bisher gibt es folgende Text-Server:
  • DEFTEXT.CLASS *: Default-Text, wenn sonst nichts festgelegt wurde.
  • FILDTXT.CLASS *: Inhalt einer Text-Datei.
  • DATIMTXT.CLASS: Aktuelles Datum und aktuelle Zeit in wählbarem Format..
  • Y2KDTXT.CLASS: Errechnete Differenz zweier Zeitpunkte resp. bis zum Anfang des Jahres 2000.
  • ITIMTXT.CLASS: Gibt die aktuelle Internet-Zeit an.

    (* werden von TICKER.CLASS als vorhanden erwartet und bei Bedarf automatisch geladen.)

Über Parameter kann der Text-Server festgelegt werden. Er wird durch das Applet dynamisch geladen. Der anzuzeigende Text, der Name einer Textdatei, andere Arbeitsparameter und Darstellungseigenschaften können via Parameter eingestellt werden.

Sie können TICKER und alle hier gezeigten Server-Klassen herunterladen - auch im Quellcode - und frei (privat und kommerziell) zum Eigengebrauch verwenden, anpassen und erweitern.

Die einzigen Bedingungen sind dabei:

  • Sie dürfen nicht damit Geld verdienen oder sonstwie durch Verkauf, Miete, Lizenzvergabe, Zurverfügungstellung, usw. wirtschaftlich profitieren;
  • darauf basierende Änderungen und Erweiterungen stehen der Allgemeinheit unter den gleichen Bedingungen wieder zur Verfügung
    (benachrichtigen Sie uns, wenn Sie Ihre Resultate via unseren Server zugänglich machen möchten);
Damit wir wissen, wie oft und in welcher Form unser Applet verwendet wird, und damit wir die Auswirkungen von Änderungen daran abschätzen können, sagen Sie uns doch per  E-Mail wo Sie es einsetzen (Internet-Adresse der Web-Page).
 

Default-Einstellung

<applet CODE="ticker.class" ARCHIVE="tickercls.zip" WIDTH="400" HEIGHT="30">

In der Default-Einstellung zeigt das Applet einen Text, der sich an den Web-Designer richtet und ihm Hinweise gibt, wie er das Applet zielgerichtet nutzen kann.

 

Fixer Text

HTML-Code:

<applet CODE="ticker.class"  ARCHIVE="tickercls.zip" WIDTH="400" HEIGHT="18">
<param name="Rate" value="60">
<param name="Spacing" value="2">
<param name="BackgroundColor" value="FFFFFF">
<param name="BorderStyle" value="0">
<param name="BorderColor" value="CCCCCC">
<param name="BorderThickness" value="0">
<param name="TextStyle" value="1">
<param name="TextFont" value="Monospaced">
<param name="Text" value="Fixer Text - endlos">
<param name="URL"
  value="http://www.methodica.ch/download.htm">
<param name="Target" value="_blank">
</applet>

Unter Applet wird ein (kleines) Programm verstanden, das über in den HTML-Code einer Web-Seite eingebettete Klauseln aktiviert und parametriert wird.

Der oben mit <applet> beginnende und mit </applet> endende Block bindet das TICKER.CLASS-Applet ein und stellt diesem ein Fenster in der Breite von 400 und in der Höhe von 18 Pixels zur Verfügung.

Parameter zuhanden eines Applets werden über Einträge der Form
<param name="..." value="..."> innerhalb des durch <applet> und </applet> begrenzten Blocks spezifiziert. Unter "name" wird der Schlüsselbegriff des Parameters, unter "value" sein Wert angegeben. "param", "name" und "value" m&uum;lssen buchstäblich so geschrieben werden - Gross- / Kleinschreibweise spielt dabei keine Rolle.
Vergleiche dazu die Tabelle am Ende dieser Seite.

Der erste grün markierte PARAM-Eintrag oben legt den anzuzeigenden Text fest, der zweite den Link (URL = unique resource locator), zu welchem verzweigt werden soll, falls der Benutzer das Applet-Fenster anklickt und der dritte legt fest, in welchem Fenster oder Rahmen die zugehörige Seite angezeigt werden soll ("_blank" meint hier "neues Fenster").

Die weinrot markierten Parameter legen die Darstellungseigenschaften fest. Ihre Namen sind sprechend und werden hier nicht weiter erklärt (im Zweifelsfall ausprobieren, was bei Veränderung passiert). "Monospaced" steht für Schriftart mit fixer Schriftgrösse, oft als "Courier" bezeichnet (siehe Tabelle unten).

Farben können auf zwei Arten festgelegt werden:

  1. durch einen 6-stelligen Hexadezimal-RGB-Code im Format RRGGBB (rot-grün-blau).
  2. durch eine Auswahl von Namen, die vordefinierten RGB-Codes zugeordnet sind.


 

Text-Server DATIMTXT:
Aktuelles Datum / aktuelle Zeit

Ein selbst definiertes Format: Ihr Browser unterstützt leider Java nicht - Applet kann nicht angezeigt werden.

HTML-Code:

<applet CODE="ticker.class"  ARCHIVE="tickercls.zip" WIDTH="556" HEIGHT="24">
<param name="Rate" value="60">
<param name="Spacing" value="0">
<param name="TextFont" value="monospaced">
<param name="TextSize" value="12">
<param name="TextStyle" value="1">
<param name="BackgroundColor" value="EEEEFF">
<param name="BorderStyle" value="0">
<param name="BorderColor" value="CCCCCC">
<param name="BorderThickness" value="1">
<param name="TextServer" value="datimtxt">
<param name="DATIMTXT_1" value="' 'E, dd. MMM. yyyy '('D'. Tag im Jahr, 'F'. 'EEEE' im 'MMMM'),  'HH:mm z">
</applet>
 
Eines der ISO-Formate: Ihr Browser unterstützt leider Java nicht - Applet kann nicht angezeigt werden.

HTML-Code:

<applet CODE="ticker.class"  ARCHIVE="tickercls.zip" WIDTH="190" HEIGHT="24">
<param name="Rate" value="60">
<param name="Spacing" value="0">
<param name="TextFont" value="monospaced">
<param name="TextSize" value="12">
<param name="TextStyle" value="1">
<param name="BackgroundColor" value="EEEEFF">
<param name="BorderStyle" value="0">
<param name="BorderColor" value="CCCCCC">
<param name="BorderThickness" value="1">
<param name="TextServer" value="datimtxt">
<param name="DATIMTXT_1" value="' 'yyyy-MM-dd'T'HH:mm:ssZ">
</applet>

 

Der erste grün markierte PARAM-Eintrag bezeichnet die Text-Server-Klasse, welche dem TICKER-Applet den Text liefern soll. Der Name dieser Server-Klasse ist DATIMTXT.CLASS, was dem Applet über den Parameter "TextServer" mitgeteilt wird. 

Der zweite grün markierte PARAM-Eintrag bezeichnet das Darstellungsformat; details siehe unten. Ohne diesen Paramter wird ein Standardformat gewählt.

Nachfolgend die Codes aus welchen das Darstellungsformat gebildet werden kann:

Code und Bedeutung 

Datentyp 

Beispiel 

G Aera-Bezeichner Text AD
y Jahr  Zahl 1996
M Monat in Jahr  Text & Zahl 1, 01, Jan, Januar (M, MM, MMM, MMMM)
d Tag in Monat Zahl 10
h Stunde in AM/PM-Notation (1..12) Zahl 12
H Stunde in Tag (0..23) Zahl 0
K Stunde in AM/PM-Notation (0..11) Zahl 0
k Stunde in Tag (1..24) Zahl 24
m Minute in Stunde  Zahl 30
s Sekunde in Minute Zahl 55
S Millisekunde in Sekunde Zahl 978
E Wochentag Text Do, Donnerstag (E, EEEE)
D Tagesnummer im Jahr Zahl 189
F Wochentag-Nummer im Monat Zahl 'Dies ist der 'F'. 'EEEE' im Monat 'MMMM
w Woche in Jahr Zahl 27
W Woche in Monat Zahl 2
a AM/PM-Marke Text PM
z Zeitzone, Bezeichner (z.B. CEST) Text z
Z Zeitzone, Abweichung der Lokalzeit gegenüber GMT/UTC (±HHmm) Text 'UTC'Z
' Klammert expliziten Text ein Begrenzer H 'Uhr' m 'Minuten'
'' Einfaches Apostroph-Zeichen Literal Webmaster''s Zeit

Zusätzliche Regeln:

  • Wiederholung der Codes: Anzahl Stellen. 1-stellig: vorlaufende Nullen unterdrückt.
  • Wenn Zahl oder Text angezeigt werden können: bei 3 und mehr Code-Wiederholungen wird die Textvariante verwendet. (Z.B.: MM=06, MMMM=Juni).

Text-Server Y2KDTXT:
Datum-/Zeit-Differenz

 

HTML-Code:

<applet CODE="ticker.class"  ARCHIVE="tickercls.zip" WIDTH="400" HEIGHT="24">
<param name="Rate" value="60">
<param name="Spacing" value="1">
<param name="BackgroundColor" value="yellow">
<param name="TextServer" value="y2kdtxt">
<param name="URL"
  value="http://www.methodica.ch/y2k0000.htm">
</applet>

Der grün markierte PARAM-Eintrag bezeichnet die Text-Server-Klasse, welche dem TICKER-Applet den Text liefern soll. Der Name dieser Server-Klasse ist Y2KDTXT.CLASS, was dem Applet über den Parameter "TextServer" mitgeteilt wird. Ohne spezielle Paramter wird Zeitdifferenz bis zum Anfang des Jahres 2000 angezeigt.

Alternativ können mit folgenden Parametern ein VON-Datum (y2kdtxt_1) und/oder ein BIS-Datum (y2kdtxt_2) angegeben werden, womit sinngemäss beliebige Datum- / Zeit-Differenzen berechnet werden können. Fehlt ein Datum, wird das aktuelle Tagesdatum und die aktuelle Tageszeit dafür angenommen. Fehlen beide, werden als VON-Datum die aktuellen Datum-/Zeitwerte und als BIS-Datum der 1.1.2000 00:00 angenommen:

<param name="y2kdtxt_1" value="1998 Jun 25 13:22:08">
<param name="y2kdtxt_2" value="1999 Dec 31">

Das Datum-/Zeit-Format der VALUE-Felder ist bindend. Monate müssen in Englisch und als Text eingegeben werden. Welcher Parameter für das VON- resp. BIS-Datum verwendet wird, ist ohne Bedeutung.
Beachte: Java akzeptiert kein Datum kleiner als "1970 Jan 1". Weil in der Y2KDTXT-Klasse die Java-Standard-Klasse "Date" verwendet wird, würde ein älteres Datum als Fehleingabe behandelt.

Durch solche Server-Klassen kann das Ticker-Applet beliebig erweitert werden. Ein anderes Beispiel dafür ist die unten verwendete Server-Klasse FILDTXT.CLASS.

 

Text-Server FILDTXT:
liest aus Quell-Datei

HTML-Code:

<applet CODE="ticker.class"  ARCHIVE="tickercls.zip" WIDTH="600" HEIGHT="30">
<param name="Rate" value="80">
<param name="Spacing" value="4">
<param name="PageDelay" value="3000">
<param name="BorderStyle" value="2">
<param name="BorderColor" value="FFFFDD">
<param name="BorderMargin" value="4">
<param name="BackgroundColor" value="DDDDFF">
<param name="TextColor" value="000000">
<param name="HighlightColor" value="CC0000">
<param name="TextFont" value="Courier">
<param name="TextSize" value="14">
<param name="TextStyle" value="3">
<param name="ShadowWidth" value="2">
<param name="ShadowDistance" value="3">
<param name="TextFile" value="demo.txt">
<param name="Direction" value="1">
</applet>

Der grün markierte PARAM-Eintrag legt - im URL-Format - eine Quell-Datei fest, aus der Zeile um Zeile herausgelesen und angezeigt werden soll. Dazu aktiviert das TICKER-Applet automatisch den Text-Server FILDTXT.CLASS.

Beachte

  • Der Wert zum Parameter "TextFile" kann folgende Formate annehmen:
    • Lang-Format: protokoll://hostid:portnummer/datei#anker
      z.B. http://www.methodica.ch/dowload/t-ticker/demo.txt
    • Kurz-Format: datei#anker
      z.B. ticker.txt
      (Wird automatisch mit dem aktuellen Dokumentverzeichnis ergänzt und entspricht in diesem genau dem Beispiel
      oben.)
  • Einzelne oder alle Zeilen einer Text-Datei können fakultativ nach einem Pipe-Zeichen (|) eine URL enthalten, auf die verzweigt wird, falls der Benutzer das Applet anklickt.
    (Z.B.: Klicke auf hier drauf, um weitere Details zu sehen.|http://www.methodica.ch/...).
    Selbstverständlich wird dadurch der Parameter "URL" aus der HTML-Seite übersteuert.

(Hinweis: "port" und "#anker" sind in beiden Fällen fakultativ, "port" ist in den wenigsten Fällen sinnvoll, anzugeben.)

Noch ein Beispiel

HTML-Code:

<applet CODE="ticker.class" ARCHIVE="tickercls.zip" WIDTH="430" HEIGHT="30">
      <param name="BackgroundColor" value="FFFFDD">
      <param name="BorderColor" value="330000">
      <param name="BorderMargin" value="4">
      <param name="BorderStyle" value="2">
      <param name="HighlightColor" value="CC0000">
      <param name="PageDelay" value="1000">
      <param name="Rate" value="80">
      <param name="Spacing" value="1">
      <param name="TextColor" value="000000">
      <param name="TextFont" value="monospaced">
      <param name="TextSize" value="14">
      <param name="TextStyle" value="3">
      <param name="ShadowWidth" value="2">
      <param name="ShadowDistance" value="3">
      <param name="TextFile" value="demo1.txt">
    </applet>

 

 

Text-Server ITIMTXT:
zeigt aktuelle Internet-Zeit an

Aktuelle Internet-Zeit:   Hier würde die aktuelle Internet-Zeit angezeigt. Ihr Browser unterstützt aber leider Java nicht oder ist nicht dafür konfiguriert.

HTML-Code:

<applet CODE="ticker.class"  ARCHIVE="tickercls.zip" WIDTH="66" HEIGHT="22">
<param name="TextServer" value="itimtxt">
<param name="ITIMTXT_1" value="ShowDecimals">
<param name="URL"  value="http://www.methodica.ch/inettime.htm">
<param name="TextFont" value="monospaced">
<param name="TextSize" value="16">
<param name="TextStyle" value="1">
<param name="BorderThickness" value="0">
</applet>

Der erste grün markierte PARAM-Eintrag bezeichnet ITIMTXT.CLASS als Text-Server. Der zweite grün markierte Parameter weist ITIMTXT.CLASS an, die Internetzeit mit Dezimalstellen (und nicht als Ganzzahl) aufzubereiten. In der Regel wird allerdings bei der Internet-Zeit auf die Angabe von Dezimalstellen verzichtet.

weinrot markiert: bei einem BoarderThickness-Wert von 0 (Null) wird kein Rahmen angezeigt. Bei geeigneter Hintergrundfarbe fügt sich das Applet so randlos in die Seite ein.

Viel Spass!

 

Tabelle: Parameter und Parameterwerte
 
Parameter Wert-Typ Bedeutung & Werte Hinweis
<param name="Rate" value="Zahl"> Reziprokes Schritt-Intervall in 1/Rate Sekunden.
Z.B. 40: Text wird 40-mal pro Sekunde neu angezeigt.
Fakultativ, wenn nicht angegeben: 40.
(vergl. "Spacing")
<param name="Spacing" value="Zahl"> Schritt-Weite in Pixel. Um wieviele Pixel verschoben der Text bei jedem Schritt angezeigt wird. Fakultativ, wenn nicht angegeben: 1
Kleine Werte hier und grosse "Spacing"-Werte: ruckartiges Verschieben des Textes. Grosse Werte hier und kleine "Spacing"-Werte: sanftes Gleiten des Textes.
<param name="PageDelay" value="Zahl"> Wartezeit nach Anzeige einer Textzeile in 1/1000 Sekunden. 0 (Null): keine Wartezeit. Fakultativ, wenn nicht angegeben: 1000
<param name="BorderStyle" value="Zahl"> Rahmen-Art.
0(Null) = flach, 1 = abgesenkt, 2 = erhaben.
Fakultativ, wenn nicht angegeben: 1
<param name="BorderThickness" value="Zahl"> Rahmen-Breite in Punkten.
0 (Null) = kein Rahmen.
Fakultativ, wenn nicht angegeben: 2
<param name="BorderColor" value="RGB-Zahl"> Mittlere Rahmen-Farbe.
(RRGGBB-Darstellung oder vordefinierte Farbnamen [1]).
Fakultativ, wenn nicht angegeben: "BackgroundColor"
<param name="BorderMargin" value="Zahl"> Abstand Rahmen zu Text in Pixel. Fakultativ, wenn nicht angegeben: 2
<param name="BackgroundColor" value="RGB-Zahl"> Hintegrund-Farbe.
(RRGGBB-Darstellung oder vordefinierte Farbnamen [1]).
Fakultativ, wenn nicht angegeben: weiss.
<param name="TextColor" value="RGB-Zahl"> Text-Farbe.
(RRGGBB-Darstellung oder vordefinierte Farbnamen [1]).
Fakultativ, wenn nicht angegeben: schwarz.
<param name="HighlightColor" value="RGB-Zahl"> Selektiert-Farbe; wird angezeigt, wenn "URL" definiert und Maus über Link.
(RRGGBB-Darstellung oder vordefinierte Farbnamen [1]).
Fakultativ, wenn nicht angegeben: rot.
<param name="TextFont" value="Zeichenfolge"> Name der Schriftart. Folgende sind sinnvoll und weden durch die meisten Browser korrekt dargestellt:
  • "Serif", entspricht Times, variable Schrittweite.
  • "SansSerif", entspricht Arial, Helvetica, variable Schrittweite.
  • "Monospaced", entspricht Courier, fixe Schrittweite.
Fakultativ, wenn nicht angegeben: Standard-Font des Browsers
<param name="TextStyle" value="Zahl"> Textstil:
0(Null) = normal, 1 = fett, 2 = kursiv, 3 = fett+kursiv.
Fakultativ, wenn nicht angegeben: Standard-Font Browser
<param name="TextSize" value="Zahl"> Grösse des Textes in Punkten. Fakultativ, wenn nicht angegeben: Standard-Font des Browsers
<param name="TextServer" value="Zeichenfolge"> Name des zu verwendenden Text-Servers (Klassen-Datei, ohne Endung .class).
Möglich sind:
  • itimtxt: aktuelle Internet-Zeit.
  • y2kdtxt: Datum-/Zeit-Differenz.
  • fildtxt: Text aus Datei, automatisch angenommen, wenn "TextFile" angegeben.
  • weitere, sofern entsprechende Klassen-Dateien vorhanden.
Fakultativ, wenn nicht angegeben: Standard-Font des Browsers
<param name="Text" value="Zeichenfolge"> Anzuzeigender (fixer) Text.
Der Text kann nach folgendem Muster durch sogenannte "Pipe"-Zeichen in Sub-Parameter untergliedert sein:   "text | target | url".
Details siehe Parameter "TextFile".
Fakultativ, wenn nicht angegeben: gemäss "TextServer" oder sonst Hinweistext für Webmaster.
<param name="TextFile" value="Zeichenfolge"> Datei, welcher der Text zeilenweise zu entnehmen ist.
Zeilen können nach folgendem Muster durch sogenannte "Pipe"-Zeichen in Sub-Parameter untergliedert sein:  "text | target | url".
Dabei entsprechen "url" und "target" den gleichnamigen Parametern, gelten aber im Gegensatz zu jenen nur für jeweils eine Text-Zeile.
Fakultativ. Nicht nötig zusammen mit "Text" resp. "TextServer".
Die Sub-Parameter werden aufgrund der Anzahl "|"-Zeichen bestimmt und sind grundsätzlich fakultativ.
Beachte: "TextFile" muss in der Regel auf dem gleichen Server wie das Applet liegen. Java-Applets können aus Sicherheitsgründen nicht auf fremden Servern Daten beziehen.
<param name="URL" value="Zeichenfolge"> Hyperlink (unique resource locator) zu einem Dokument, das angezeigt werden soll, wenn der Benutzer das Applet anklickt. Falls zusammen mit Sub-Parametern eines TextFiles verwendet, gilt der URL-Parameter immer dann, wenn dort nichts anderes angegeben ist. Fakultativ, wenn nicht angegeben: kein Link.
Beachte: Absolute URLs empfohlen.
<param name="Target" value="Zeichenfolge"> Name des Fensters oder Frames, in welchem ein Dokument gemäss URL-(Sub-)Parameter angezeigt werden soll. "_blank" bedeutet "neues Fenster". Fakultativ, wenn nicht angegeben: Fenster / Frame, der das Applet enthält.
<param name="Direction" value="Zahl"> Verschiebe-Richtung des Texts bei jedem Schritt:
  • Gerade Zahl (0): von rechts nach links
  • Ungerade Zahl (1): von links nach rechts

Vergl. "Rate" und "Spacing" Parameter.

Fakultativ, wenn nicht angegeben: 0 (Null).
<param name="ShadowDistance" value="Zahl"> Abstand des Schattens vom Text in Pixeln. Fakultativ, wenn nicht angegeben: 4.
Beachte: Die Schattendarstellung braucht realtiv viel Ressourcen auf dem Client-System. Sie sollten deshalb sparsam eingesetzt werden.
<param name="ShadowWidth" value="Zahl"> Breite des Schattens in Pixeln. Fakultativ, wenn nicht angegeben: kein Schatten
    [1] "black", "blue", "cyan", "darkgray", "gray", "green", "lightgray", "magenta", "orange", "pink", "red", "white", "yellow"  
 
Weitere, spezifisch für einzelne Text-Server geltende, Parameter sind jeweils oben beschrieben.

 
Haben Sie Fragen oder Kommentare zur Web-Site?
Copyright © 1997-2003, methodica herger & krasznai
Alle Rechte vorbehalten. Zuletzt geändert: 2004-03-01