SELFHTML: JavaScript / Objektreferenz / links
Description: (SELFHTML 7.0) Das JavaScript-Objekt links
Keywords: SELFHTML, JavaScript, Objekt, links-Objekt

SELFHTML/Quickbar JavaScript Objektreferenz

| ## links
| links: Allgemeines zur Verwendung length (Anzahl Verweise) Zugriff auf Verweisziele

## links: Allgemeines zur Verwendung

Mit dem Objekt `links`, das in der JavaScript-Objekthierarchie unterhalb des document-Objekts liegt, haben Sie Zugriff auf Verweise, die in einer HTML-Datei definiert sind. Die einzige JavaScript-Objekteigenschaft des links-Objekts ist die Anzahl der Verweise in einer Datei.

Über das links-Objekts haben Sie jedoch auch Zugriff auf Verweisziele der definierten Verweise.

## length

Speichert, wie viele Verweise eine HTML-Datei enthält.

### Beispiel:

    <html><head><title>Test</title>
    </head><body>
    <a href="http://www.yahoo.de/">Yahoo</a><br>
    <a href="http://www.lycos.de/">Lycos</a><br>
    <map name="Testbild">
    <area shape=rect coords="1,1,249,49" href="#Ziel_1">
    <area shape=rect coords="1,51,149,299" href="#Ziel_2">
    </map>
    <img src="datei.gif" width=400 height=400 usemap="#Testbild">
    <p>
    <script language="JavaScript">
    document.write("Die Datei hat " + document.links.length + " Verweise");
    </script>
    </body></html>

### Erläuterung:

Mit `document.links.length` können Sie die Anzahl der Verweise in einer HTML-Datei ermitteln. Das Beispiel enthält zunächst HTML-Text mit diversen Verweisen und schreibt am Ende mit document.write() dazu, wie viele Verweise in der Datei gefunden wurden. Beachten Sie, daß dabei (seit Netscape 3.0) auch Verweise berücksichtigt werden, die in verweis-sensitiven Grafiken mit Hilfe des `<area>`-Tags definiert werden.

## Zugriff auf Verweisziele

Sie können mit JavaScript die Verweisziele von Verweisen in HTML ermitteln.

### Beispiel:

    <html><head><title>Test</title>
    </head><body>
    <a href="http://www.yahoo.de/">Yahoo</a><br>
    <a href="http://www.lycos.de/">Lycos</a><br>
    <a href="http://www.excite.de/">Excite</a><br>
    <p>
    <script language="JavaScript">
    for(i=0; i < document.links.length; ++i)
     document.write("<br>" + document.links[i]);
    </script>
    </body></html>

### Erläuterung:

Im Beispiel werden ein paar Verweise notiert. Unterhalb davon steht ein JavaScript, das mit document.write() in einer for-Schleife für jeden Verweis das Verweisziel in die Datei schreibt. Es handelt sich um denjenigen Wert, der bei den Verweisen hinter `href=` notiert ist.

Der Zugriff auf die Verweise erfolgt mit Indexnummern. Dabei geben Sie `document.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 sprechen Sie mit `links[0]` an, den zweiten Verweis mit `links[1]` usw. Beim Zählen gilt die Reihenfolge, in der die Verweise in der Datei notiert sind. Dabei werden auch Verweise innerhalb von verweis-sensitiven Grafiken (`<area>`-Tag) berücksichtigt.

weiter: | event
zurück: | layers

SELFHTML/Quickbar JavaScript Objekt-Referenz

© 1998 Stefan Münz, muenz@csi.com