Allgemeines zur Verwendung
Mit dem Objekt FENSTERNAME.document.links[ ] haben Sie Zugriff auf alle Verweise, die in einer HTML-Datei definiert sind.
Eine Objektinstanz des Verweis-Objekts wird automatisch erzeugt, wenn der WWW-Browser Verweise in der HTML-Datei vorfindet.
Beispiel:
var meinServer = window.document.links[3].hostName;
|
Erläuterung:
Im Beispiel wird in einer Variablen meinServer die Namensadresse des Server-Rechner gespeichert, wie sie in der Angabe href= beim vierten Verweis innerhalb der HTML steht. Dies geschieht durch Auswertung der Objekteigenschaft hostName.
Die Verweise werden über Indexnummern angesprochen. Bei Verwendung von Indexnummern geben Sie links an und dahinter in eckigen Klammern, den wievielten Verweis in der Datei Sie meinen. Beachten Sie, daß der Zähler bei 0 beginnt, d.h. den ersten Verweis der Datei sprechen Sie mit links[0] an, den zweiten mit links[1] usw. Beim Zählen gilt die Reihenfolge, in der die Verweise in der Datei definiert sind.
Beachten Sie:
Zu den Fensternamen lesen Sie den Abschnitt Allgemeines zur Verwendung des window-Objekts. Bei Verwendung von Frames lesen Sie auch den Abschnitt Allgemeines zur Verwendung des Frame-Objekts.
Eigenschaften
FENSTERNAME.links.length
Ermittelt die Anzahl in einer Datei enthaltenen Verweise. Mit window.status='Diese Datei enthaelt ' + window.links.length + ' Verweise';return true; können Sie beispielsweise in der Statuszeile des WWW-Browsers die Anzahl der in der Datei enthaltenen Verweise anzeigen
FENSTERNAME.links[#].hash
Der Ankername bei einem Verweis. Wenn in der Datei beispielsweise der dritte Verweis <a href="http://www.hway.net/teamone/gerinthp/index.html#top">Anfang der Homepage-Liste</a> lautet und Sie die Anweisung var Anker = document.links[2].hash notieren, wird in Anker der Wert #top gespeichert.
FENSTERNAME.links[#].host
Der Host bei einem Verweis. Wenn in der Datei beispielsweise der vierte Verweis <a href="http://www.hway.net/teamone/gerinthp/index.html#top">Anfang der Homepage-Liste</a> lautet und Sie die Anweisung var Domaine = document.links[3].host notieren, wird in Domaine der Wert www.hway.net. Falls der Host nicht als Name, sondern in Form von Zahlen angegeben ist, werden stattdessen die Zahlen gespeichert.
FENSTERNAME.links[#].hostName
Der Hostname bei einem Verweis. Wenn in der Datei beispielsweise der vierte Verweis <a href="http://www.hway.net/teamone/gerinthp/index.html#top">Anfang der Homepage-Liste</a> lautet und Sie die Anweisung var Domainenname = document.links[3].hostName notieren, wird in Domainenname der Wert www.hway.net gespeichert.
FENSTERNAME.links[#].href
Der komplette Verweis. Wenn in der Datei beispielsweise der erste Verweis <a href="http://www.hway.net/teamone/gerinthp/index.html#top">Anfang der Homepage-Liste</a> lautet und Sie die Anweisung var Verweis = document.links[0].href notieren, wird in Verweis der Wert http://www.hway.net/teamone/gerinthp/index.html#top gespeichert.
FENSTERNAME.links[#].pathname
Der Pfadname eines Verweises. Wenn in der Datei beispielsweise der fünfte Verweis <a href="http://www.hway.net/teamone/gerinthp/index.html#top">Anfang der Homepage-Liste</a> lautet und Sie die Anweisung var Pfad = document.links[4].pathname notieren, wird in Pfad der Wert /teamone/gerinthp/ gespeichert.
FENSTERNAME.links[#].port
Der Port eines Verweises. Wenn in der Datei beispielsweise der dritte Verweis <a href="http://www.hamburg.pop.de:800/bda/int/zeit/aktion/index.html#top">Aktionen</a> lautet und Sie die Anweisung var Verweisport = document.links[2].port notieren, wird in Pfad der Wert :800 gespeichert.
FENSTERNAME.links[#].protocol
Der Pfadname eines Verweises. Wenn in der Datei beispielsweise der zweite Verweis <a href="http://www.hway.net/teamone/gerinthp/index.html#top">Anfang der Homepage-Liste</a> lautet und Sie die Anweisung var URLTyp = document.links[1].protocol notieren, wird in URLTyp der Wert http:// gespeichert.
FENSTERNAME.links[#].search
Der CGI-Script-Abfrageteil innerhalb eines Verweises. Wenn in der Datei beispielsweise der zweite Verweis <a href="http://guide-p.infoseek.com/WW/NS/Titles?qt=RFC+1738+&col=WW">In Infoseek suchen</a> lautet und Sie die Anweisung var CGIAbfrage = document.links[1].search notieren, wird in CGIAbfrage der Wert qt=RFC+1738+&col=WW gespeichert.
FENSTERNAME.links[#].target
Das bei einem Verweis angegebene Zielfenster, z.B. innerhalb eines Frame-Sets. Wenn in der Datei beispielsweise der vierte Verweis <a href="http://www.hway.net/teamone/gerinthp/index.html" target="RechtesFenster">Homepage-Liste</a> lautet und Sie die Anweisung var Zielfenster = document.links[3].target notieren, wird in Zielfenster der Wert RechtesFenster gespeichert.
Methoden
Das Verweis-Objekt hat keine eigenen Methoden.
© 1997 Stefan Münz, s.muenz@euromail.com