NAME Attribute | name Property

Internet Development Index

Sets or retrieves the frame name.

Syntax

HTML<ELEMENT NAME = sName... >
Scriptingobject.name [ = sName ]

Possible Values

sNameString that specifies or receives an arbitrary name used to identify the object.

The property is read/write. The property has no default value.

Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see About Dynamic Properties.

Remarks

The name property identifies which frame displays the content of a linked document.

Examples

This example uses scripting to set the name property of a frame.

parent.frames[0].name="Left";

This example shows how the NAME attribute for a window can be persisted in HTML, but only when defined in a frame within a freamset.

<FRAMESET>
<FRAME NAME="Left" SRC="blank.htm">
<FRAME NAME="Right" SRC="contents.htm">
</FRAMESET>

Standards Information

This property is defined in HTML 4.0 Non-Microsoft link and is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 Non-Microsoft link.

Applies To

FRAME, FRAMESET, IFRAME