Properti HTMLImageElement.name
menetapkan atau mengembalikan atribut NAME elemen IMG HTML.
Sintaks:
imageObj.name = value
imageObj.name
value adalah DOMString yang didalamnya harus diawali dengan huruf di dalam cakupan A-Z atau a-z dan bisa diikuti dengan huruf (A-Za-z), digit (0-9), tanda penghubung ("-"), tanda garis bawah ("_"), tanda titik dua (":"), dan titik (".").
Contoh di bawah ini mengembalikan nilai atribut NAME:
<IMG ID="imgID" SRC="image.jpg" WIDTH="50" HEIGHT="50" NAME="imageName">
<SCRIPT TYPE="text/javascript">
var imgObj = document.getElementById("imgID");
alert(imgObj.name); // "imageName"
</SCRIPT>
Contoh di bawah ini menetapkan atribut NAME:
<IMG ID="imgID" SRC="image.jpg" WIDTH="50" HEIGHT="50">
<SCRIPT TYPE="text/javascript">
var imgObj = document.getElementById("imgID");
imgObj.name = "imageName";
</SCRIPT>
Elemen IMG di atas akan menjadi:
<IMG ID="imgID" SRC="image.jpg" WIDTH="50" HEIGHT="50" NAME="imageName">