Developing Web 2.0 applications
with JavaServerFaces
and Dreamweaver
>> Just Became Easier
Documentation
Search
  1. Introduction
  2. Getting Started
  3. Trinidad Concepts
  4. Code View Support
  5. Design View Support
  6. Tag Object Toolbars
  7. Trinidad Server Behaviors
  8. Trinidad Property Inspectors
  9. Trinidad Tag Reference
Trinidad Core Tag Library
  tr:attribute
  tr:breadCrumbs
  tr:chart
  tr:chooseColor
  tr:chooseDate
  tr:column
  tr:commandButton
  tr:commandLink
  tr:commandNavigationItem
  tr:componentDef
  tr:componentRef
  tr:convertColor
  tr:convertDateTime
  tr:convertNumber
  tr:document
  tr:facetRef
  tr:forEach
  tr:form
  tr:goButton
  tr:goLink
  tr:group
  tr:icon
  tr:image
  tr:importScript
  tr:inputColor
  tr:inputDate
Selected tr:inputFile
  tr:inputHidden
  tr:inputListOfValues
  tr:inputNumberSpinbox
  tr:inputText
  tr:iterator
  tr:legend
  tr:media
  tr:message
  tr:messages
  tr:navigationPane
  tr:navigationTree
  tr:outputDocument
  tr:outputFormatted
  tr:outputLabel
  tr:outputText
  tr:page
  tr:panelAccordion
  tr:panelBorderLayout
  tr:panelBox
  tr:panelButtonBar
  tr:panelChoice
  tr:panelFormLayout
  tr:panelGroupLayout
  tr:panelHeader
  tr:panelHorizontalLayout
  tr:panelLabelAndMessage
  tr:panelList
  tr:panelPage
  tr:panelPageHeader
  tr:panelPartialRoot
  tr:panelRadio
  tr:panelSideBar
  tr:panelTabbed
  tr:panelTip
  tr:poll
  tr:processChoiceBar
  tr:progressIndicator
  tr:resetActionListener
  tr:resetButton
  tr:returnActionListener
  tr:selectBooleanCheckbox
  tr:selectBooleanRadio
  tr:selectItem
  tr:selectManyCheckbox
  tr:selectManyListbox
  tr:selectManyShuttle
  tr:selectOneChoice
  tr:selectOneListbox
  tr:selectOneRadio
  tr:selectOrderShuttle
  tr:selectRangeChoiceBar
  tr:separator
  tr:setActionListener
  tr:showDetail
  tr:showDetailHeader
  tr:showDetailItem
  tr:singleStepButtonBar
  tr:spacer
  tr:subform
  tr:switcher
  tr:table
  tr:train
  tr:tree
  tr:treeTable
  tr:validateByteLength
  tr:validateDateRestriction
  tr:validateDateTimeRange
  tr:validateDoubleRange
  tr:validateLength
  tr:validateLongRange
  tr:validateRegExp
  tr:validator
If you like this documentation, please take a look at my book:

9. Trinidad Core Tag Reference

Documentation > Trinidad > Trinidad Tag Reference > Trinidad Core Tag Library > tr:inputFile

tr:inputFile

<p> The <tr:inputFile> tag creates a component to upload files. Must have <a href="trinidad-core-form.html"><em><<a href="trinidad-core-form.html"><strong><tr:form> </strong></a>> </em></a> usesUpload="true" and must have Apache Trinidad filter installed. </p>

Example

<tr:inputFile label="File" columns="20">  
  <f:facet name="help">
    <tr:outputText value="Please upload a file" />
  </f:facet>      
</tr:inputFile> 

Rendered Output

Rendered tr:inputFile tag

Tag Attributes

accessKey Text
 
The accessKey attribute sets one character from the text on the component to use as a quick access key.
attributeChangeListener Text
 
a method reference to an attribute change listener. Attribute change events are not delivered for any programmatic change to a property. They are only delivered when a renderer changes a property without the application's specific request. An example of an attribute change events might include the width of a column that supported client-side resizing.
binding Expression
 
The value-binding expression linking this component tag to a backing bean property.
columns Text
 
The columns attribute sets the number of columns to render. If no value is specified and a converter is declared, then the columns attribute is determined from the converter.
contentStyle Text
 
The contentStyle attribute sets the CSS styles for the input text box.
converter Text
 
The converter attribute sets the converter instance to be registered for this component. It must match the converter-id value of a converter element defined in your Faces configuration file.
disabled Text
 
The disabled attribute is a boolean flag that when set to true indicates that this component should not receive focus or be included in a form submit.
id Text
 
The unique identifier value for this component. The value must be unique within the closest naming container.
immediate Text
 
The immediate attribute is a boolean flag indicating that component events should be sent to registered event listeners immediately rather than after the validation phase of the JSF request processing lifecycle. The immediate flag allows you bypass JSF validation for a particular component.
inlineStyle Text
 
the CSS styles to use for this component.
label Text
 
The label attribute sets the text that is displayed before the component.
labelAndAccessKey Text
 
An attribute that will simultaneously set both the "value" and "accessKey" attributes from a single value, using conventional ampersand ('&') notation. For example, setting this attribute to "L&abel" will set the label to "Label" and the access key to 'a'.
onblur Text
 
The onblur attribute sets the JavaScript code to execute when this element loses focus.
onchange Text
 
The onchange attribute sets the JavaScript code to execute when this element loses focus and its value changes after gaining focus.
onclick Text
 
The onclick attribute sets the JavaScript code to execute when the mouse pointer is clicked over this element.
ondblclick Text
 
The ondblclick attribute sets the JavaScript code to execute when the mouse pointer is double-clicked over this element.
onfocus Text
 
The onfocus attribute sets the JavaScript code to execute when the element receives focus.
onkeydown Text
 
The onkeydown attribute sets the JavaScript code to execute when a key is pressed down over this element.
onkeypress Text
 
The onkeypress attribute sets the JavaScript code to execute when a key is pressed and released over this element.
onkeyup Text
 
The onkeyup attribute sets the JavaScript code to execute when a key is released over this element.
onmousedown Text
 
The onmousedown attribute sets the JavaScript code to execute when the mouse pointer is pressed down over this element.
onmousemove Text
 
The onmousemove attribute sets the JavaScript code to execute when the mouse pointer is moved within this element.
onmouseout Text
 
The onmouseout attribute sets the JavaScript code to execute when the mouse pointer is moved away from this element.
onmouseover Text
 
The onmouseover attribute sets the JavaScript code to execute when the mouse pointer is moved onto this element.
onmouseup Text
 
The onmouseup attribute sets the JavaScript code to execute when the mouse button is released over this element.
onselect Text
 
The onselect attribute sets the JavaScript code to execute when the user selects the text contained by this element.
partialTriggers Text
 
the IDs of the components that should trigger a partial update. This component will listen on the trigger components. If one of the trigger components receives an event that will cause it to update in some way, this component will request to be updated too. Identifiers are relative to the source component, and must account for NamingContainers. If your component is already inside of a naming container, you can use a single colon to start the search from the root, or multiple colons to move up through the NamingContainers - "::" will search from the parent naming container, ":::" will search from the grandparent naming container, etc.
rendered Text
 
A value-binding expression that evaluates to a Boolean condition indicating if this component should be rendered.
required Text
 
The required attribute is a boolean flag that indicates whether or not the user is required to provide a value for this field before the form can be submitted to the server.
requiredMessageDetail Text
 
The requiredMessageDetail attribute sets the custom error message with the parameters {0} for a label to identify the component when the value for the component is required (the required attribute is set to “true”) and validation fails.
shortDesc Text
 
The shortDesc attribute sets the text that is rendered with the component. If the simple attribute is set to "true", then the shortDesc text will be displayed instead of the label. If the simple attribute is set to "false" and not label is specified, then the shortDesc text is displayed to the right of the input text box.
showRequired Text
 
The showRequired attribute is a boolean flag that when set to "true" determines if an "*" will be displayed before the component to indicate that the value is required. The attributue required must also be set to "true". The default is false.
simple Text
 
The simple attribute is a boolean flag that when set to "true" renders the component without any padding for messages. If a label attribute is specified, then the label is rendered to the right of the component. The default is "false".
styleClass Text
 
The styleClass attribute sets the CSS class to apply to this component when it is rendered.
validator Text
 
The validator attribute accepts a method-binding expression representing a validator method that will be called when the JSF framework validates this component. A validator method must be a public method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.
value Text
 
The value attribute sets the current value for this component.
valueChangeListener Text
 
The valueChangeListener attribute accepts a method-binding expression representing a value change listener method to be notified when a new value has been set for this input component. A value change listener method must be a public method that takes a ValueChangeEvent parameter, with a return type of void.