file (Struts EL Tag library documentation)

Overview | Library | Tag | Help

| FRAMES NO FRAMES

## html
Tag 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>

WARNING: In order to correctly recognize uploaded files, the ActionForm bean associated with this form must include a statement setting the corresponding org.apache.struts.upload.FormFile property to null in the reset() method.

Tag Information
Tag Class | org.apache.strutsel.taglib.html.ELFileTag
TagExtraInfo Class | None
Body Content | JSP
Display Name | None

Attributes
Name | Required | Request-time | Type | Description
accesskey | false | true | `java.lang.String` | The keyboard character used to move focus immediately to this element.
accept | false | true | `java.lang.String` | 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.
alt | false | true | `java.lang.String` | The alternate text for this element.
altKey | false | true | `java.lang.String` | The message resources key of the alternate text for this element.

bundle

false

true

`java.lang.String`

The servlet context attributes key for the MessageResources instance to use. If not specified, defaults to the application resources configured for our action servlet.

Since:
  Struts 1.2.5

dir

false

true

`java.lang.String`

The direction for weak/neutral text for this element.

Since:
  Struts 1.3.6

disabled | false | true | `java.lang.String` | Set to `true`

errorKey

false

true

`java.lang.String`

Name of the bean (in any scope) under which our error messages have been stored. If not present, the name specified by the `Globals.ERROR_KEY` constant string will be used.

N.B. This is used in conjunction with the `errorStyle`, `errorStyleClass` and `errorStyleId` attributes and should be set to the same value as the `name` attribute on the <html:errors/> tag.

Since:
  Struts 1.2.5

errorStyle

false

true

`java.lang.String`

CSS styles to be applied to this HTML element if an error exists for it.

N.B. If present, this overrides the `style` attribute in the event of an error.

Since:
  Struts 1.2.5

errorStyleClass

false

true

`java.lang.String`

CSS stylesheet class to be applied to this HTML element if an error exists for it (renders a "class" attribute).

N.B. If present, this overrides the `styleClass` attribute in the event of an error.

Since:
  Struts 1.2.5

errorStyleId

false

true

`java.lang.String`

Identifier to be assigned to this HTML element if an error exists for it (renders an "id" attribute).

N.B. If present, this overrides the `styleId` attribute in the event of an error.

Since:
  Struts 1.2.5

indexed | false | true | `java.lang.String` | Valid only inside of `logic-el:iterate` `c:forEach` `true`

lang

false

true

`java.lang.String`

The language code for this element.

Since:
  Struts 1.3.6

maxlength | false | true | `java.lang.String` | Maximum number of input characters to accept. This is ignored by most browsers. [No limit]
name | false | true | `java.lang.String` | 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.
onblur | false | true | `java.lang.String` | JavaScript event handler executed when this element loses input focus.
onchange | false | true | `java.lang.String` | JavaScript event handler executed when this element loses input focus and its value has changed.
onclick | false | true | `java.lang.String` | JavaScript event handler executed when this element receives a mouse click.
ondblclick | false | true | `java.lang.String` | JavaScript event handler executed when this element receives a mouse double click.
onfocus | false | true | `java.lang.String` | JavaScript event handler executed when this element receives input focus.
onkeydown | false | true | `java.lang.String` | JavaScript event handler executed when this element has focus and a key is depressed.
onkeypress | false | true | `java.lang.String` | JavaScript event handler executed when this element has focus and a key is depressed and released.
onkeyup | false | true | `java.lang.String` | JavaScript event handler executed when this element has focus and a key is released.
onmousedown | false | true | `java.lang.String` | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is depressed.
onmousemove | false | true | `java.lang.String` | JavaScript event handler executed when this element is under the mouse pointer and the pointer is moved.
onmouseout | false | true | `java.lang.String` | JavaScript event handler executed when this element was under the mouse pointer but the pointer was moved outside the element.
onmouseover | false | true | `java.lang.String` | JavaScript event handler executed when this element was not under the mouse pointer but the pointer is moved inside the element.
onmouseup | false | true | `java.lang.String` | JavaScript event handler executed when this element is under the mouse pointer and a mouse button is released.
property | true | true | `java.lang.String` | Name of the request parameter that will be included with this submission, set to the specified value.
size | false | true | `java.lang.String` | Size of the file selection box to be displayed.
style | false | true | `java.lang.String` | CSS styles to be applied to this HTML element. N.B. If present, the `errorStyle` overrides this attribute in the event of an error for the element.
styleClass | false | true | `java.lang.String` | CSS stylesheet class to be applied to this HTML element (renders a "class" attribute). N.B. If present, the `errorStyleClass` overrides this attribute in the event of an error for the element.
styleId | false | true | `java.lang.String` | Identifier to be assigned to this HTML element (renders an "id" attribute). N.B. If present, the `errorStyleId` overrides this attribute in the event of an error for the element.
tabindex | false | true | `java.lang.String` | The tab order (ascending positive integers) for this element.
title | false | true | `java.lang.String` | The advisory title for this element.
titleKey | false | true | `java.lang.String` | The message resources key for the advisory title for this element.
value | false | true | `java.lang.String` | Value to which this field should be initialized. [Use the corresponding bean property value or body content (if any) if property is not specified] 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.

Variables
No Variables Defined.

Overview | Library | Tag | Help

| FRAMES NO FRAMES

Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.