W3Schools.com

Document links Collection

Document Object Reference Document Object

Definition and Usage

The links collection returns an array of all the links in the current document.

Tip: The links collection counts <a href=""> tags and <area> tags.

Syntax

document.links[].property


Browser Support

Internet Explorer Firefox Opera Google Chrome Safari

The links collection is supported in all major browsers.


Examples

Example 1

Return the number of links in the document:

<html>
<body>

<img src ="planets.gif" width="145" height="126" alt="Planets" usemap ="#planetmap" />
<map name="planetmap">
<area shape="rect" coords="0,0,82,126" href="sun.htm" alt="Sun" />
<area shape="circle" coords="90,58,3" href="mercur.htm" alt="Mercury" />
<area shape="circle" coords="124,58,8" href="venus.htm" alt="Venus" />
</map>

<p><a href="/js/">JavaScript Tutorial</a></p>

<p>Number of areas/links:
<script type="text/javascript">
document.write(document.links.length);
</script></p>

</body>
</html>

The output of the code above will be:

Number of areas/links: 4

Try it yourself »

Example 2

Return the id of the first link in the document:

<html>
<body>

<img src ="planets.gif" width="145" height="126" alt="Planets" usemap ="#planetmap" />
<map name="planetmap">
<area id="sun" shape="rect" coords="0,0,82,126" href="sun.htm" alt="Sun" />
<area id="mercury" shape="circle" coords="90,58,3" href="mercur.htm" alt="Mercury" />
<area id="venus" shape="circle" coords="124,58,8" href="venus.htm" alt="Venus" />
</map>

<p><a id="javascript" href="/js/">JavaScript Tutorial</a></p>

<p>Id of first area/link:
<script type="text/javascript">
document.write(document.links[0].id);
</script></p>

</body>
</html>

The output of the code above will be:

Id of first area/link: sun

Try it yourself »


Document Object Reference Document Object

W3Schools Certification

W3Schools' Online Certification

The perfect solution for professionals who need to balance work, family, and career building.

More than 10 000 certificates already issued!

Get Your Certificate »

The HTML Certificate documents your knowledge of HTML.

The CSS Certificate documents your knowledge of advanced CSS.

The JavaScript Certificate documents your knowledge of JavaScript and HTML DOM.

The jQuery Certificate documents your knowledge of jQuery.

The XML Certificate documents your knowledge of XML, XML DOM and XSLT.

The ASP Certificate documents your knowledge of ASP, SQL, and ADO.

The PHP Certificate documents your knowledge of PHP and SQL (MySQL).

WEB HOSTING
Best Web Hosting
PHP MySQL Hosting
Best Hosting Coupons
UK Reseller Hosting
Cloud Hosting
Top Web Hosting
$7.95/mo SEO Hosting
Premium Website Design
WEB BUILDING
Download XML Editor
FREE Website BUILDER
Free Website Templates Free CSS Templates
Make Your Own Website
W3SCHOOLS EXAMS
Get Certified in:
HTML, CSS, JavaScript, XML, PHP, and ASP
W3SCHOOLS BOOKS
New Books:
HTML, CSS
JavaScript, and Ajax
STATISTICS
Browser Statistics
Browser OS
Browser Display
SHARE THIS PAGE