FileUpload object (Object/DOM)

A text field in a form for entering the name of a file to be uploaded to the server.

Availability:

DOM level - 1
JavaScript - 1.0
JScript - 3.0
Internet Explorer - 4.0
Netscape - 2.0
Opera - 3.0
Inherits from:Input object
JavaScript syntax:-myFileUpload = myDocument.aFormName.anElementName
-myFileUpload = myDocument.aFormName.elements[anItemIndex]
IEmyFileUpload = myDocument.all.anElementID
IEmyFileUpload = myDocument.all.tags("INPUT")[anIndex]
IEmyFileUpload = myDocument.all[aName]
-myFileUpload = myDocument.forms[aFormIndex].anElementName
-myFileUpload = myDocument.forms[aFormIndex].elements[anItemIndex]
-myFileUpload = myDocument.getElementById(anElementID)
-myFileUpload = myDocument.getElementsByName(aName)[anIndex]
-myFileUpload = myDocument.getElementsByTagName("INPUT")[anIndex]
HTML syntax:<INPUT TYPE="file">
Argument list:anItemIndexA reference to an element in a collection
anIndexA reference to an element in a collection
aNameAn associative array reference
anElementIDThe ID value of an Element object
aFormIndexA reference to one specific form in the collection
Object properties:accept, size, type, value
Object methods:handleEvent(), select()
Event handlers:onAfterUpdate, onBeforeUpdate, onBlur, onChange, onDragStart, onFilterChange, onFocus, onHelp, onKeyDown, onKeyPress, onKeyUp, onMouseDown, onMouseMove, onMouseOut, onMouseOver, onMouseUp, onResize, onRowEnter, onRowExit, onSelect, onSelectStart

Many properties, methods and event handlers are inherited from the Input object class. Refer to topics grouped with the "Input" prefix for details of common functionality across all subclasses of the Input object superclass.

There isn't really a FileUpload object class, but it is helpful when trying to understand the wide variety of input element types, if we can reduce the complexity by discussing only the properties and methods of a file upload. In actual fact, the object is represented as an item of the Input object class.

Unlike MSIE, Netscape Navigator does not support the defaultValue property or the select() method for this subclass of the Input object.

Warnings:

See also:Element object, FileUpload.handleEvent(), Form.elements[], Input object, Input.accessKey, onChange, UniversalFileRead

PropertyJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
accept n/a5.0 5.0 n/a5.0 5.0 n/a n/a n/a n/a n/a n/a-
size1.0 1.03.0 3.02.0 2.04.0 4.0 n/a n/a n/a n/a n/a n/a-
type1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a1 1 n/a n/aReadOnly
value1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a1 1 n/a n/a-

MethodJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
handleEvent()1.2 1.2 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a n/a-
select()1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a1 1 n/a n/a-

Event nameJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
onAfterUpdate n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onBeforeUpdate n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onBlur1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a n/a n/a n/aWarning
onChange1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a n/a n/a n/a-
onDragStart n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onFilterChange n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onFocus1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a n/a n/a n/aWarning
onHelp n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aWarning
onKeyDown1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onKeyPress1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onKeyUp1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseDown1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseMove1.2 1.23.0 3.04.0 4.04.0 4.0 n/a n/a n/a n/a n/a4.0 4.0Warning
onMouseOut1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseOver1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onMouseUp1.2 1.23.0 3.04.0 4.04.0 4.03.0 3.0 n/a n/a n/a n/a4.0 4.0Warning
onResize1.2 1.23.0 3.04.0 4.04.0 4.0 n/a n/a n/a n/a n/a n/aWarning
onRowEnter n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onRowExit n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
onSelect1.0 1.03.0 3.02.0 2.04.0 4.03.0 3.0 n/a n/a n/a n/a n/a-
onSelectStart n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-

Inheritance chain:

Element object, Input object, Node object