Sets or retrieves the frame name.

Syntax

HTML	<ELEMENT NAME = sName... >
Scripting	[ sName = ] object.name

Possible Values

sName

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

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

DHTML expressions can be used in place of the preceding value(s). As of Internet Explorer 8, expressions are not supported in IE8 mode. 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  and is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 .

Applies To

FRAME, FRAMESET, IFRAME, HTMLFrameElement Constructor, HTMLFrameSetElement Constructor, HTMLIFrameElement Constructor