개체의 이름을 반환하거나 설정한다.

	Script	object.name=[sVal]
	HTML	<ELEMENT name="sVal">

인수

sVal : (속성 문자열)

name 속성값은 개체의 이름을 나타내는 문자열이다.

이 속성은 읽기/쓰기이며 디폴트값은 없다.

특기

form을 송신할 때 name 속성을 제어값에 결합하는데 사용한다.
name은 input type=button, input type=reset, input type=submit 입력 형식에서 디스플레이되는 값이 아니고 form이 송신될 때 보내지는 값이다.

JScript에서 런타임에 name 속성값을 변경시킬 수 있다. 그러나 엘레멘트들의 컬렉션에 프로그램으로 변경을 주지 않고 form이 송신될 때만 이름이 바뀐다.

createElement 메서드를 이용하여 탄력적으로 생성된 엘레맨트에서는 name 속성값을 런타임에 변경시킬 수 없다. createElement 메서드를 이용하여 엘레멘트를 생성할 때 name 속성을 값과 함께 설정한다.

이속성은 IE6부터 attribute 개체에도 적용된다.

적용

개체	script	HTML	규격	IE
a	a.name[=sVal]	<A name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
applet	applet.name[=sVal]	<APPLET name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
attribute	attribute.name[=sVal]	없음	없음	IE6(win32)
button	button.name[=sVal]	<BUTTON name="sVal">	HTML	IE4.0(win16,win32,ce,unix,mac)
embed	embed.name[=sVal]	<EMBED name="sVal">	없음	IE3.02(win16,win32,mac),IE4.0(ce,unix)
form	form.name[=sVal]	<FORM name="sVal">	없음	IE3.02(win16,win32,mac),IE4.0(ce,unix)
img	img.name[=sVal]	<IMG name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
button	button.INPUT_button[=sVal]	<INPUT type=button name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
checkbox	checkbox.name[=sVal]	<INPUT type=checkbox name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
FileUpload	FileUpload.name[=sVal]	<INPUT type=file name="sVal">	HTML	IE4.0(win16,win32,ce,unix,mac)
hidden	hidden.name[=sVal]	<INPUT type=hidden name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
image	image.name[=sVal]	<INPUT type=image name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
password	password.name[=sVal]	<INPUT type=password name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
radio	radio.name[=sVal]	<INPUT type=radio name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
reset	reset.name[=sVal]	<INPUT type=reset name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
submit	submit.name[=sVal]	<INPUT type=submit name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
text	text.name[=sVal]	<INPUT type=text name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
link	link.name[=sVal]	<LINK name="sVal">	없음	IE3.02(win16,win32,mac),IE4.0(ce,unix)
map	map.name[=sVal]	<MAP name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
Object	Object.name[=sVal]	<OBJECT name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
rt	rt.name[=sVal]	<RT name="sVal">	없음	IE5(win16,win32,unix,mac)
ruby	ruby.name[=sVal]	<RUBY name="sVal">	없음	IE5(win16,win32,unix,mac)
select	select.name[=sVal]	<SELECT name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)
textArea	textArea.name[=sVal]	<TEXTAREA name="sVal">	HTML	IE3.02(win16,win32,mac),IE4.0(ce,unix)

참고

이 속성은 (영문) HTML 3.2와 (영문) W3C DOM Level 1(Document Object Model)에서 정의되었다.

property ⇒

name 속성⇒

A 엘레멘트를 생성하고 표시하는 예제

<SCRIPT>
var aObj=document.createElement('A');
aObj.href='http://trio.co.kr/webrefer/html/cover.html';
aObj.name='htmlStd';
aObj.target='_newWin';
aObj.innerText='HTML 규격으로';
str='aObj.nodeName=<FONT color=blue>'+aObj.nodeName+'</FONT><BR>';
str+='aObj.name=<FONT color=blue>'+aObj.name+'</FONT><BR>';
str+='aObj.target=<FONT color=blue>'+aObj.target+'</FONT><BR>';
str+='aObj.href=<FONT color=blue>'+aObj.href+'</FONT><BR>';
str+='aObj.innerText=<FONT color=blue>'+aObj.innerText+'</FONT><BR>';
str+='aObj=<FONT color=blue>'+aObj+'</FONT><BR>';
str+='aObj.outerHTML=<FONT color=blue>'+aObj.outerHTML+'</FONT><BR>';
document.write(str);
</SCRIPT>

name 속성 예제

<DIV class=show>
<FORM name=testForm><IMG src=../../gif/rfexample.gif name=testImage>
<INPUT type=text value="testText" name="testText">
<INPUT type=button value="testInput" name="testInput">
</FORM>
</DIV>

<SCRIPT>
var br='<BR>';
document.write('top.frames[0].name='+top.frames[0].name+br);
document.write('top.frames[1].name='+top.frames[1].name+br);
document.write('top.frames[1].frames[0].name='+top.frames[1].frames[0].name+br);
document.write('top.frames[1].frames[1].name='+top.frames[1].frames[1].name+br);
document.write('this.name='+this.name+br+br);

top.window.name='Javascript';
document.write('top.window.name='+top.window.name+br);
document.write('document.images[document.images.length-1].name=',
  document.forms[document.images.length-1].name+br+br);

document.write('document.forms[document.forms.length-1].name=',
  document.forms[document.forms.length-1].name+br);
document.write('document.forms[document.forms.length-1].elements[0].name=',
  document.forms[document.forms.length-1].elements[0].name+br);
document.write('document.forms[document.forms.length-1].elements[1].name=',
  document.forms[document.forms.length-1].elements[1].name+br);
</SCRIPT>
<SCRIPT>

윈도우/창 예제

property ⇒

name 속성

⇒

최종 수정: 06/18/2025 21:42:36

All right reserved

비정상적인 방식으로 프레임없이 페이지에 접속하면 자주 오류가 발생됩니다. 오류가 나면 정상적 접속으로 시도해 보세요.

http://koxo.com/lang/js/property/name_elem.html