Definition and Usage

The name property sets or returns the value of the name attribute of an image.

The name attribute is used to reference elements in a JavaScript, or to reference form data after a form is submitted.

Note: Only form elements with a name attribute will have their values passed when submitting a form.

Syntax

Return the name property:

imageObject.name

Set the name property:

imageObject.name = name

Property Values

Value	Description
name	Specifies the name of the image.

Technical Details

Return Value:	A String, representing the name of the image.
DOM Version	Core Level 2 Document Object

Examples

Example 1

Return the name of an image:

<img id="myImg" src="smiley.gif" name="smiley" width="30" height="30">
<script>
var x = document.getElementById("myImg").name;
document.write("The name of the image is: " + x);
</script>

Output:

var x = document.getElementById("myImg").name;
document.write("The name of the image is: " + x);

Example 2

Change the name of an image:

<img id="myImg" src="smiley.gif" name="smiley" width="30" height="30">
<button onclick="myFunction()">Change Image Name</button>
<script>
function myFunction() {
    document.getElementById("myImg").name = "newImageName";
    alert("Image name changed to: " + document.getElementById("myImg").name);
}
</script>

Change Image Name

function myFunction() { document.getElementById("myImg").name = "newImageName"; alert("Image name changed to: " + document.getElementById("myImg").name); }

<Previous | Next>

Related Pages

HTML DOM Reference: HTML DOM Image Object