+ This tag is the same as the ui:composition, except for two things:
+ JSF creates a component and adds it directly to the tree, and there's no associated
+ template.
+
+ Use this tag to create a component and specify a filename for the
+ component as either the source of a ui:include, or the source of a Facelets tag.
+
+ The identifier of the component that JSF inserts into the component tree. If an identifier is + not explicitly specified by the page author, JSF will assign an identifier based on the algorithm + that it uses for all components. +
+ + + ]]>+ Binds the component to a backing bean property, as specified in the JSF specification. +
+ + + ]]>
+ Defines a composition that optionally uses a template, as outlined in the description of the ui tag library. Multiple
+ compositions can use the same template, thus encapsulating and reusing layout. JSF disregards everything outside of the
+ composition, which lets developers embed compositions in well-formed XHTML pages that can be viewed in an XHTML viewer,
+ such as Dreamweaver or a browser, without including extraneous elements such as head and body.
+
+ A URI that points to a template, also known as a layout, that inserts pieces of the page defined in the composition. +
+ + + ]]>
+ When the ui:debug tag is placed in an XHTML page, it creates a component and adds it to the
+ component tree. That debug component captures debugging information, namely the current state of the component
+ tree and the scoped variables in the application, when the component is rendered. If the user presses CTRL + SHIFT + d,
+ JSF opens a window that shows the debugging information captured by the debug component.
+
+ Typically, the best place to put the ui:debug tag is in an application's main template, which
+ lets developers enable or disable viewing of debugging information in one central location. Additionally, page
+ authors can change the hotkey (which by default is CTRL + SHIFT + d, where the d stands for debug) to CTRL + SHIFT + ?,
+ where ? represents the key specified as the value of the hotkey attribute.
+
+ You can use the rendered attribute to control whether the debug component is rendered.
+ Using an EL expression as the value for the rendered attribute lets you control whether
+ debug output is enabled for multiple views based on a single bean property.
+
+ Defines a single character, that, pressed in conjunction with CTRL and SHIFT, will display the JSF debug window. + By default, the hotkey is 'd'. The value for the hotkey attribute cannot be an EL expression. +
+ + + + ]]>+ Controls whether the debug component is rendered. Valid values for this attribute are either the strings "true" or "false" or an EL expression that evaluates to either "true" or "false".
If this attribute's value is "false" or the value is an EL expression that evaluates to "false", the debug component is not rendered in the page, the hotkey attribute is disregarded, and users cannot open the debugging information window with a hotkey.
+ + + + + ]]>The define tag defines content that is inserted into a page by a template. The define tag can be used inside ui:composition, ui:component, ui:decorate, and ui:fragment tags.
Content defined by the define tag can be inserted into a page by using ui:insert.
+
Assigns a name to the content inside a define tag. That name is used by corresponding ui:insert tags in a template that insert the named content into a page.
+ The decorate tag is identical to the composition tag, except that ui:decorate, unlike ui:composition, does not disregard all content outside of the tag. The decorate is useful when you want to decorate some content in a page, for example, you might want to decorate a list of items, like this:
+
+
ui:decorate tag, ui:decorate can
+be used to decorate pieces of a page.
+
+
+
+ ]]>The fragment tag is identical to the component tag, except that ui:fragment, unlike ui:component, JSF does not disregard all content outside of the tag.
Use this tag—which is very similar to JSP's jsp:include—to encapsulate and reuse content among
+multiple XHTML pages. There are three things this tag can include: plain XHTML, and XHTML pages that have either a composition tag or a component tag.
+
You supply a filename, through ui:include's src attribute for JSF to include. That
+filename is relative to the XHTML file that was rendered as a result of the last request. So, for example, if JSF loaded
+the view login.xhtml, and that file included pageDecorations/header.xhtml, and
+pageDecorations/header.xhtml included companyLogo.xhtml, then companyLogo.xhtml will
+not be found if it's in the pageDecorations directory, because companyLogo.xhtml has to be
+in the same directory as login.xhtml.
+
Inserts content into a template. That content is defined—with the ui:define tag— in either a ui:composition, ui:component, ui:decorate, or ui:fragment.
Use this tag to pass parameters to an included file (using ui:include), or a template
+(linked to either a composition or decorator). Embed ui:param tags in either ui:include,
+ui:composition, or ui:decorate to pass the parameters.
+
+
+ ]]>
Use this tag as an alternative to h:dataTable or
+c:forEach, especially when you are using the
+jsfc feature of Facelets. You can specify this component as
+the value of the jsfc attribute, like this:
+<div... jsfc="ui:repeat" value="#{contacts}" var="contact">...
+
Read-write property setting the offset from the beginning of the +collection from which to start the iteration. If not set, this offset +is not considered and iteration will start at the beginning of the +collection.
+ + + + ]]>Read-write property setting the size of the collection to iterate.
+If this value is less than the actual size of the collection, a
+FacesException must be thrown.
Iteration + will only process every step items of the collection, + starting with the first one.
+ + ]]>The name of a collection of items that this tag iterates over. The
+collection may be a List, array,
+java.sql.ResultSet, or an individual java Object. If the
+collection is null, this tag does nothing.
Name of the + exported scoped variable for the current item of the + iteration. This scoped variable has nested + visibility. Its type depends on the object of the + underlying collection
+ + ]]>Name of the + exported request scoped variable for the status of the + iteration. Object is a POJO with the following read-only + JavaBeans properties. This scoped variable has nested + visibility.
+ +begin of type Integer
end of type Integer
index of type int
step of type Integer
even of type boolean
odd of type boolean
first of type boolean
last of type boolean
Remove content from a page. This tag is often used in conjunction with the jsfc feature of Facelets,
+to wrap additional markup. When Facelets removes markup from a page by substituting markup items that have
+a jsfc attribute with the specified component, Facelets also removes anything in the page that
+is contained in a ui:remove tag.
Decode Behavior
+ +Obtain the Map from the "requestParameterMap"
+ property of the ExternalContext. If the value in the
+ Map for the value of the "clientId" property of the
+ component is null, create a String by concatenating
+ the value of the "clientId" property of the component with the
+ String ".x" (without the quotes). Create another String in the
+ same manner, but concatenate ".y" (without the quotes). If
+ null is the value in the Map for both
+ Strings, return from decode(). If the value in the
+ Map for the value of the "clientId" property of the
+ component is not null, get the value of the "type"
+ attribute, and convert it to lower case. If the result is equal
+ to the String "reset" (without the quotes), return from
+ decode(). Otherwise, create a
+ javax.faces.event.ActionEvent around the component,
+ and pass it to the queueEvent() method of the
+ component, which must be an instance of
+ UICommand.
Encode Behavior
+ +Render the clientId of the component as the value of the "name"
+ attribute. Render the current value of the component as the value
+ of the "value" attribute. If "image" attribute is specified render
+ it as the value of the "src" attribute after passing it to the
+ getResourceURL() method of the
+ ViewHandler for this application, and passing the
+ result through the encodeResourceURL() method of the
+ ExternalContext. Note that calling
+ getResourceURL() will prefix the context-root of the
+ current application if the value of the "src" attribute starts
+ with "/". When handling the "image" attribute, the value must not
+ be escaped. For example, & must not be turned into
+ &. If the "styleClass" attribute is
+ specified, render its value as the value of the "class" attribute.
+ If the user has specified an "onclick" attribute, append that
+ JavaScript to any existing JavaScript before rendering.
If the component being rendered by
+ this renderer has any UIParameter children, each one
+ of them must be rendered using the renderer for component-family:
+ "javax.faces.Input" and renderer-type: "javax.faces.Hidden". For
+ discussion, this is called the hiddenRenderer. A component with
+ component-type "javax.faces.Input" must be created for local use
+ in rendering each UIParameter child. The "id"
+ property of the temporary component must be set to the "name" of
+ the UIParameter. The "value" property of the
+ temporary component must be set to the "value" of the
+ UIParameter. For each UIParameter
+ child, the hiddenRenderer must have its
+ encodeBegin(), encodeChildren(), and
+ encodeEnd() methods called, in order, passing the
+ temporary component as the second argument.
General Behaviour
+ +Both the encode and decode behavior require the ability to get + the id/name for a hidden field, which may be rendered in markup or which + may be programmatically added via client DOM manipulation, + whose value is set by the JavaScript form submit. This name must + be constructed as follows:
+ +Get the clientId for the form of which this component is a + child.
Append
+ NamingContainer.SEPARATOR_CHAR.
Append a constant string that is the same for all command + link components in the tree.
In the following text, this String is called + hiddenFieldName.
+ +Decode Behavior
+ +Obtain the "clientId" property of the component. Obtain the
+ Map from the "requestParameterMap" property of the
+ ExternalContext. Derive hiddenFieldName as above.
+ Get the entry in the Map under the key that is the
+ hiddenFieldName. If the there is no entry, or the entry is the
+ empty String, or the entry is not equal to the value of the
+ "clientId" property, return immediately. If there is an entry,
+ and its value is equal to the value of the "clientId" property,
+ create a new javax.faces.event.ActionEvent instance
+ around the component and call queueActionEvent() on
+ the component, passing the event.
Encode Behavior
+ +If the value of the disabled attribute is
+ true, render a span element. Render all the passthru
+ attributes and the target attribute as pass-through
+ attributes on the span, even though the target
+ attribute will have no effect on a span. Render the current value
+ of the component as the content of the span. Return.
If the disabled attribute is not present, or its
+ value is false, render an HTML a
+ element. Render "#" as the value of the "href" attribute. Render
+ the current value of the component as the link text if it is
+ specified. Render JavaScript that is functionally equivalent to
+ the following as the value of the "onclick" attribute:
document.forms['CLIENT_ID']['hiddenFieldName'].value='CLIENT_ID';
+ document.forms['CLIENT_ID']['PARAM1_NAME'].value='PARAM1_VALUE';
+ document.forms['CLIENT_ID']['PARAM2_NAME'].value='PARAM2_VALUE';
+ return false;
document.forms['CLIENT_ID'].submit()" where hiddenFieldName is + as described above, CLIENT_ID is the clientId of the UICommand + component, PARAM*_NAME and PARAM*_VALUE are the names and values, + respectively, of any nested UIParameter children. The name and + the value must be URLEncoded. If an "onclick" attribute was + specified by the user, render this JavaScript in a function, + and render the user's JavaScript in a function. Render both functions + in a choice function as follows:
+ +var a=function(){#USER_FUNCTION#};
+ var b=function(){#JSF_FUNCTION#};
+ return (a()==false) ? false : b();
where #USER_FUNCTION# is the user's JavaScript and + #JSF_FUNCTION# is the JavaScript rendered by JSF. The choice + function should operate such that if the user's JavaScript returns + true, then the rendered JavaScript will also execute.
+ +If the "styleClass" attribute is specified, render its value as + the value of the "class" attribute. Render any non-UIParameter + output children as normal inside of the "a" element. These will + appear as the link text. Allow the form renderer to output a + single "input" element (for the entire page, regardless of how + many command link components are in the page) of "type" "hidden" + whose "name" is the value of hiddenFieldName, and which must not + have a "value" attribute. Multiple occurrences of command link + components in the tree should not cause multiple hiddenFieldName + hidden fields. Allow the form renderer to output an "input" + element of "type" "hidden" for each of the nested UIParameter + children, taking the name property (but not the value) from each + one in turn. If the "disabled" attribute is specified, do not + render the HTML "a" anchor element or its "href" attribute. + Instead, render a "span" element. If the "styleClass" attribute + is specified, render its value as the value of the "class" + attribute on the "span". Render any pass-through attributes on + the "span". The content of the span element comes from the value + of the component or its children as specified above.
+ +If the user specified a target attribute, its
+ value must be set using javascript since the onclick
+ handler will prevent the target attribute from being generated.
+ This must be accomplished using JavaScript that is equivalent to
+ the following.
document.forms['CLIENT_ID'].target='TARGET';
Where TARGET is the value of the target attribute on the JSP + tag.
+ +Please consult the javadoc for UIData to
+ supplement this specification. If the "styleClass" attribute is
+ specified, render its value as the value of the "class" attribute
+ on the "table" element. Any pass-through attributes are also
+ rendered on the "table" element.
Column Groups
+ +If the UIData component has a "colgroups" facet,
+ render its contents. Consistent with the rules of facets in
+ general, this facet must have only one child. In general, this
+ will be a panel group component that will contain
+ colgroup and col elements per the HTML
+ Table specification. Use of column grouping can improve
+ accessibility. This facet must be rendered before the table
+ header and footer.
Rendering the header
+ +If the UIData component has a "header" facet, or
+ any of the child UIColumn components has a "header"
+ facet, render a "thead" element. If the UIData
+ component has a "header" facet, encode its contents inside of "tr"
+ and "th" elements, respectively. Output the value of the
+ "headerClass" attribute of the UIData component, if
+ present, as the value of the "class" attribute on the "th".
+ Output the number of child UIColumn components of the
+ UIData component as the value of the "colspan"
+ attribute on the "th". Output "colgroup" as the value of the
+ "scope" attribute on the "th" element.
If any of the child UIColumn components has a
+ "header" facet render a "tr" element. For each
+ UIColumn that actually has a "header" facet, render
+ it inside of a "th" element. Columns that don't have a "header"
+ facet cause an empty "th" element to be rendered. Output the
+ value of the "headerClass" attribute of the UIColumn
+ component, if present, as the value of the "class" attribute on
+ the "th". If the "headerClass" attribute of the UIColumn
+ component is not present, output the value of the "headerClass"
+ attribute of the UIData component, if present, as
+ the value of the "class" attribute on the "th". Output "col" as
+ the value of the "scope" attribute on the "th" element.
+
Close out the "thead" element.
+ +Rendering the footer
+ +Follow the same process as for the header, except replace + "header" with "footer", "th" with "td", "thead" with "tfoot", and + "headerClass" with "footerClass". Do not render any "scope" + attribute for the footer.
+ +Rendering the table body
+ +Look at the value of the "bodyrows" attribute. If present, + this must be a comma separated list of integers. Each entry in + this list is the row index of the row before which a "tbody" + element should be rendered.
+ +If there was no "bodyrows" attribute, or it was empty, render a
+ "tbody" element. Keep track of the result of the "rows" property
+ on the UIData component. Keep track of the number of
+ rows we have rendered so far. Iterate through the rows. Set the
+ "rowIndex" property of the UIData component to be
+ correct as we iterate through the rows. Stop rendering children
+ and close out the "tbody" element if the "rowAvailable" property
+ of the UIData returned false. If the current row
+ index is contained in the "bodyrows" attribute, check if a "tbody"
+ start element was rendered that needs to be closed, and if so,
+ close the "tbody" element. Then render a "tbody" element start.
+ Otherwise, do not render a "tbody" element.
Output a "tr" element. Output the value of the "rowClasses"
+ per the attribute description below. For each
+ UIColumn child, if the column component has a
+ "rowHeader" attribute with a value of "true", output a "th"
+ element with a "scope" attribute with the value of "row".
+ Otherwise, if the column component has no "rowHeader" attribute,
+ or its value is false, output a "td" element. In either case
+ attach the value of the "columnClasses" attribute of the
+ UIData component per the attribute description below.
+ Recursively encode each child of each UIColumn child.
+ Close out the "td" or "th" element. When done with the row, close
+ out the "tr" element. When done with all the rows, close out the
+ "tbody" element.
When done rendering all the rows, set the "rowIndex" property of
+ the UIData to -1, and close out the "table"
+ element.
Decode Behavior
+ +Obtain the Map from the "requestParameterMap"
+ property of the ExternalContext. If the map contains
+ an entry for the "clientId" of this UIForm component,
+ call setSubmitted(true) on the form, otherwise call
+ setSubmitted(false) on the form.
Encode Behavior
+ +The value of the "method" attribute must be "post". The value
+ of the "action" attribute must be the result of passing the view
+ identifier of the current view to the getActionURL()
+ method of the ViewHandler for this application, then
+ passing that String to the encodeActionURL() method
+ on the ExternalContext. The value of the acceptcharset
+ attribute must be rendered as the value of "accept-charset".
+ If the "styleClass" attribute is specified, render its value as the
+ value of the "class" attribute. Render a "name"
+ attribute with a value the same as the "id" attribute as described
+ in "General Notes on
+ Encoding" regarding the "id" attribute for UIInput
+ components. Call ViewHandler.writeState()
+ before the the close of the "form" element. Render all the
+ necessary hidden fields for all commandLink instances in the page
+ just before the close of the "form" element.
+
</form> element tag, render
+ any resources that have been targeted for this form:
+ UIViewRoot instance.List of component resources targeted for
+ this form with a call to UIViewRoot.getComponentResources()
+ with the String "form" as the argument.List of UIComponent instances
+ and call encodeAll on each UIComponent instance.
+ Handling the Value
+ +If the "name" attribute is present, execute algorithm Common Algorithm for Obtaining A Resource to Render to obtain a Resource instance. Call
+ Resource.getRequestPath() and output the result as the
+ value of the "src" attribute on the rendered markup.
Otherwise, if the "url" attribute is present, treat its value as
+ if it was the value of the "value" attribute. Otherwise, if the
+ "value" attribute is present, render the value of the component as
+ the value of the "src" attribute, after passing it to the
+ getResourceURL() method of the ViewHandler
+ for this application, and passing the result through the
+ encodeResourceURL() method of the
+ ExternalContext.
When handling the "src" attribute,
+ the value must not be escaped. For example, & must not
+ be turned into &. If the "styleClass"
+ attribute is specified, render its value as the value of the "class"
+ attribute.
The libraryName for this resource.
+ ]]>The resourceName for this resource.
+ ]]>The target area for which this resource will be rendered. For example, target="head" would cause the resource to be rendered within the head element.
+ ]]>Decode Behavior
+ +See the decode description for the Input + Text renderer.
+ +Encode Behavior
+ +Render the clientId of the component as the value of the + "name" attribute. Render the current value of the component as + the value of the "value" attribute.
+ +ValueChangeEvent parameter,
+ with a return type of void, or
+ to a public method that takes no arguments with a return type
+ of void. In the latter case, the method has no way of easily
+ knowing what the new value is, but this can be useful in cases
+ where a notification is needed that "this value
+ changed".
+
+
+ ]]>Decode Behavior
+ +See the decode description for the Input + Text renderer.
+ +Encode Behavior
+ ++ Render the clientId of the component as the value of the "name" + attribute. Render the current value of the component as the value + of the "value" attribute, if and only if the "redisplay" component + attribute is the string "true". If the "styleClass" attribute is + specified, render its value as the value of the "class" + attribute.
+ +ValueChangeEvent parameter,
+ with a return type of void, or
+ to a public method that takes no arguments with a return type
+ of void. In the latter case, the method has no way of easily
+ knowing what the new value is, but this can be useful in cases
+ where a notification is needed that "this value
+ changed".
+
+
+ ]]>Obtain the Map from the "requestParameterMap"
+ property of the ExternalContext. If the
+ Map contains an entry for the "clientId" of the
+ component, pass the value of the entry to the
+ setSubmittedValue() method of the component, which
+ must be an instance of EditableValueHolder.
Encode Behavior
+ +Render the clientId of the component as + the value of the "name" attribute. Render the current value of + the component as the value of the "value" attribute. If the + "styleClass" attribute is specified, render its value as the value + of the "class" attribute. +
+ +ValueChangeEvent parameter,
+ with a return type of void, or
+ to a public method that takes no arguments with a return type
+ of void. In the latter case, the method has no way of easily
+ knowing what the new value is, but this can be useful in cases
+ where a notification is needed that "this value
+ changed".
+
+
+ ]]>Decode Behavior
+ +See the encode description for the Input + Text renderer.
+ +Encode Behavior
+ +Render the + clientId as the value of the "name" attribute. Render the current + valu eof the component inside the "textarea" + element.
ValueChangeEvent parameter,
+ with a return type of void, or
+ to a public method that takes no arguments with a return type
+ of void. In the latter case, the method has no way of easily
+ knowing what the new value is, but this can be useful in cases
+ where a notification is needed that "this value
+ changed".
+
+
+ ]]>Set-up for Rendering
+ +Obtain the "summary" and "detail" properties from
+ UIMessage component. If not present, keep the
+ empty string as the value, respectively. Obtain the first
+ FacesMessage to render from the component, using
+ the "for" property of the UIMessage. This will be
+ the only message we render. Obtain the severity style for this
+ message. If the severity of the message is
+ FacesMessage.SEVERITY_INFO, the severity style
+ comes from the value of the "infoStyle" attribute. If the
+ severity of the message is
+ FacesMessage.SEVERITY_WARN, the severity style
+ comes from the value of the "warnStyle" attribute, and so on for
+ each of the severities, INFO, WARN, ERROR and
+ FATAL. The same rules apply for obtaining the
+ severity style class, but instead of "infoStyle, warnStyle", etc
+ use "infoClass, warnClass", etc. Obtain the "style",
+ "styleClass" and "layout" attributes from the
+ UIMessage component. If we have a "style"
+ attribute and a severity style attribute, use the severity style
+ attribute as the value of the "style" attribute. If we have no
+ "style" attribute, but do have a severity style, use the
+ severity style as the value of the "style" attribute. The same
+ precedence rules apply for the style class. Obtain the value of
+ the dir and lang attributes.
Rendering
+ +For the message renderer, we only render one row, for the first
+ message. For the messages renderer, we render as many rows as we
+ have messages. If any of the "dir", "lang", "style" or
+ "styleClass" attributes has a non-null value (as determined
+ above), render a "span" element, outputting the value of the
+ "style" attribute as the the value of the "style" attribute, and
+ outputting the value of the "styleClass" attribute as the value of
+ the "class" attribute on the "span" element. Output the "dir" and
+ "lang" attributes as well, if they are present. If the
+ UIMessage has a "tooltip" attribute with the value of
+ "true", and the UIMessage has "showSummary" and
+ "showDetail" properties with the value "true", if we haven't
+ already written out the "span", output the "summary" as the value
+ of the "title" attribute on the "span". If we haven't already
+ written out a "title" attribute, and "showSummary" is true, output
+ the summary. If "showDetail" is true, output the detail. Close
+ out the span if necessary.
UIMessages, and
+ there is no "for" attribute. Therefore, use either null
+ to obtain the messages from the FacesContext or the
+ empty string if the components "globalOnly" property is true.
+ If the layout was "table" close out the table elements, otherwise,
+ close out the list elements.
+ ]]>style, styleClass, dir, and
+ lang attributees from this component. If any are
+ present, render a "span" element. Output the
+ styleClass attribute (if present) as the value of the
+ class attribute. Output the style
+ attribute as the value of the style attribute.
+ Output the dir and lang attributes as
+ pass through attributes. Accrue a list of the values of all child
+ UIParameter components of this component. If there
+ are one or more accumulated parameter values, convert the list of
+ parameter values to an Object array, call
+ MessageFormat.format(), passing the
+ value of this component as the first argument, and
+ the array of parameter values as the second argument, and render
+ the result. Otherwise, render the value of this
+ component unmodified.
+ ]]>ExternalContext. The name of the UIParameter goes on
+ the left hand side, and the value of the UIParameter on the right
+ hand side. The name and the value must be URLEncoded. Each
+ UIParameter instance is separeted by an ampersand, as dictated in
+ the URL spec. If the "styleClass" attribute is specified, render
+ its value as the value of the "class" attribute. If the "id" attribute
+ is specified, follow the same steps as mentioned in the
+ "General
+ Notes on Encoding" regarding the "id" attribute for UIInput components.
+ If the "disabled" attribute is specified, do not render the HTML "a"
+ anchor element or the "href" element. Instead, render a "span" element.
+ If the "styleClass" attribute is specified, render its value as the value
+ of the "class" attribute on the "span". Render any pass-through attributes
+ on the "span".
+ ]]>Decode Behavior
+ +Obtain the Map from the "requestParameterMap"
+ property of the ExternalContext. If there is no
+ entry in the Map for the "clientId" of this
+ component, pass "false" to the setSubmittedValue()
+ method of the component, which must be an instance of
+ EditableValueHolder. If there is an entry, and its
+ value is equal, ignoring case and without quotes, to any of the
+ Strings: "on", "yes" or "true" pass true to the
+ setSubmittedValue() method of the component.
Encode Behavior
+ ++ Render the clientId of the component as the value of the "name" + attribute. If the current value of the component is "true", + output the "checked" attribute (must be rendered as checked="checked"). + If the "styleClass" attribute is specified, render its value as the value + of the "class" attribute.
ValueChangeEvent parameter,
+ with a return type of void, or
+ to a public method that takes no arguments with a return type
+ of void. In the latter case, the method has no way of easily
+ knowing what the new value is, but this can be useful in cases
+ where a notification is needed that "this value
+ changed".
+
+
+ ]]>See the "Decode + Behavior for UISelectMany Components" section.
+ +Encode Behavior
+ +Render a "table" element. If the "styleClass" is specified,
+ render the value of the "styleClass" attribute as the value of the
+ "class" attribute on the "table" element. If the "style", or
+ "border" attributes are specified, pass them thru and render their values as the "style"
+ and "border" attributes on the "table", respectively. If
+ the "layout" attribute is specified, and its value is
+ "pageDirection", render the children elements vertically,
+ otherwise horizontally, in the table. If any of the children are
+ an instance of SelectItemGroup, render them as a nested table.
+ Each of the children are ultimately rendererd as follows. Render
+ an "input" element of "type" "checkbox" for each child component.
+ Render the "name" attribute on the "input" element with the value
+ of the clientId of the component. Render an "id"
+ attribute on the "input" element. Each "id" value must be unique.
+ If the current SelectItem.isDisabled() returns true, render
+ "disabled" as the value of the "disabled" attribute. Close out
+ the "input" element. Render a "label" element. Render the "for"
+ attribute of the "label" element whose value is the corresponding
+ "input" element's "id" value. Render any "style" as the "class"
+ attribute on the "label" element. If the current checkbox would be
+ rendered as being checked, and there is a "selectedClass"
+ attribute, append a space, followed by the value of the
+ "selectedClass" attribute to any existing "class" attribute value
+ on the label element. Otherwise, render the value of the
+ "selectedClass" attribute as the value of the "class" attribute on
+ the label element. If the current checkbox would be rendered as
+ being not checked, and there is a "unselectedClass" attribute,
+ append a space, followed by the value of the "unselectedClass"
+ attribute to any existing "class" attribute value on the label
+ element. Otherwise, render the value of the "unselectedClass"
+ attribute as the value of the "class" attribute on the label
+ element. Close out the starting "label" element and render
+ the label value from SelectItem.getLabel(). Close out the "label"
+ element. As an exception to the general rules about how to handle
+ the "id" attribute, render it as an attribute on the outer "table"
+ element, the value of which is the clientId of the
+ component per the rules at the beginning of this specification.
+ The value of the current SelectItem is rendered as the value of
+ the "value" attribute. Coerce the value of the currently rendered
+ child to the type of the parent UISelectMany value following the
+ Expression Language coercion rules, before comparing the values.
+ If the value of the enclosing UISelectMany matches the current
+ value, render "checked" as the value of the "checked" attribute.
+ See the "Rendering
+ the option elements" specification for
+ ListboxRenderer for more detail on how to render the
+ "option" elements in this renderer.
ValueChangeEvent parameter,
+ with a return type of void, or
+ to a public method that takes no arguments with a return type
+ of void. In the latter case, the method has no way of easily
+ knowing what the new value is, but this can be useful in cases
+ where a notification is needed that "this value
+ changed".
+
+
+ ]]>java.util.Collection, or an EL expression that
+ evaluates to either 1. such a String, or 2. the
+ Class object itself.
+ ]]>Decode Behavior
+ +This section documents the decode behavior for all renderers
+ that handle UISelectMany or UISelectOne
+ components.
Decode Behavior for
+ UISelectMany components
Obtain the Map from the
+ "requestParameterValuesMap" property of the
+ ExternalContext. If the Map contains
+ an entry for the "clientId" of the component, pass the value of
+ the entry, cast to a String [], to the
+ setSubmittedValue() method of the component, which
+ must be an EditableValueHolder. If the
+ Map does not contain an entry, create an empty
+ String array and call
+ setSubmittedValue() with it.
Please check the javadoc for UISelectMany.getConvertedValue() + for additional requirements for renderers that render this kind + of component.
+ +Decode Behavior for
+ UISelectOne components
Obtain the Map from the "requestParameterMap"
+ property of the ExternalContext. If there is a
+ Map entry for the "clientId" property of the
+ component, pass it to the setSubmittedValue() method
+ of the component. If the
+ Map does not contain an entry, call
+ setSubmittedValue() passing an empty
+ String as the argument.
Encode Behavior
+ +Render an HTML "select" element. Render the clientId of
+ the component as the value of the "name" attribute. If the "styleClass"
+ attribute is specified, render its value as the value of the "class"
+ attribute on the "select" element. If the component is a
+ UISelectMany instance, render "multiple" as the value of the
+ "multiple" attribute. If the "size" attribute is specified, render its
+ value as the value of the "size" attribute. Otherwise use the number of
+ items as the value of the "size" attribute.
Rendering the "option" elements
+ +The only valid children of this component are
+ UISelectItem or UISelectItems
+ instances. Iterate over the children of this component, and accrue
+ a list of javax.faces.model.SelectItem instances.
+ If the current child is a
+ SelectItem whose noSelctionProperty is
+ true, and the UISelectOne or
+ UISelectMany parent of this option has one or more
+ selected values that are not the "no selection"
+ SelectItem, and the component has a
+ "hideNoSelectionLabel" attribute whose value is true,
+ then the current option, which is the "no selection" option, must
+ not be rendered. If the current child is a
+ UISelectItem create a SelectIteminstance
+ from its itemValue, itemLabel and
+ itemDescription properties, add it to the list. If
+ the current child is a UISelectItems instance, call
+ its getValue() method. If the result is a
+ SelectItem bean, add it to the list. If the result
+ is an array of SelectItem beans, add each one to the
+ list. If the result is a Collection of
+ SelectItem beans, add each one to the list. If the
+ result is a Map, create a SelectItem
+ bean for each entry in the Map using the key as the
+ label, the value as the value, and null as the
+ description. Iterate over the list of SelectItem
+ beans. If the current element is a SelectItemGroup,
+ render an "optgroup" element with a "label" attribute, the value
+ of which is the "label" property from the current element, then
+ call getSelectItems() and render each element as
+ below. If the current element is not a
+ SelectItemGroup, render an "option" element. Follow
+ the conversion rules in the spec to obtain a renderable
+ String from the "value" property of the current
+ element, render that as the value of the "value" atribute. Now it
+ is time to see if the current element is the selected value. Call
+ its getSubmittedValue() method, casting the result to
+ an Object [], otherwise the component must be a
+ UISelectOne instance, call its
+ getSubmittedValue() method and create an Object
+ [] around the result. Determine the type of the resultant
+ array if the resultant array is non-null, otherwise the type is
+ String. Coerce the current item value to this type
+ following the Expression Language coercion rules. If the
+ resultant array is non-null, we look in the array for a value
+ that, when we pass the renderable value to its
+ equals() method, it returns true,
+ meaning the current element is selected. If the resultant array
+ is null, if the component is a
+ UISelectMany, call its getValue()
+ method. If the result is a List obtain the values in
+ the list as an array. Otherwise, the component must be a
+ UISelectOne instance. Call its
+ getValue() method, which must be an Object array.
+ Look for an element in the resultant array that, 1. when we pass
+ the renderable value to its equals() method, it
+ returns true , or 2. if the renderable value is null,
+ and there is a null element in the array, also conclude that the
+ current element is selected. Otherwise the current element is not
+ selected. Now, if the current value is selected, write out an
+ HTML boolean property "selected". If the current
+ SelectItem.isDisabled() returns true, render "disabled" as the
+ value of the "disabled" attribute.
ValueChangeEvent parameter,
+ with a return type of void, or
+ to a public method that takes no arguments with a return type
+ of void. In the latter case, the method has no way of easily
+ knowing what the new value is, but this can be useful in cases
+ where a notification is needed that "this value
+ changed".
+
+
+ ]]>java.util.Collection, or an EL expression that
+ evaluates to either 1. such a String, or 2. the
+ Class object itself.
+ ]]>See the "Decode + Behavior for UISelectMany Components" section.
+ +Encode Behavior
+ +Render an HTML "select" element. Render the clientId of
+ the component as the value of the "name" attribute. If the "styleClass"
+ attribute is specified, render its value as the value of the "class"
+ attribute on the "select" element. If the component
+ to be rendered is a UISelectMany, render "multiple" as the value of
+ the "multiple" attribute. Render "1" as the value of the "size"
+ attribute. See the "Rendering the option
+ elements" specification for ListboxRenderer for
+ more detail on how to render the "option" elements in this
+ renderer.
ValueChangeEvent parameter,
+ with a return type of void, or
+ to a public method that takes no arguments with a return type
+ of void. In the latter case, the method has no way of easily
+ knowing what the new value is, but this can be useful in cases
+ where a notification is needed that "this value
+ changed".
+
+
+ ]]>java.util.Collection, or an EL expression that
+ evaluates to either 1. such a String, or 2. the
+ Class object itself.
+ ]]>See the "Decode + Behavior for UISelectOne Components" section.
+ +Encode Behavior
+ +Render an HTML "select" element. Render the clientId of
+ the component as the value of the "name" attribute. If the "styleClass"
+ attribute is specified, render its value as the value of the "class"
+ attribute on the "select" element. If the component
+ to be rendered is a UISelectMany, render "multiple" as the value of
+ the "multiple" attribute. If the "size" attribute is specified,
+ render its value as the value of the "size" attribute. Otherwise
+ use the number of items as the value of the "size" attribute. See
+ the "Rendering the option
+ elements" specification for ListboxRenderer for
+ more detail on how to render the "option" elements in this
+ renderer.
ValueChangeEvent parameter,
+ with a return type of void, or
+ to a public method that takes no arguments with a return type
+ of void. In the latter case, the method has no way of easily
+ knowing what the new value is, but this can be useful in cases
+ where a notification is needed that "this value
+ changed".
+
+
+ ]]>See the "Decode + Behavior for UISelectOne Components" section.
+ +Encode Behavior
+ +Render an HTML "select" element. Render the clientId of the
+ component as the value of the "name" attribute. If the
+ "styleClass" attribute is specified, render its value as the value
+ of the "class" attribute on the "select" element. If the component
+ to be rendered is a UISelectMany, render "true" as the value of
+ the "multiple" attribute. Use the number of items as the value of
+ the "size" attribute. See the "Rendering
+ the option elements" specification for
+ ListboxRenderer for more detail on how to render the
+ "option" elements in this renderer.
ValueChangeEvent parameter,
+ with a return type of void, or
+ to a public method that takes no arguments with a return type
+ of void. In the latter case, the method has no way of easily
+ knowing what the new value is, but this can be useful in cases
+ where a notification is needed that "this value
+ changed".
+
+
+ ]]>See the "Decode + Behavior for UISelectOne Components" section.
+ +Encode Behavior
+ +Render a "table" element. If the "styleClass" is specified,
+ render the value of the "styleClass" attribute as the value of the
+ "class" attribute on the "table" element. If the "style", "border"
+ attributes are specified, pass them thru and render their values as the "style"
+ and "border" attributes on the "table", respectively.. If
+ the "layout" attribute is specified, and its value is
+ "pageDirection", render the children elements vertically,
+ otherwise horizontally, in the table. If any of the children are
+ an instance of SelectItemGroup, render them as a nested table.
+ Each of the children are ultimately rendered as follows. Render
+ an "input" element of "type" "radio" for each child component.
+ Render the "name" attribute on the "input" element with the value
+ of the clientId of the component. Render an "id"
+ attribute on the "input" element. Each "id" value must be unique.
+ If the current SelectItem.isDisabled() returns true, render
+ "disabled" as the value of the "disabled" attribute. Close out
+ the "input" element. Render a "label" element. Render the "for"
+ attribute of the "label" element whose value is the corresponding
+ "input" element's "id" value. Render any "style" as the "class"
+ attribute on the "label" element. Close out the starting "label"
+ element and render the label value from SelectItem.getLabel().
+ Close out the "label" element. As an exception to the general
+ rules about how to handle the "id" attribute, render it as an
+ attribute on the outer "table" element, the value of which is the
+ clientId of the component per the rules at the
+ beginning of this specification. Coerce the value of the
+ currently rendered child to the type of the parent UISelectOne
+ value using the Expression Language coercion rules before
+ comparing the values. If the value of the currently rendered
+ child is equal to the value of the parent UISelectOne, render an
+ appropriate HTML boolean value indicating "checked" for the
+ enclosing "input". See the "Rendering
+ the option elements" specification for
+ ListboxRenderer for more detail on how to render the
+ "option" elements in this renderer.
ValueChangeEvent parameter,
+ with a return type of void, or
+ to a public method that takes no arguments with a return type
+ of void. In the latter case, the method has no way of easily
+ knowing what the new value is, but this can be useful in cases
+ where a notification is needed that "this value
+ changed".
+
+
+ ]]>UIData component.
+ ]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+UISelectItem should be nestetd inside a UISelectMany or UISelectOne component, and results in the addition of a +SelectItem instance to the list of available options for the parent component +
]]>java.util.regex.
+
+
++ The following algorithm is implemented: +
+ +null, exit immediately.null or an
+ empty String, throw a {@link javax.faces.validator.ValidatorException}
+ with a {@link #PATTERN_NOT_SET_MESSAGE_ID} message.
+ pattern property has been configured on this
+ {@link javax.faces.validator.Validator}, check the passed value against this pattern.
+ If value does not match pattern throw a {@link ValidatorException}
+ containing a {@link #NOT_MATCHED_MESSAGE_ID} message.
+ Register an ActionListener instance on the UIComponent associated with the closest parent UIComponent custom action. + +See javax.faces.event.ActionListener +See javax.faces.component.ActionSource
]]>+According to the documentation, the tag handler implementing this tag should meet +the following conditions: +
++When the value is an EL expression, this tag has the same effect as calling component.setValueBinding. A call to +method component.getAttributes().get(name) will then cause that expression to be evaluated and the result of the +expression is returned, not the original EL expression string. +
++See the javadoc for UIComponent.getAttributes for more details. +
++Unless otherwise specified, all attributes accept static values or EL expressions. +
Sets the specified name and attribute on the parent UIComponent. If the "value" specified is not a literal, it will +instead set the ValueExpression on the UIComponent. + +See javax.faces.component.UIComponent#getAttributes() +See javax.faces.component.UIComponent#setValueExpression(java.lang.String, javax.el.ValueExpression)
]]>Register a DateTimeConverter instance on the UIComponent associated with the closest parent UIComponent custom +action.
]]>Register a NumberConverter instance on the UIComponent associated with the closest parent UIComponent custom action.
]]>Register a named facet on the UIComponent associated with the closest parent UIComponent custom action.
]]>+TODO: We should find a way to save loaded bundles in the state, because otherwise on the next request the bundle map +will not be present before the render phase and value bindings that reference to the bundle will always log annoying +"Variable 'xxx' could not be resolved" error messages. +
Load a resource bundle localized for the Locale of the current view, and expose it (as a Map) in the request +attributes of the current request.
]]>+UISelectItems should be nested inside a UISelectMany or UISelectOne component, +and results in the addition of one ore more SelectItem instance to the list of available options +for the parent component +
null
]]>+Commonly associated with an h:inputText entity, but may be applied to any input component. +
++Some validators may allow the component to use attributes to define component-specific validation constraints; see +the f:attribute tag. See also the "validator" attribute of all input components, which allows a component to specify +an arbitrary validation <i>method</i> (rather than a registered validation type, as this tag does). +
++Unless otherwise specified, all attributes accept static values or EL expressions. +
Register a named Validator instance on the UIComponent associated with the closest parent UIComponent custom +action.
]]>+Unless otherwise specified, all attributes accept static values or EL expressions. +
Register an ValueChangeListener instance on the UIComponent associated with the closest parent UIComponent custom +action.
]]>+See the javadoc for this class in the JSF +Specification for further details. +
Container for all JavaServer Faces core and custom component actions used on a page.
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+UISelectItem should be nestetd inside a UISelectMany or UISelectOne component, and results in the addition of a +SelectItem instance to the list of available options for the parent component +
]]>java.util.regex.
+
+
++ The following algorithm is implemented: +
+ +null, exit immediately.null or an
+ empty String, throw a {@link javax.faces.validator.ValidatorException}
+ with a {@link #PATTERN_NOT_SET_MESSAGE_ID} message.
+ pattern property has been configured on this
+ {@link javax.faces.validator.Validator}, check the passed value against this pattern.
+ If value does not match pattern throw a {@link ValidatorException}
+ containing a {@link #NOT_MATCHED_MESSAGE_ID} message.
+ Register an ActionListener instance on the UIComponent associated with the closest parent UIComponent custom action. + +See javax.faces.event.ActionListener +See javax.faces.component.ActionSource
]]>+According to the documentation, the tag handler implementing this tag should meet +the following conditions: +
++When the value is an EL expression, this tag has the same effect as calling component.setValueBinding. A call to +method component.getAttributes().get(name) will then cause that expression to be evaluated and the result of the +expression is returned, not the original EL expression string. +
++See the javadoc for UIComponent.getAttributes for more details. +
++Unless otherwise specified, all attributes accept static values or EL expressions. +
Sets the specified name and attribute on the parent UIComponent. If the "value" specified is not a literal, it will +instead set the ValueExpression on the UIComponent. + +See javax.faces.component.UIComponent#getAttributes() +See javax.faces.component.UIComponent#setValueExpression(java.lang.String, javax.el.ValueExpression)
]]>Register a DateTimeConverter instance on the UIComponent associated with the closest parent UIComponent custom +action.
]]>Register a NumberConverter instance on the UIComponent associated with the closest parent UIComponent custom action.
]]>Register a named facet on the UIComponent associated with the closest parent UIComponent custom action.
]]>+TODO: We should find a way to save loaded bundles in the state, because otherwise on the next request the bundle map +will not be present before the render phase and value bindings that reference to the bundle will always log annoying +"Variable 'xxx' could not be resolved" error messages. +
Load a resource bundle localized for the Locale of the current view, and expose it (as a Map) in the request +attributes of the current request.
]]>+UISelectItems should be nested inside a UISelectMany or UISelectOne component, +and results in the addition of one ore more SelectItem instance to the list of available options +for the parent component +
null
]]>+Commonly associated with an h:inputText entity, but may be applied to any input component. +
++Some validators may allow the component to use attributes to define component-specific validation constraints; see +the f:attribute tag. See also the "validator" attribute of all input components, which allows a component to specify +an arbitrary validation <i>method</i> (rather than a registered validation type, as this tag does). +
++Unless otherwise specified, all attributes accept static values or EL expressions. +
Register a named Validator instance on the UIComponent associated with the closest parent UIComponent custom +action.
]]>+Unless otherwise specified, all attributes accept static values or EL expressions. +
Register an ValueChangeListener instance on the UIComponent associated with the closest parent UIComponent custom +action.
]]>+See the javadoc for this class in the JSF +Specification for further details. +
Container for all JavaServer Faces core and custom component actions used on a page.
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+The non-facet child components of this column are re-rendered on each table row +to generate the content of the cell. Those child components can reference the "var" +attribute of the containing h:dataTable to generate appropriate output for each row. +
]]>+If the value is a string literal, it is treated as a navigation outcome for the current view. This +is functionally equivalent to a reference to an action method that returns the string literal. +
]]>+If the value is a string literal, it is treated as a navigation outcome for the current view. This +is functionally equivalent to a reference to an action method that returns the string literal. +
]]>+If the value is a string literal, it is treated as a navigation outcome for the current view. This +is functionally equivalent to a reference to an action method that returns the string literal. +
]]>+The non-facet children of this component are expected to be +h:column components which describe the columns of the table. +
]]>+Note in particular that unordered collections, eg Set are not supported. Therefore if the value expression +references such an object then the table will be considered to contain just one element - the collection itself. +
]]>+This value must be a static value, ie an EL expression is not permitted. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+The set of available options is defined by adding child +f:selectItem or f:selectItems components to this component. +
++The value attribute must be a value-binding expression to a +property of type List, Object array or primitive array. That +"collection" is expected to contain objects of the same type as +SelectItem.getValue() returns for the child SelectItem objects. +On rendering, any child whose value is in the list will be +selected initially. During the update phase, the property setter +is called to replace the original collection with a completely +new collection object of the appropriate type. The new collection +object contains the value of each child SelectItem object that +is currently selected. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+The list is rendered as an HTML select element. The "multiple" +attribute is set on the element and the size attribute is set to +the provided value, defaulting to the number of items in the list +if no value is provided. If the size is set to 1, then a +"drop-down" list (aka "combo-box") is presented, though if this is +the intention then a selectManyMenu should be used instead. +
++The value attribute must be a value-binding expression to a +property of type List, Object array or primitive array. That +"collection" is expected to contain objects of the same type as +SelectItem.getValue() returns for the child SelectItem objects. +On rendering, any child whose value is in the list will be +selected initially. During the update phase, the property is set +to contain a "collection" of values for those child SelectItem +objects that are currently selected. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+Renders as an HTML select element, with the choices made up of +child f:selectItem or f:selectItems elements. The multiple +attribute is set and the size attribute is set to 1. +
++The value attribute must be a value-binding expression to a +property of type List, Object array or primitive array. That +"collection" is expected to contain objects of the same type as +SelectItem.getValue() returns for the child SelectItem objects. +On rendering, any child whose value is in the list will be +selected initially. During the update phase, the property is set +to contain a "collection" of values for those child SelectItem +objects that are currently selected. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+The available choices are defined via child f:selectItem or +f:selectItems elements. The size of the listbox defaults to the +number of available choices; if size is explicitly set to a +smaller value, then scrollbars will be rendered. If size is set +to 1 then a "drop-down menu" (aka "combo-box") is rendered, though +if this is the intent then selectOneMenu should be used instead. +
++The value attribute of this component is read to determine +which of the available options is initially selected; its value +should match the "value" property of one of the child SelectItem +objects. +
++On submit of the enclosing form, the value attribute's bound +property is updated to contain the "value" property from the +chosen SelectItem. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+The value attribute of this component is read to determine +which of the available options is initially selected; its value +should match the "value" property of one of the child SelectItem +objects. +
++On submit of the enclosing form, the value attribute's bound property +is updated to contain the "value" property from the chosen SelectItem. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+The value attribute of this component is read to determine +which of the available options is initially selected; its value should +match the "value" property of one of the child SelectItem objects. +
++On submit of the enclosing form, the value attribute's bound property +is updated to contain the "value" property from the chosen SelectItem. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+The non-facet child components of this column are re-rendered on each table row +to generate the content of the cell. Those child components can reference the "var" +attribute of the containing h:dataTable to generate appropriate output for each row. +
]]>+If the value is a string literal, it is treated as a navigation outcome for the current view. This +is functionally equivalent to a reference to an action method that returns the string literal. +
]]>+If the value is a string literal, it is treated as a navigation outcome for the current view. This +is functionally equivalent to a reference to an action method that returns the string literal. +
]]>+If the value is a string literal, it is treated as a navigation outcome for the current view. This +is functionally equivalent to a reference to an action method that returns the string literal. +
]]>+The non-facet children of this component are expected to be +h:column components which describe the columns of the table. +
]]>+Note in particular that unordered collections, eg Set are not supported. Therefore if the value expression +references such an object then the table will be considered to contain just one element - the collection itself. +
]]>+This value must be a static value, ie an EL expression is not permitted. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+The set of available options is defined by adding child +f:selectItem or f:selectItems components to this component. +
++The value attribute must be a value-binding expression to a +property of type List, Object array or primitive array. That +"collection" is expected to contain objects of the same type as +SelectItem.getValue() returns for the child SelectItem objects. +On rendering, any child whose value is in the list will be +selected initially. During the update phase, the property setter +is called to replace the original collection with a completely +new collection object of the appropriate type. The new collection +object contains the value of each child SelectItem object that +is currently selected. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+The list is rendered as an HTML select element. The "multiple" +attribute is set on the element and the size attribute is set to +the provided value, defaulting to the number of items in the list +if no value is provided. If the size is set to 1, then a +"drop-down" list (aka "combo-box") is presented, though if this is +the intention then a selectManyMenu should be used instead. +
++The value attribute must be a value-binding expression to a +property of type List, Object array or primitive array. That +"collection" is expected to contain objects of the same type as +SelectItem.getValue() returns for the child SelectItem objects. +On rendering, any child whose value is in the list will be +selected initially. During the update phase, the property is set +to contain a "collection" of values for those child SelectItem +objects that are currently selected. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+Renders as an HTML select element, with the choices made up of +child f:selectItem or f:selectItems elements. The multiple +attribute is set and the size attribute is set to 1. +
++The value attribute must be a value-binding expression to a +property of type List, Object array or primitive array. That +"collection" is expected to contain objects of the same type as +SelectItem.getValue() returns for the child SelectItem objects. +On rendering, any child whose value is in the list will be +selected initially. During the update phase, the property is set +to contain a "collection" of values for those child SelectItem +objects that are currently selected. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+The available choices are defined via child f:selectItem or +f:selectItems elements. The size of the listbox defaults to the +number of available choices; if size is explicitly set to a +smaller value, then scrollbars will be rendered. If size is set +to 1 then a "drop-down menu" (aka "combo-box") is rendered, though +if this is the intent then selectOneMenu should be used instead. +
++The value attribute of this component is read to determine +which of the available options is initially selected; its value +should match the "value" property of one of the child SelectItem +objects. +
++On submit of the enclosing form, the value attribute's bound +property is updated to contain the "value" property from the +chosen SelectItem. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+The value attribute of this component is read to determine +which of the available options is initially selected; its value +should match the "value" property of one of the child SelectItem +objects. +
++On submit of the enclosing form, the value attribute's bound property +is updated to contain the "value" property from the chosen SelectItem. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>+The value attribute of this component is read to determine +which of the available options is initially selected; its value should +match the "value" property of one of the child SelectItem objects. +
++On submit of the enclosing form, the value attribute's bound property +is updated to contain the "value" property from the chosen SelectItem. +
]]>+Default value: false. +
]]>+The method is expected to have the prototype +
+public void aMethod(FacesContext, UIComponent,Object)]]>