Tag that generates HTML form fields of type <input type="file" ... />.
The only functionality provided above and beyond a straight HTML input tag is that the
tag will find its enclosing form tag and ensure that the for is set to POST instead of
GET, and that the encoding type of the form is properly set to multipart/form-data as
both these settings are necessary to correctly perform file uploads.
Does not perform repopulation because default values for
<input type="file"/> are not allowed by the HTML specification. One
can only imagine this is because a malicous page author could steal a user's files by
defaulting the value and using JavaScript to auto-submit forms! As a result the tag
does not accept a body because it would have no use for any generated content.
Attributes |
Name | Required | Request-time | Type | Description |
name | true | true | java.lang.String | The name of the form field. |
size | false | true | java.lang.String | The size of the form field. (HTML Pass-through) |
disabled | false | true | java.lang.String | Disables the input element when it first loads so that the user can not write text in it, or select it. (HTML Pass-through) |
accept | false | true | java.lang.String | A comma separated list of mime-types accepted for file uploads. (HTML Pass-through) |
accesskey | false | true | java.lang.String | Keyboard shortcut to access the element. (HTML Pass-through) |
class | false | true | java.lang.String | The CSS class to be applied to the element. (HTML Pass-through) |
dir | false | true | java.lang.String | Text direction. (HTML Pass-through) |
id | false | true | java.lang.String | A unique identifier for the HTML tag on the page. (HTML Pass-through) |
lang | false | true | java.lang.String | The language code of the element. (HTML Pass-through) |
onblur | false | true | java.lang.String | Scripting code run when the element loses focus. (HTML Pass-through) |
onchange | false | true | java.lang.String | Scripting code run when the element changes. (HTML Pass-through) |
onclick | false | true | java.lang.String | Scripting code run on each mouse click. (HTML Pass-through) |
ondblclick | false | true | java.lang.String | Scripting code run on a double-click of the mouse. (HTML Pass-through) |
onfocus | false | true | java.lang.String | Scripting code run when the element acquires focus. (HTML Pass-through) |
onkeydown | false | true | java.lang.String | Scripting code run when a key is depressed. (HTML Pass-through) |
onkeypress | false | true | java.lang.String | Scripting code run when a key is pressed and released. (HTML Pass-through) |
onkeyup | false | true | java.lang.String | Scripting code run when a key is released. (HTML Pass-through) |
onmousedown | false | true | java.lang.String | Scripting code run when a mouse button is depressed. (HTML Pass-through) |
onmousemove | false | true | java.lang.String | Scripting code run when the mouse pointer is moved. (HTML Pass-through) |
onmouseout | false | true | java.lang.String | Scripting code run when the mouse pointer moves out of the element. (HTML Pass-through) |
onmouseover | false | true | java.lang.String | Scripting code run when the mouse pointer moves over the element. (HTML Pass-through) |
onmouseup | false | true | java.lang.String | Scripting code run when a mouse button is released. (HTML Pass-through) |
onselect | false | true | java.lang.String | Scripting code run when an element is selected. (HTML Pass-through) |
style | false | true | java.lang.String | Inline CSS style fragment that applies to the element (HTML Pass-through) |
tabindex | false | true | java.lang.String | The tab order of the element. (HTML Pass-through) |
title | false | true | java.lang.String | Tool-tip text for the element. (HTML Pass-through) |