name (HTML attribute)

Spec
Depr. Version
No HTML 4.01
Browser support (more…)
IE5.5+ FF1+ SA1.3+ OP9.2+ CH2+
Full Full Full Full Full

Syntax

name="Unique name identifier for frame"

Description

The frame’s name attribute provides a mechanism for referencing the frame (and hence its content), perhaps for the purposes of client-side scripting - referencing values that may be stored in JavaScript variables in other windows, for example, or to get access to the window so that the document can be interrogated or adapted using the Document Object Model (DOM). However, the main reason for applying a name attribute is so that a link from one frame can be directed to another frame, e.g.

<a href="summer.html" target="main">Summertime is the best!</a>

If the markup above were in the frame named "nav", clicking on the link to the page about summertime would load the page, "summer.html", in the other frame named "main".

Example

The name attribute provides a way of referencing form data:
<frameset rows="100,*">
  <frame src="header.html" frameborder="1"
      name="nav" title="Navigation window"/>
  <frame src="home.html" frameborder="0"
      name="main" title="Main window" longdesc="main-description.txt"/>
</frameset>

Value

Any name that the developer chooses (not containing spaces or special characters).

Compatibility

Internet Explorer Firefox Safari Opera Chrome
5.5 6.0 7.0 8.0 1.0 1.5 2.0 3.0 3.5 1.3 2.0 3.1 4.0 9.2 9.5 10.0 2.0
Full Full Full Full Full Full Full Full Full Full Full Full Full Full Full Full Full

It causes no compatibility issues, and has excellent support across all tested browsers.

User-contributed notes

There are no comments yet.

Related Products