file - Render A File Select Input Field

Renders an HTML <input> element of type file, defaulting to the specified value or the specified property of the bean associated with our current form. This tag is only valid when nested inside a form tag body.

As with the corresponding HTML <input> element, the enclosing form element must specify "POST" for the method attribute, and "multipart/form-data" for the enctype attribute. For example:

                    <html:form method="POST" enctype="multipart/form-data">
                    <html:file property="theFile" />
                    </html:form>
Attribute Name Description
accesskey The keyboard character used to move focus immediately to this element. [RT Expr]
accept Comma-delimited set of content types that the server you submit to knows how to process. This list can be used by the client browser to limit the set of file options that is made available for selection. If not specified, no content type list will be sent. [RT Expr]
alt

The alternate text for this element.

[RT Expr]
altKey

The message resources key of the alternate text for this element.

[RT Expr]
disabled Set to true if this input field should be disabled. [RT Expr]
indexed Valid only inside of logic:iterate tag. If true then name of the html tag will be rendered as "id[34].propertyName". Number in brackets will be generated for every iteration and taken from ancestor logic:iterate tag. [RT Expr]
maxlength Maximum number of input characters to accept. This is ignored by most browsers. [No limit] [RT Expr]
name The attribute name of the bean whose properties are consulted when rendering the current value of this input field. If not specified, the bean associated with the form tag we are nested within is utilized. [RT Expr]
onblur JavaScript event handler executed when this element loses input focus. [RT Expr]
onchange JavaScript event handler executed when this element loses input focus and its value has changed. [RT Expr]
onclick JavaScript event handler executed when this element receives a mouse click. [RT Expr]
ondblclick JavaScript event handler executed when this element receives a mouse double click. [RT Expr]
onfocus JavaScript event handler executed when this element receives input focus. [RT Expr]
onkeydown JavaScript event handler executed when this element has focus and a key is depressed. [RT Expr]
onkeypress JavaScript event handler executed when this element has focus and a key is depressed and released. [RT Expr]
onkeyup JavaScript event handler executed when this element has focus and a key is released. [RT Expr]
onmousedown JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed. [RT Expr]
onmousemove JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved. [RT Expr]
onmouseout JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element. [RT Expr]
onmouseover JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element. [RT Expr]
onmouseup JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released. [RT Expr]
property Name of the request parameter that will be included with this submission, set to the specified value. [Required] [RT Expr]
size Size of the file selection box to be displayed. [RT Expr]
style CSS styles to be applied to this HTML element. [RT Expr]
styleClass CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). [RT Expr]
styleId Identifier to be assigned to this HTML element (renders an "id" attribute). [RT Expr]
tabindex The tab order (ascending positive integers) for this element. [RT Expr]
title

The advisory title for this element.

[RT Expr]
titleKey

The message resources key for the advisory title for this element.

[RT Expr]
value

NOTE: When setting this to some value, whether intentional or as the result (for example) of validation errors forcing the user back to the original jsp, this value is ignored by most browsers (for security reasons). This means that your users will have to re-select any previously selected files when submitting the form. Opera web browser will prompt the user so they have a chance to abort the submit.

Value to which this field should be initialized. [Use the corresponding bean property value or body content (if any) if property is not specified] [RT Expr]