모양의 사용자가 파일을 업로드 할 수 있는 입력필드를 생성하고 참조한다.

	Script	[propVal=]formObj.FileUploadObj.propName;
	HTML	<INPUT type="file" propName="propVal">innerString</INPUT>

인수

propertyName : (속성명)

아래 속성들 중의 하나이다. 메서드들, 이벤트처리자들도 이에 준한다.

사용

form 개체에서 사용자가 파일을 업로드 할 수 있는 필드에서 파일명을 입력하고 서버에 업로드 하여 인터랙티브(Interactive)하게 원하는 기능을 수행하게 하는데 사용된다.

생성

FileUpload 개체는 HTML form 개체의 <INPUT type=file>에 해당되는 것으로서 HTML 태그로 생성된다.

<INPUT type=file>

구성

form 개체의 다른 입력 element 개체들과 함께 모체 form 개체에 elements 배열변수에 등록되고, HTML 태그에서 지정된 이름(name)이나 일반 배열변수 접속 방식으로 호출된다.

호출

다른 form 개체들과 마찬가지로 의 forms 개체에서 개체명칭(formObj.fileObj.propertyName 식)이나 배열변수 인수(index)로 호출하면 된다.

특기

파일이 업로드되기 위해서는:

• INPUT type=file 엘레멘트가 FORM 엘레멘트 속에 있어야 한다.
• INPUT type=file 엘레멘트의 name 애트리뷰트에 대한 value 값이 지정되어야 한다.
• FORM 엘레멘트는 Method 애트리뷰트 post로 설정되어야 한다.
• FORM 엘레넨트의 enctype 애트리뷰트는 multipart/form-data로 설정되어야 한다.

서버에 파일을 업로드하기 위해서는 서버사이드에서 송신된 데이터를 multipart/form-data로 처리할 수 있도록 프로세스가 작동되어야 한다. 예를들어 Microsoft Posting Acceptor가 IIS(Internet Information Server)로 하여금 업로드된 파일을 받아 들일수 있어야 한다. 추가적으로 multipart/form-data를 처리할 수 있는 CGI(Common Gateway Interface) 스크립트도 웹에서 사용할 수 있다.

이 개체는 스크립트를 포함하여 IE4.0부터 적용된다.
IE3.02에서는 INPUT type=file를 위한 업로드 추가프로그램(add-on)이 필요하다.

업로드 파일의 선택은 사용자가 문자 입력 필드에 경로와 파일명을 입력하거나 찾아보기 단추를 눌러 파일시스템에서 선택하면 된다.

파일이 업로드될 때 파일 이름도 송신된다. 지역 피씨의 안전 지역에 경로나 파일이 있어야 한다. value 속성은 지역 피씨의 안전지대 밖에 있는 파일에서만 반환된다.

이 엘레멘트는 인라인 엘레멘트이다.

이 엘레멘트는 종료태그를 필요로 하지 않는다.

참조

이 개체는 (영문)HTML3.2에서 정의되었다.

object ⇒

FileUpload⇒

⇒

FileUpload 설명을 위한 예제

object ⇒

FileUpload⇒

⇒

object ⇒

FileUpload⇒

⇒

object ⇒

FileUpload⇒

⇒

accept 속성 IE5 -
⇒ FileUpload개체를의 접속(accept) 문자열을 반환하거나 설정한다.

문법: FileUploadObj.accept[=sVal]

코드: document.write(document.forms[0].name+' | '+document.forms[0].elements[0].accept) 결과: formObj |

form(개체) 속성 IE NS
⇒ FileUpload 개체를 포함하는 form 개체를 반환한다.

문법: [oVal=]FileUploadObj.form

코드: document.write(document.forms[0].name+' | '+document.forms[0].elements[0].type) 결과: formObj | text

name 속성 IE NS (<INPUT type="file" name="sVal"> 애트리뷰트)
⇒ FileUpload 개체이 이름을 반환하거나 설정한다.

문법: FileUploadObj.name[=sVal]

코드: document.write(oObj.name); 결과: fileObj

size 속성 IE3.02 NS2 (<INPUT type="file" size="iVal"> 애트리뷰트)
⇒ FileUpload 개체의 입력 필드의 보이는 글자수를 반환하거나 지정한다.

문법: FileUploadObj.size=iVal]

코드: document.write(oObj.size) 결과: 60

type 속성 IE4 NS3 (<INPUT type="file"> 애트리뷰트)
⇒ FileUpload 개체에 의하여 제공된 제어 형식을 반환하거나 지정한다. 속성값은 항상 'file'이다.

문법: FileUploadObj.type[=sVal]

코드: document.write(document.formObj.fileObj.type) 결과: file

value 속성 IE3.02 NS2 (<INPUT type="file" value="vVal"> 애트리뷰트)
⇒ FileUpload 개체의 값(value)을 반환하거나 설정한다. 사용자가 업로드를 위하여 입력하거나 선택한 문자열이다.

문법: FileUploadObj.value[=sVal]

코드: 예제에서 <INPUT type="file" ... onChange="valueShow.innerHTML=this.value+', size='+this.size"> <SPAN id="valueShow"></SPAN>
결과: 위 예제에서 파일을 선택하고 이곳을 확인하라.

object ⇒

FileUpload⇒

⇒

object ⇒

FileUpload⇒

⇒

object ⇒

FileUpload⇒

⇒

메서드	설명
addBehavior	엘레멘트에 behavior를 추가한다.
appendChild	개체의 자식개체로 한 엘레멘트를 추가한다.
applyElement	개체를 다른 엘레멘트의 자식이나 모체 개체로 만든다.
attachEvent	IE - 이벤트에 특정 기능을 묶어, 기능함수가 개체에서 이벤트가 발생되면 언제나 호출되게 한다. 이벤트의 제거는 detachEvent에서 한다. 반환값은 부울값이다. 문법: [bVal=]FileUploadObj.object.attachEvent(event,functObj) event는 필수요소이고, 표준 이벤트 문자열이다. functObj도 필수요소이고 이벤트가 발생되면 호출될 기능함수이다. 코드: function callFunc(){alert('ondblclick 이벤트 발생')}document.attachEvent('ondblclick',callFunc) 결과: // 문서 위 아무데서나 더블클릭 해 보라. 코드:<INPUT type=button value="attachEvent 재설정" onclick="document.detachEvent('ondblclick',callFunc);document.attachEvent('ondblclick',callFunc)"></SPAN> 결과:
blur	IE NS FileUpload 개체에서 초점(focus)을 제거하여 onblur 이벤트가 발생한다. 문법: FileUploadObj.blur()
clearAttributes	FileUpload 개체의 모든 애트리뷰트들과 값들을 삭제한다.
click	IE NS FileUpload 개체를 클릭하는 작용을 하여 onclick 이벤트가 발생된다. 문법: FileUploadObj.click() 코드: oObj.click()
cloneNode	문서 계통도로부터 FileUpload 개체의 참조를 복사한다.
componentFromPoint	어떤 이벤트에서 지정된 좌표에 위치한 콤포넨트를 반환한다.
contains	FileUpload 개체 속에 주어진 엘레멘트가 있는가를 점검한다.
detachEvent	IE5 - attachEvent 이벤트로 첨부된 이벤트를 제거한다. 반환값은 없다. 문법: FileUploadObj.detachEvent(event,funcion) 코드: <INPUT type=button value="detachEvent" onclick="document.detachEvent('ondblclick',callFunc)"></SPAN> 결과: // 클릭 후에는 attachEvent에서 설정된 이벤트가 제거된다. 제거 후 더블클릭해 보라.
dragDrop	ondragstart 이벤트를 시작한다.
fireEvent	FileUpload 개체에서 지정한 이벤트를 발생시킨다.
focus	FileUpload 개체에 초점을 주고 onfocus이벤트에 지정한 처리자 코드를 수행한다. 문법: FileUploadObj.focus()
getAdjacentText	개체의 인접 문자열을 반환한다.
getAttribute	지정된 애트리뷰트의 값을 반환한다.
getAttributeNode	IE6 attribute.name속성을 참조하는 attribute 개체를 반환한다.
getBoundingClientRect	TextRectangle 개체들의 컬렉션에 연결됨을 지정하는 개체를 반환한다.
getClientRects	개체의 내용이나 클라이언트 범위(range)의 배치(layout)를 기술하는 사각형(rectangle)들의 컬렉션을 반환한다. 각 사각형은 한 줄이다.
getExpression	주어진 속성의 표현(expression)을 반환한다.
handleEvent	- NE4 지정된 개체의 FileUpload 개체의 이벤트처리자를 호출한다. 문법: FileUploadObj.handleEvent(event)
hasChildNodes	개체가 자식개체를 가지고 가지고 있는가를 나타내는 값을 반환한다.
insertAdjacentElement	지정한 위치에 엘레멘트를 삽입한다.
insertAdjacentHTML	엘레멘트의 지정된 위치에 주어진 HTML 문자열을 삽입한다.
insertAdjacentText	엘레멘트의 지정된 위치에 주어진 문자열을 삽입한다.
insertBefore	문서 계통도에서 모체 개체의 자식 노드로 엘레멘트를 삽입한다.
mergeAttributes	지정된 개체에 모든 읽기/쓰기 애트리뷰트를 복사한다.
normalize	IE6 FileUpload 개체의 인접 TextNode 개체를 통합하여 문서 개체 모델을 정상화한다.
releaseCapture	현재 문서의 FileUpload 개체로 부터 마우스 캡쳐를 제거한다.
removeAttribute	FileUpload 개체로 부터 애트리뷰트를 제거한다.
removeAttributeNode	IE6 FileUpload 개체로 부터 애트리뷰트 개체 노드를 제거한다.
removeBehavior	FileUpload 개체로부터 behavior를 제거한다.
removeChild	FileUpload 개체로부터 자식 노드를 제거한다.
removeExpression	지정한 속성으로부터 표현(expression)을 제거한다.
removeNode	문서 계통도에서 FileUpload 개체를 제거한다.
replaceAdjacentText	개체에 인접 문자열을 교체한다.
replaceChild	현재의 자식 엘레멘트를 새로운 자식 엘레멘트로 교체한다.
replaceNode	FileUpload 개체를 다른 엘레멘트로 교체한다.
scrollIntoView	FileUpload 개체를 보기게 굴림(scroll)하고 윈도우의 맨위나 아래에 정렬한다.
select	IE3.02 NS2 FileUpload 개체를 입력 필드의 내용을 선택하고 선택부분은 반전된다. 문법: FileUploadObj.select()
setActive	FileUpload 개체에 초점을 주지 않은 상태에서 활성으로 설정한다.
setAttribute	지정된 애트리뷰트를 설정한다.
setAttributeNode	IE6 FileUpload 개체의 부분으로 애트리뷰트 개체 노드를 설정한다.
setCapture	현재 문서에 소속된 FileUpload 개체의 마우스 캡쳐를 설정한다
setExpression	지정된 개체의 표현(expression)을 설정한다.
swapNode	문서 계통도에서 두 개체의 위치를 서로 바꾼다.

object ⇒

FileUpload⇒

⇒

이벤트	설명
onactivate	엘레멘트 개체가 activeElement 속성으로 설정되면 발생한다.
onbeforeactivate	IE6 엘레멘트 개체가 activeElement 속성으로 설정되기 바로 전에 발생한다.
onbeforecut	문서로 부터 선택한 부분의 잘라내기 하기 바로 전에 원본 개체에 발생한다.
onbeforedeactivate	모체 문서에서 activeElement 속성의 엘레멘트 개체가 현재 개체로 다른 개체로 변경되기 바로 전에 발생한다.
onbeforeeditfocus	편집 가능한 개체가 활성화되거나 편집 가능한 용기에 제어 선택이 이루어 지기 바로 전에 발생한다.
onbeforepaste	시스템 클립보드(잘라낸거나 복사한 내용이 있는)로부터 문서의 목표개체에 붙여 넣기 바로 전에 발생한다.
onblur	IE4 NS3 FileUpload 개체가 초점을 생실했을 때 발생한다. 문법: FileUploadObj.onblur='JsCode'
onclick	FileUpload 개체에서 마우스를 클릭(눌럿다 놓음)하면 발생되고 지정된 JsCode를 수행한다. 문법: FileUploadObj.onclick='JsCode'
onchange	FileUpload 개체의 내용이 변경되고 초점을 잃어 onChange(변경이 생김) 이벤트가 발생되면 지정된 JsCode를 수행한다. 문법: FileUploadObj.onchange='JsCode'
oncontextmenu	클라이언트 지역에서 오른쪽 마우스 단추를 클릭하였을 때나 콘텍스트(context) 메뉴를 열었을 때 발생
oncontrolselect	사용자가 개체의 제어 선택을 하려고 할 때 발생한다.
oncut	문서의 선택한 내용을 잘라 시스템 클립보드(잘라낸거나 복사한 내용이 있는)에 넣을 때 원본 개체에 발생
ondblclick	FileUpload 개체에서 마우스를 연속 두번 클릭하면 발생되고 지정된 JsCode를 수행한다. 문법: FileUploadObj.ondblclick='JsCode'
ondeactivate	모체 문서에서 activeElement 속성의 엘레멘트 개체가 현재 개체로 다른 개체로 변경되면 발생한다.
ondrag	연속 끌기 동작이 진행되는 동안 원본 개체에 발생한다.
ondragend	연속 끌기 동작에서 마우스를 해제하여 진행이 완료되면 원본 개체에 발생한다.
ondragenter	연속 끌기 동작에서 성공적인 끌어 놓기가 완료면 목표 개체에 발생한다.
ondragleave	연속 끌기 동작에서 성공적인 끌어 놓기가 완료되어 목표 개체를 이탈하면 목표 개체에 발생한다.
ondragover	연속 끌기 동작에서 유효한 목표 개체 위에 있는 동안 연속적으로 목표 개체에 발생한다.
ondragstart	연속 끌기 동작에서 선택한 텍스트나 개체를 끌기 시작하면 원본 개체에 발생한다.
ondrop	연속 끌기 동작에서 마우스 단추를 해제하면 목표 개체에 발생한다.
onfilterchange	시각적 필터 상태를 변경하거나 변경이 완료되면 발생한다.
onfocus	IE NS FileUpload 개체가 초점을 받으면 발생되고 JsCode를 수행한다. 문법: FileUploadObj.onfocus='JsCode'
onfocusin	IE6 엘레맨트에 초점을 조기 바로 전에 엘레멘트에 발생한다.
onfocusout	IE6 다른 엘레맨트로 초점을 이동하면 바로 현재 엘레멘트에 발생한다.
onhelp	활성 윈도우에서 도움말을 위하여 F1 키를 누르면 발생된다.
onkeydown	FileUpload 개체에서 자판(key)을 누르면 발생되고 지정된 JsCode를 수행한다. 문법: FileUploadObj.onkeydown='JsCode'
onkeypress	FileUpload 개체에서 자판(key)을 누르고 있으면 발생되고 지정된 JsCode를 수행한다. 문법: FileUploadObj.onkeypress='JsCode'
onkeyup	FileUpload 개체에서 자판(key) 누름을 해제하면 발생되고 지정된 JsCode를 수행한다. 문법: FileUploadObj.onkeyup='JsCode'
onlosecapture	개체가 마우스 캡쳐(capture)를 해제하면 발생한다.
onmousedown	FileUpload 개체에서 마우스 단추를 눌렀을 때 발생되고 지정된 JsCode를 수행한다. 문법: FileUploadObj.onmousedown='JsCode'
onmouseenter	마우스 포인터가 개체 위로 이동하면 발생한다.
onmouseleave	마우스 포인터가 개체 밖으로 이동하면 발생한다.
onmousemove	마우스 포인터가 개체 위에서 이동하면 발생한다.
onmouseout	마우스 포인터가 개체 밖으로 이동하면 발생한다.
onmouseover	마우스 포인터가 개체 위로 이동하면 발생한다.
onmouseup	FileUpload 개체에서 단추 누름을 해제하면 발생되고 지정된 JsCode를 수행한다. 문법: FileUploadObj.onmouseup='JsCode'
onmousewheel	IE6 마우스 휠(wheel)을 굴리면 발생한다.
onmove	개체가 이동하면 발생한다.
onmoveend	개체의 이동이 중지되면 발생한다.
onmovestart	개체가 이동하기 시작하면 발생한다.
onpaste	시스템 클립보드(잘라낸거나 복사한 내용이 있는)로부터 문서의 목표개체에 붙여 넣으면 발생한다.
onpropertychange	개체의 속성을 변경발생한다.
onreadystatechange	개체의 준비상태(readyState) 속성을 변경시키면 발생한다.
onresize	윈도우나 프레임이등 개체의 크기가 조정되었 때 발생한다
onresizeend	제어 섹션에서 개체의 크기 변경이 완료되면 발생한다.
onresizestart	제어 섹션에서 개체의 크기 변경이 시작되면 발생한다.
onselectstart	개체가 선택되기 시작하면 발생한다.
ontimeerror	일반적으로 유효하지 않은 값의 결과에 의하여, 시간을 지정하는 오류가 일어나면 발생된다.

object ⇒

FileUpload⇒

⇒

object ⇒

FileUpload⇒

⇒

FileUpload 개체 cgi 처리 예제

<FORM name="oForm" action="http://koxo.com/lang/js/object/exp/xsubmit.cgi" enctype="multipart/form-data" method="post">
<INPUT type="file" name="uploadObjName">
<INPUT type="submit" value="파일 업로드">
</FORM>

FileUpload 개체 asp 처리 예제

<FORM name="expForm2" action="http://koxo.com/lang/js/object/exp/xfileUpload.asp" enctype="multipart/form-data" method="post">
<INPUT type="file" name="uploadObjNameAsp">
<INPUT type="submit" value="파일 업로드">

ASP(Active Server Page)에서 INPUT type=file 엘레멘트로 서버에 파일을 업로드 처리하는 방식을 보여준다. 당 서버는 asp가 되지 않아 소스만 제공한다.

IIS나 or Personal Web Server에서 사용될 수 있는 Microsoft Posting Acceptor가 필요하며, 송신된 데이터는 Posting Acceptor에 설치되어 있는 Cpshost.dll 보내진다.

xfileUpload.asp 파일 내용
<%@ LANGUAGE=javascript %>
<%Response.buffer=true;%>
<HTML>
<TITLE>Repost Example</TITLE>
<BODY>
<H4>Upload Status</H4>
<P>
Destination: <B><% Response.Write(Request.Form("TargetURL"))%></B>
</P>
<%
  Response.write("<P>Name: "+Request.Form("FileName")+"</P>");
  Response.write("<P>Size: "+Request.Form("FileSize")+"</P>");
  Response.write("<P>Path: "+Request.Form("FilePath")+"</P>");
%>
</BODY>
</HTML>

FileUpload 예제

object ⇒

FileUpload

⇒

최종 수정: 05/16/2025 09:53:59

All right reserved

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

http://koxo.com/lang/js/object/FileUpload.html