In order to access this site you need to enable JavaScript!

You are here: Reference > HTML > tags > input:file

input:file element

Browser support:

Creates a file selector object with a single-line text input control and a browse button.

With this control you can allow file uploading to a server. Clicking on the browse button opens the operating system dependent file dialog that allows the user to select a file to upload.

By default, the file selection control only supports single file selection, but with the MULTIPLE attribute, you can allow users to select more than one file with one file selection control.

This control is one of the form controls.

The selected files can be submitted to a server if the following conditions are met:

A form element must contain the file selection control.
The action attribute of the container form must be set to the URL of the server.
The method attribute of the container form must be set to 'post'.
The encType attribute of the container form must be set to 'multipart/form-data'.
The name attribute of the file selection control must be specified and non-empty.

For detailed information about file uploading in PHP, visit these sites: Handling file uploads (php.net), PHP File Upload (w3schools)

If you want to see the HTML tags by categories, please visit this page.

This element cannot have a closing tag.

JavaScript page for this element: input:file.

Possible members:

Attributes

Events

Styles

Pseudos

Sets a comma-separated list of accepted content types.

accessKey

Sets an access key to an element.

class

Sets the style class or classes that belong to the element.

contentEditable

	3

Sets whether the contents of the object are editable.

dir

Sets the text direction as related to the lang attribute.

DISABLED

Sets the state of an object for user interaction.

HIDEFOCUS

Specifies whether a dotted rectangle (focus rectangle) is drawn around an object while it has focus.

hSpace

Specifies the number of pixels to use as a margin at the left and right sides of the object.

Sets a unique identifier for the object.

lang

Specifies the language of the element.

language

Sets the scripting language for the current element. Use it only for the script element.

MULTIPLE

	3.6

Sets whether more than one file can be selected with the current input:file element.

name

Sets the name of a form control that affects the contents of the message submitted to the server.

READONLY

Sets whether the contents of the element are changeable.

size

Specifies the width of a control, in characters.

style

Sets an inline style associated with an element.

tabIndex

Specifies the tabbing order for keyboard navigation using the TAB key.

title

Specifies a tooltip for an element.

type

Sets the type of the input element.

unSelectable


9

Sets whether the selection process can start in an element's content.

vSpace

Specifies the number of pixels to use as a margin at the top and bottom sides of an object.

onActivate

Occurs when an element becomes active.

onBeforeActivate

Occurs before an element becomes active.

onBeforeCopy

Occurs before the selection is copied to the clipboard and before the oncopy event.

onBeforeCut

Occurs before the selection is cut from the document and provides a possibility to enable the Cut menu item.

onBeforeDeActivate

Occurs on the active element before it loses the active state.

onBeforeEditFocus

Occurs before an input:file, input:password, input:text or textarea element or an element in an editable region becomes a UI-activated.

onBeforePaste

Occurs before the contents of the clipboard are pasted into the document and provides a possibility to enable the Paste menu item.

onBlur

Occurs when an element loses focus.

onChange

Occurs when the selection, the checked state or the contents of an element have changed. In some cases, it only occurs when the element loses the focus.

onClick

Occurs when the user clicks on an element.

onContextMenu

Occurs when the right mouse button is clicked on an element and the context menu is shown.

onControlSelect

Occurs before a control is selected in an editable region.

onCopy

Occurs before the selection is copied to the clipboard.

onCut

Occurs before the selection is cut from the document and added to the clipboard.

onDblClick

Occurs when the user double clicks on an element.

onDeActivate

Occurs on the active element when it loses the active state.

onDrag

	3

Occurs periodically on the source element during the drag operation.

onDragEnd

	3

Occurs on the source element when the user has finished the drag operation.

onDragEnter

Occurs on an element when the user moves the mouse pointer into it during a drag operation.

onDragLeave

	3.5

Occurs on an element when the user moves the mouse pointer out of it during a drag operation.

onDragOver

Occurs periodically on an element while the mouse pointer is over it during a drag operation.

onDragStart

	3.5

Occurs on the source element when the user starts the drag operation.

onDrop

	3.5

Occurs on a possible target element when the dragged data is dropped on it.

onFilterChange

Occurs after a filter has changed or finished a transition.

onFocus

Occurs when an element receives focus.

onFocusIn

Occurs before an element receives focus.

onFocusOut

Occurs after an element loses focus.

onHelp

Occurs after the user has pressed the F1 key.

onInput

9

Occurs when the text content of an element is changed through the user interface.

onKeyDown

Occurs on an element that has the focus when a key is pressed down and occurs periodically until the key is released.

onKeyPress

Occurs on an element that has the focus when a key is pressed down and occurs periodically until the key is released.

onKeyUp

Occurs on an element that has the focus when the user releases a key.

onLoseCapture

Occurs when the object loses the mouse capture.

onMouseDown

Occurs when the user presses a mouse button over an element.

onMouseEnter

Occurs when the user moves the mouse pointer into the area of an element.

onMouseLeave

Occurs when the user moves the mouse pointer out of the element.

onMouseMove

Occurs when the user moves the mouse over the element.

onMouseOut

Occurs when the user moves the mouse pointer out of the element.

onMouseOver

Occurs when the user moves the mouse pointer into the element.

onMouseUp

Occurs when the user releases a mouse button over an element.

onMouseWheel

Occurs when the mouse wheel rolls.

onMove

Occurs when the position of an element's top-left corner is changed.

onMoveEnd

Occurs when the user stops dragging an absolute or relative positioned element in an editable region.

onMoveStart

Occurs when the user starts dragging an absolute or relative positioned element in an editable region.

onPaste

Occurs before the contents of the clipboard are pasted into the document.

onPropertyChange

Occurs every time when the value of an element's property is changed.

onReadyStateChange

Occurs when the load state of the data that belongs to an element or a HTML document changes.

onResize

Occurs when the size of an object has changed.

onResizeEnd

Occurs when the user stops resizing an element in an editable region.

onResizeStart

Occurs when the user starts to resize an element in an editable region.

onSelect

Occurs after some text has been selected in an element.

onSelectStart

Occurs at the start of a selection process.

-moz-background-clip

Sets which part of background is visible.

-moz-background-inline-policy

Specifies how the background-image of an inline element is determined when the contents of the inline element wrap onto multiple lines.

-moz-background-origin

Specifies how the background-position property is determined, i.e. it defines the reference point that the background-image is relative to.

-moz-binding

Sets the URL of the XBL (Extensible Binding Language) file containing the binding.

-moz-border-bottom-colors

Sets the border colors for the bottom edge. You can specify as many color values as you want. All specified colors will appear as a 1px thick line.

-moz-border-end

Specifies the color, style and width properties for the end of the element's border, in a shorthand form. Use the border-left property instead.

-moz-border-end-color

Sets the color of the element's border end. Use the border-left-color property instead.

-moz-border-end-style

Sets the style of the element's border end. Use the border-left-style property instead.

-moz-border-end-width

Sets the width of the element's border end. Use the border-left-width property instead.

-moz-border-image

	3.5

Specifies an image to use as the border of the element. The image is sliced into 9 pieces along the four diagonals specified with the length units.

-moz-border-left-colors

Sets the border colors for the left edge. You can specify as many color values as you want. All specified colors will appear as a 1px thick line.

-moz-border-radius

Sets the rounding of the corners of the border.

-moz-border-radius-bottomleft

Sets the rounding of the lower left corner of the border.

-moz-border-radius-bottomright

Sets the rounding of the lower right corner of the border.

-moz-border-radius-topleft

Sets the rounding of the upper left corner of the border.

-moz-border-radius-topright

Sets the rounding of the upper right corner of the border.

-moz-border-right-colors

Sets the border colors for the right edge. You can specify as many color values as you want. All specified colors will appear as a 1px thick line.

-moz-border-start

Specifies the color, style and width properties for the start of the element's border. Use the border-right property instead.

-moz-border-start-color

Specifies the color of the element's border start. Use the border-right-color property instead.

-moz-border-start-style

Specifies the style of the element's border start. Use the border-right-style property instead.

-moz-border-start-width

Specifies the width of the element's border start. Use the border-right-width property instead.

-moz-border-top-colors

Sets the border colors for the top edge. You can specify as many color values as you want. All specified colors will appear as a 1px thick line.

-moz-float-edge

Specifies whether the height and width properties of the element include the margin, border, or padding thickness.

-moz-margin-end

Specifies the width of the left or the right margin, depends on the writing direction.

-moz-margin-start

Specifies the width of the left or the right margin, depends on the writing direction.

-moz-opacity

Sets the opacity level. For a cross-browser solution, use the opacity property in Firefox, Google Chrome, Safari and Opera, and the filter property ('filter:Alpha(opacity=50)') in Internet Explorer.

-moz-outline


	3.6

Sets the outline of the element.

-moz-outline-color


	3.6

Sets the color of the outline.

-moz-outline-offset


	3.6

Sets the amount of space between the outline and the border or the edge of the element.

-moz-outline-radius

Sets the rounding of the outline corners.

-moz-outline-radius-bottomleft

Sets the rounding of the lower left outline corner.

-moz-outline-radius-bottomright

Sets the rounding of the lower right outline corner.

-moz-outline-radius-topleft

Sets the rounding of the upper left outline corner.

-moz-outline-radius-topright

Sets the rounding of the upper right outline corner.

-moz-outline-style


	3.6

Sets the style of the left, right, top, and bottom borders of the object.

-moz-outline-width


	3.6

Sets the width of the outline.

-moz-padding-end

Specifies the space between an element's left or right border and its contents, depending on the writing direction.

-moz-padding-start

Specifies the space between an element's left or right border and its contents, depending on the writing direction.

-moz-transform

Specifies the two-dimensional linear transformation applied to an element. The origin of the transformation is specified by the -moz-transform-origin property.

-moz-transform-origin

Specifies the origin of two-dimensional linear transformations specified with the -moz-transform property.

-o-background-size

Sets the size of the background image.

-op-phonemes

Specifies a phonetic pronunciation for the text contained by the corresponding element.

-op-voice-pitch

Specifies the average frequency of the speaking voice.

-op-voice-pitch-range

Specifies the variation from the average pitch of the voice.

-op-voice-rate

Specifies the number of spoken words per minute.

-op-voice-stress

Specifies the strength of emphasis to be applied.

-op-voice-volume

Sets the volume of a spoken element.

-webkit-appearance

Specifies theme rendering mode for an element. Allows you to make an element look like a standard user interface element.

-webkit-background-clip

Sets which part of background is visible.

-webkit-background-composite

Sets the compositing style for an element's background image and color.

-webkit-background-origin

Specifies how the background-position property is determined, ergo it defines the reference point that the background-image is relative to.

-webkit-background-size

Sets the size of the background image.

-webkit-border-bottom-left-radius

Sets the rounding of the lower left corner of the border.

-webkit-border-bottom-right-radius

Sets the rounding of the lower right corner of the border.

-webkit-border-horizontal-spacing

Specifies the amount of horizontal space between cells in a table.

-webkit-border-image

Specifies an image to use as the border of the element. The image is sliced into 9 pieces along the four diagonals specified with the length units.

-webkit-border-radius

Sets the rounding of the corners of the border.

-webkit-border-top-left-radius

Sets the rounding of the upper left corner of the border.

-webkit-border-top-right-radius

Sets the rounding of the upper right corner of the border.

-webkit-border-vertical-spacing

Specifies the amount of vertical space between cells in a table.

-webkit-margin-bottom-collapse

Specifies whether the top and bottom margins can be shared between adjacent elements.

-webkit-margin-collapse

Specifies whether the top and bottom margins can be shared between adjacent elements.

-webkit-margin-start

Specifies the width of the left or the right margin, depends on the writing direction.

-webkit-margin-top-collapse

Specifies whether the top and bottom margins can be shared between adjacent elements.

-webkit-nbsp-mode

Specifies the behavior of non-breaking spaces within an element.

-webkit-padding-start

Specifies the space between an element's left or right border and its contents, depends on the writing direction.

-webkit-rtl-ordering

Specifies the default rendering mode of right-to-left and mixed left-to-right content.

-webkit-text-fill-color

Specifies the fill color of the text.

-webkit-text-security

Specifies the type of shape used to hide the letters in a password input field.

-webkit-text-stroke

Sets the color and width of the text outline.

-webkit-text-stroke-color

Sets the color of text's outline.

-webkit-text-stroke-width

Sets the width of text's outline.

-webkit-transform

Specifies the two-dimensional linear transformation applied to an element. The origin of the transformation is specified by the -moz-transform-origin property.

-webkit-transform-origin

Specifies the origin of the two-dimensional linear transformations specified with the -moz-transform property.

-xv-interpret-as

Specifies how to interpret the contents of the corresponding element.

-xv-phonemes

Specifies a phonetic pronunciation for the text contained by the corresponding element.

-xv-voice-balance

Sets the balance between left and right channels.

-xv-voice-duration

Specifies how long a given element is to be rendered.

-xv-voice-pitch

Specifies the average frequency of the speaking voice.

-xv-voice-pitch-range

Specifies the variation from the average pitch of the voice.

-xv-voice-rate

Specifies the number of spoken words per minute.

-xv-voice-stress

Specifies the strength of emphasis to be applied.

-xv-voice-volume

Sets the volume of a spoken element.

background

Specifies up to five separate background properties, in a shorthand form.

background-attachment

Specifies whether the background-image should scroll with the contents of the object or not.

background-color

Specifies the color to use for the background of the object.

background-image

Specifies the image to use as the background of the object.

background-position

Sets the position of the background-image within the element.

background-position-x

Specifies the horizontal coordinate of the background-image relative to the upper-left corner of the container object.

background-position-y

Specifies the vertical-coordinate of the background-image relative to the upper-left corner of the container object.

background-repeat

Specifies how to tile the background-image relative to the upper-left corner of the container object.

behavior

Sets the URL of a behavior file.

border

Sets up to three separate border properties, in a shorthand form.

border-bottom

Sets the color, style and width properties for the element's bottom border, in a shorthand form.

border-bottom-color

Specifies the color of the element's bottom border.

border-bottom-style

Specifies the style of the element's bottom border.

border-bottom-width

Specifies the width of the element's bottom border.

border-color

Specifies the color of the element's border.

border-left

Specifies the color, style and width properties for the element's left border, in a shorthand form.

border-left-color

Specifies the color of the element's left border.

border-left-style

Specifies the style of the element's left border.

border-left-width

Specifies the width of the element's left border.

border-right

Specifies the color, style and width properties for the element's right border, in a shorthand form.

border-right-color

Specifies the color of the element's right border.

border-right-style

Specifies the style of the element's right border.

border-right-width

Specifies the width of the element's right border.

border-style

Specifies the style of the element's border.

border-top

Specifies the color, style and width properties for the element's top border, in a shorthand form.

border-top-color

Specifies the color of the element's top border.

border-top-style

Specifies the style of the element's top border.

border-top-width

Specifies the width of the element's top border.

border-width

Specifies the width of the element's border.

bottom

Specifies the bottom coordinate of a positioned element.

clip

Specifies which part of a positioned element is visible.

color

Specifies the color of the element's text content.

cursor

Specifies the type of cursor to display for the pointing device (mouse).

direction

Specifies the text direction.

display

Specifies the element's display type.

filter

Specifies the filter or collection of filters applied to the object.

float

Specifies the horizontal alignment of the object.

font

Specifies up to six separate font properties, in a shorthand form.

font-family

Specifies the font face for text.

font-size

Specifies the font size of the text.

font-size-adjust

Specifies font aspect value (font size divided by x-height).

font-style

Specifies whether the style of the font is normal, italic or oblique.

font-variant

Specifies a variation of the specified or default font-family.

font-weight

Specifies the font weight of the text.

height

Specifies the height of the visible area for an element.

ime-mode

	3

Specifies the state of an Input Method Editor (IME) for user text entry fields. IME allows users to enter and edit Chinese, Japanese, and Korean characters.

layout-flow

Specifies the flow and direction of the content in an element.

layout-grid

Specifies up to four separate layout-grid properties that specify the layout of text characters.

layout-grid-mode

Specifies whether the text layout grid uses one or two dimensions.

left

Specifies the left coordinate of a positioned element.

letter-spacing

Specifies the amount of space between letters.

line-height

Specifies the distance between lines of text in a block-level element.

margin

Specifies a shorthand property for setting the top, right, bottom and left margins, in that order.

margin-bottom

Specifies the bottom margin of the object.

margin-left

Specifies the left margin of the object.

margin-right

Specifies the right margin of the object.

margin-top

Specifies the top margin of the object.

max-height

7

Specifies the maximum height for the visible area of an element.

max-width

7

Specifies the maximum width for the visible area of an element.

min-height

Specifies a minimum height for the visible area of an element.

min-width

7

Specifies the minimum width for the visible area of an element.

opacity

9

Sets the transparency level of an element. For Internet Explorer, use filter with 'Alpha(opacity=percent)'.

outline

8

Specifies a shorthand form for all outline properties at once. Outline is a line around an element, but different from the border property.

outline-color

8

Specifies the color for the outline for an element.

outline-offset

Sets the amount of space between the outline and the border or the edge of the element.

outline-style

8

Specifies the style for an element's outline.

outline-width

8

Specifies the width for an element's outline.

overflow

Specifies what to do with content outside the element's rendering area.

overflow-x

	3.5	10

Specifies what to do with content that exceeds the element's width.

overflow-y

	3.5	10

Specifies what to do with content that exceeds the element's height.

padding

Specifies a shorthand property for setting the top, right, bottom and left spaces between an element's border and its contents, in that order.

padding-bottom

Specifies the space between an element's bottom border and its contents.

padding-left

Specifies the space between an element's left border and its contents.

padding-right

Specifies the space between an element's right border and its contents.

padding-top

Specifies the space between an element's top border and its contents.

page-break-after

Specifies whether a page break occurs after the object when printing.

page-break-before

Specifies whether a page break occurs before the object when printing.

page-break-inside

8

Specifies the page-breaking behavior that should occur inside an element's rendering box when printing.

position

Specifies what type of positioning method is used to render the current element.

resize

Specifies whether an element is resizable and if so, along which axis.

right

Specifies the right coordinate of a positioned element.

scrollbar-3dlight-color

Specifies the color of the outer top and left bevel edges of the scroll box and scroll arrows of the scroll bar.

scrollbar-arrow-color

Specifies the color of the arrow of the scroll bar.

scrollbar-base-color

Specifies the main color of the scroll bar.

scrollbar-darkshadow-color

Specifies the color of the outer bottom and right bevel edges of the scroll box and scroll arrows of the scroll bar.

scrollbar-face-color

Specifies the color for the face of the scroll bar.

scrollbar-highlight-color

Specifies the color of the top and left edges of the scroll bar.

scrollbar-shadow-color

Specifies the color of the bottom and right edges of the scroll bar.

scrollbar-track-color

Specifies the color of the scroll bar's track element.

text-autospace

Specifies the spacing rules between Western and Asian-based (such as Japanese and Chinese) characters.

text-decoration

Specifies the appearance characteristics of text, whether it is underlined, overlined, lined-through or blinking text.

text-shadow

	3.5

Specifies a comma-separated list of shadow effects to be applied to the text of the element.

text-transform

Specifies the case of the text.

text-underline-position

Specifies the position of the underline decoration.

top

Specifies the top coordinate of a positioned element.

unicode-bidi

Specifies whether the text should be overridden to support multiple languages in the same document. Use with the direction property.

visibility

Specifies whether the element is visible.

voice-family

Specifies the type of voice to use as speak control.

white-space

Specifies how spaces, tabs, and newline characters inside the element are handled.

width

Specifies the width of the visible area for an element.

word-spacing

Specifies the spacing between words.

word-wrap

	3.5

Specifies whether the current line should break if the content exceeds the boundaries of its container.

writing-mode

Specifies the intrinsic writing direction of the element's content.

z-index

Specifies the stack level of positioned objects.

zoom

Specifies the zoom level of the element's content.

Example HTML code 1:

This example illustrates the use of the file selection element:

<form method="post" enctype="multipart/form-data" action="#URL#">
    Select a file: <input type="file" name="uploadFile" size="25" />
    <br /><br />
    <input type="submit" value="Upload" />
</form>

Copy Code

Preview

Syntax Highlighter

Did you find this example helpful? yes no

input:hidden
input:password
input:search
input:text
label
textArea
MULTIPLE

External links:

input type='file' element (MSDN)
input type='file' element (Safari Reference Library)
input type='file' element (W3C)

Digg Del.icio.us Reddit Facebook Twitter Diigo

User Contributed Comments

input:file element

Possible members:

Example HTML code 1:

Related pages:

External links:

Post Content