Author: akazakov Date: 2008-06-07 08:32:10 -0400 (Sat, 07 Jun 2008) New Revision: 8632 Modified: branches/jbosstools-2.1.x/common/plugins/org.jboss.tools.common.kb/schemas/tld/JsfHtmlBasic1_2.xml Log: http://jira.jboss.com/jira/browse/JBIDE-2314 Fixed in trunk and 2.1.* brunch Modified: branches/jbosstools-2.1.x/common/plugins/org.jboss.tools.common.kb/schemas/tld/JsfHtmlBasic1_2.xml =================================================================== --- branches/jbosstools-2.1.x/common/plugins/org.jboss.tools.common.kb/schemas/tld/JsfHtmlBasic1_2.xml 2008-06-07 12:27:35 UTC (rev 8631) +++ branches/jbosstools-2.1.x/common/plugins/org.jboss.tools.common.kb/schemas/tld/JsfHtmlBasic1_2.xml 2008-06-07 12:32:10 UTC (rev 8632) @@ -3,61 +3,61 @@ <schema location="" prefix="h" uri="http://java.sun.com/jsf/html" version="1.2"> <element-type body-content="refused" content="mixed" end-tag="required" name="commandButton" start-tag="required"> - <description>&lt;p&gt;Renders an HTML "input" element.&lt;/p&gt; - - &lt;p&gt;Decode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;Obtain the &lt;code&gt;Map&lt;/code&gt; from the "requestParameterMap" - property of the &lt;code&gt;ExternalContext&lt;/code&gt;. If the value in the - &lt;code&gt;Map&lt;/code&gt; for the value of the "clientId" property of the - component is &lt;code&gt;null&lt;/code&gt;, 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 - &lt;code&gt;null&lt;/code&gt; is the value in the &lt;code&gt;Map&lt;/code&gt; for both - Strings, return from &lt;code&gt;decode()&lt;/code&gt;. If the value in the - &lt;code&gt;Map&lt;/code&gt; for the value of the "clientId" property of the - component is not &lt;code&gt;null&lt;/code&gt;, 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 - &lt;code&gt;decode()&lt;/code&gt;. Otherwise, create a - &lt;code&gt;javax.faces.event.ActionEvent&lt;/code&gt; around the component, - and pass it to the &lt;code&gt;queueEvent()&lt;/code&gt; method of the - component, which must be an instance of - &lt;code&gt;UICommand&lt;/code&gt;.&lt;/p&gt; - - &lt;/ul&gt; - - - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;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 - &lt;code&gt;getResourceURL()&lt;/code&gt; method of the - &lt;code&gt;ViewHandler&lt;/code&gt; for this application, and passing the - result through the &lt;code&gt;encodeResourceURL()&lt;/code&gt; method of the - &lt;code&gt;ExternalContext&lt;/code&gt;. When handling the "image" - attribute, the value must not be escaped. For example, - &lt;code&gt;&amp;&lt;/code&gt; must not be turned into &lt;code&gt;&amp;amp;amp;&lt;/code&gt;. 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.&lt;/p&gt; - + <description>&lt;p&gt;Renders an HTML "input" element.&lt;/p&gt; + + &lt;p&gt;Decode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;Obtain the &lt;code&gt;Map&lt;/code&gt; from the "requestParameterMap" + property of the &lt;code&gt;ExternalContext&lt;/code&gt;. If the value in the + &lt;code&gt;Map&lt;/code&gt; for the value of the "clientId" property of the + component is &lt;code&gt;null&lt;/code&gt;, 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 + &lt;code&gt;null&lt;/code&gt; is the value in the &lt;code&gt;Map&lt;/code&gt; for both + Strings, return from &lt;code&gt;decode()&lt;/code&gt;. If the value in the + &lt;code&gt;Map&lt;/code&gt; for the value of the "clientId" property of the + component is not &lt;code&gt;null&lt;/code&gt;, 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 + &lt;code&gt;decode()&lt;/code&gt;. Otherwise, create a + &lt;code&gt;javax.faces.event.ActionEvent&lt;/code&gt; around the component, + and pass it to the &lt;code&gt;queueEvent()&lt;/code&gt; method of the + component, which must be an instance of + &lt;code&gt;UICommand&lt;/code&gt;.&lt;/p&gt; + + &lt;/ul&gt; + + + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;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 + &lt;code&gt;getResourceURL()&lt;/code&gt; method of the + &lt;code&gt;ViewHandler&lt;/code&gt; for this application, and passing the + result through the &lt;code&gt;encodeResourceURL()&lt;/code&gt; method of the + &lt;code&gt;ExternalContext&lt;/code&gt;. When handling the "image" + attribute, the value must not be escaped. For example, + &lt;code&gt;&amp;&lt;/code&gt; must not be turned into &lt;code&gt;&amp;amp;amp;&lt;/code&gt;. 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.&lt;/p&gt; + &lt;/ul&gt;</description> - <attribute-type name="action" required="false"> - <description>MethodExpression representing the application action to invoke - when this component is activated by the user. The expression - must evaluate to a public method that takes no parameters, and - returns an Object (the toString() of which is called to derive - the logical outcome) which is passed to the NavigationHandler + <attribute-type name="action" required="true"> + <description>MethodExpression representing the application action to invoke + when this component is activated by the user. The expression + must evaluate to a public method that takes no parameters, and + returns an Object (the toString() of which is called to derive + the logical outcome) which is passed to the NavigationHandler for this application.</description> <proposal type="jsfVariables"/> <proposal type="beanProperty"/> @@ -68,9 +68,9 @@ </attribute-type> <attribute type="action"/> <attribute-type name="actionListener" required="false"> - <description>MethodExpression representing an action listener method that will be - notified when this component is activated by the user. The - expression must evaluate to a public method that takes an + <description>MethodExpression representing an action listener method that will be + notified when this component is activated by the user. The + expression must evaluate to a public method that takes an ActionEvent parameter, with a return type of void.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -82,15 +82,15 @@ </attribute-type> <attribute type="actionListener"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="immediate" required="false"> - <description>Flag indicating that, if this component is activated by the user, - notifications should be delivered to interested listeners and actions - immediately (that is, during Apply Request Values phase) rather than + <description>Flag indicating that, if this component is activated by the user, + notifications should be delivered to interested listeners and actions + immediately (that is, during Apply Request Values phase) rather than waiting until Invoke Application phase.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -102,8 +102,8 @@ </attribute-type> <attribute type="immediate"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -114,7 +114,7 @@ </proposal> </attribute-type> <attribute type="rendered"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -122,7 +122,7 @@ </attribute-type> <attribute type="value"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -130,7 +130,7 @@ </attribute-type> <attribute type="accesskey"/> <attribute-type name="alt" required="false"> - <description>Alternate textual description of the + <description>Alternate textual description of the element rendered by this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -138,7 +138,7 @@ </attribute-type> <attribute type="alt"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -150,9 +150,9 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="disabled" required="false"> - <description>Flag indicating that this element must never receive focus or - be included in a subsequent submit. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this element must never receive focus or + be included in a subsequent submit. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as disabled="disabled".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -164,12 +164,12 @@ </attribute-type> <attribute type="disabled"/> <attribute-type name="image" required="false"> - <description>Absolute or relative URL of the image - to be displayed for this button. If - specified, this "input" element will be - of type "image". Otherwise, it will be - of the type specified by the "type" - property with a label specified by the + <description>Absolute or relative URL of the image + to be displayed for this button. If + specified, this "input" element will be + of type "image". Otherwise, it will be + of the type specified by the "type" + property with a label specified by the "value" property.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -189,7 +189,7 @@ </attribute-type> <attribute type="label"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -204,7 +204,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onchange" required="false"> - <description>Javascript code executed when this element loses focus + <description>Javascript code executed when this element loses focus and its value has been modified since gaining focus.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -212,7 +212,7 @@ </attribute-type> <attribute type="onchange"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -220,7 +220,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -235,7 +235,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -243,7 +243,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -251,7 +251,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -259,7 +259,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -267,7 +267,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -275,7 +275,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -283,7 +283,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -291,7 +291,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -299,7 +299,7 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="onselect" required="false"> - <description>Javascript code executed when text within this + <description>Javascript code executed when text within this element is selected by the user.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -307,10 +307,10 @@ </attribute-type> <attribute type="onselect"/> <attribute-type name="readonly" required="false"> - <description>Flag indicating that this component will prohibit changes by - the user. The element may receive focus unless it has also - been disabled. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this component will prohibit changes by + the user. The element may receive focus unless it has also + been disabled. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as readonly="readonly".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -329,8 +329,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -338,8 +338,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -347,7 +347,7 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -355,8 +355,8 @@ </attribute-type> <attribute type="title"/> <attribute-type name="type" required="false"> - <description>Type of button to create. Valid values are "submit" and - "reset". If not specified, or not a valid value, the default + <description>Type of button to create. Valid values are "submit" and + "reset". If not specified, or not a valid value, the default value is "submit".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -376,130 +376,130 @@ </attribute-type> <attribute type="binding"/> </element-type> - <element-type body-content="allowed" content="mixed" + <element-type body-content="refused" content="mixed" end-tag="required" name="commandLink" start-tag="required"> - <description>&lt;p&gt;Render an HTML "a" anchor element that acts like a - form submit button when clicked.&lt;/p&gt; - - &lt;p&gt;General Behaviour&lt;/p&gt; - - &lt;p&gt;Both the encode and decode behavior require the ability to get - the id/name for a hidden field whose value is set by the - JavaScript form submit. This name must be constructed as - follows:&lt;/p&gt; - - &lt;ul&gt; - - &lt;li&gt;&lt;p&gt;Get the clientId for the form of which this component is a - child.&lt;/p&gt;&lt;/li&gt; - - &lt;li&gt;&lt;p&gt;Append - &lt;code&gt;NamingContainer.SEPARATOR_CHAR&lt;/code&gt;.&lt;/p&gt;&lt;/li&gt; - - &lt;li&gt;&lt;p&gt;Append a constant string that is the same for all command - link components in the tree.&lt;/p&gt;&lt;/li&gt; - - &lt;/ul&gt; - - &lt;p&gt;In the following text, this String is called - hiddenFieldName.&lt;/p&gt; - - &lt;p&gt;Decode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;Obtain the "clientId" property of the component. Obtain the - &lt;code&gt;Map&lt;/code&gt; from the "requestParameterMap" property of the - &lt;code&gt;ExternalContext&lt;/code&gt;. Derive hiddenFieldName as above. - Get the entry in the &lt;code&gt;Map&lt;/code&gt; 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 &lt;code&gt;javax.faces.event.ActionEvent&lt;/code&gt; instance - around the component and call &lt;code&gt;queueActionEvent()&lt;/code&gt; on - the component, passing the event.&lt;/p&gt; - - &lt;/ul&gt; - - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;If the value of the &lt;code&gt;disabled&lt;/code&gt; attribute is - &lt;code&gt;true&lt;/code&gt;, render a span element. Render all the passthru - attributes and the &lt;code&gt;target&lt;/code&gt; attribute as pass-through - attributes on the span, even though the &lt;code&gt;target&lt;/code&gt; - attribute will have no effect on a span. Render the current value - of the component as the content of the span. Return.&lt;/p&gt; - - &lt;p&gt;If the &lt;code&gt;disabled&lt;/code&gt; attribute is not present, or its - value is &lt;code&gt;false&lt;/code&gt;, render an HTML &lt;code&gt;a&lt;/code&gt; - 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:&lt;/p&gt; - - &lt;p&gt;&lt;code&gt;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;&lt;/code&gt;&lt;/p&gt; - - &lt;p&gt;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:&lt;/p&gt; - - &lt;p&gt;&lt;code&gt;var a=function(){#USER_FUNCTION#}; - var b=function(){#JSF_FUNCTION#}; - return (a()==false) ? false : b();&lt;/code&gt;&lt;/p&gt; - &lt;p&gt;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.&lt;/p&gt; - &lt;p&gt;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.&lt;/p&gt; - - &lt;p&gt;If the user specified a &lt;code&gt;target&lt;/code&gt; attribute, its - value must be set using javascript since the &lt;code&gt;onclick&lt;/code&gt; - handler will prevent the target attribute from being generated. - This must be accomplished using JavaScript that is equivalent to - the following.&lt;/p&gt; - - &lt;p&gt;&lt;code&gt;document.forms['CLIENT_ID'].target='TARGET';&lt;/p&gt; - - &lt;p&gt;Where TARGET is the value of the target attribute on the JSP - tag.&lt;/p&gt; - + <description>&lt;p&gt;Render an HTML "a" anchor element that acts like a + form submit button when clicked.&lt;/p&gt; + + &lt;p&gt;General Behaviour&lt;/p&gt; + + &lt;p&gt;Both the encode and decode behavior require the ability to get + the id/name for a hidden field whose value is set by the + JavaScript form submit. This name must be constructed as + follows:&lt;/p&gt; + + &lt;ul&gt; + + &lt;li&gt;&lt;p&gt;Get the clientId for the form of which this component is a + child.&lt;/p&gt;&lt;/li&gt; + + &lt;li&gt;&lt;p&gt;Append + &lt;code&gt;NamingContainer.SEPARATOR_CHAR&lt;/code&gt;.&lt;/p&gt;&lt;/li&gt; + + &lt;li&gt;&lt;p&gt;Append a constant string that is the same for all command + link components in the tree.&lt;/p&gt;&lt;/li&gt; + + &lt;/ul&gt; + + &lt;p&gt;In the following text, this String is called + hiddenFieldName.&lt;/p&gt; + + &lt;p&gt;Decode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;Obtain the "clientId" property of the component. Obtain the + &lt;code&gt;Map&lt;/code&gt; from the "requestParameterMap" property of the + &lt;code&gt;ExternalContext&lt;/code&gt;. Derive hiddenFieldName as above. + Get the entry in the &lt;code&gt;Map&lt;/code&gt; 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 &lt;code&gt;javax.faces.event.ActionEvent&lt;/code&gt; instance + around the component and call &lt;code&gt;queueActionEvent()&lt;/code&gt; on + the component, passing the event.&lt;/p&gt; + + &lt;/ul&gt; + + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;If the value of the &lt;code&gt;disabled&lt;/code&gt; attribute is + &lt;code&gt;true&lt;/code&gt;, render a span element. Render all the passthru + attributes and the &lt;code&gt;target&lt;/code&gt; attribute as pass-through + attributes on the span, even though the &lt;code&gt;target&lt;/code&gt; + attribute will have no effect on a span. Render the current value + of the component as the content of the span. Return.&lt;/p&gt; + + &lt;p&gt;If the &lt;code&gt;disabled&lt;/code&gt; attribute is not present, or its + value is &lt;code&gt;false&lt;/code&gt;, render an HTML &lt;code&gt;a&lt;/code&gt; + 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:&lt;/p&gt; + + &lt;p&gt;&lt;code&gt;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;&lt;/code&gt;&lt;/p&gt; + + &lt;p&gt;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:&lt;/p&gt; + + &lt;p&gt;&lt;code&gt;var a=function(){#USER_FUNCTION#}; + var b=function(){#JSF_FUNCTION#}; + return (a()==false) ? false : b();&lt;/code&gt;&lt;/p&gt; + &lt;p&gt;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.&lt;/p&gt; + &lt;p&gt;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.&lt;/p&gt; + + &lt;p&gt;If the user specified a &lt;code&gt;target&lt;/code&gt; attribute, its + value must be set using javascript since the &lt;code&gt;onclick&lt;/code&gt; + handler will prevent the target attribute from being generated. + This must be accomplished using JavaScript that is equivalent to + the following.&lt;/p&gt; + + &lt;p&gt;&lt;code&gt;document.forms['CLIENT_ID'].target='TARGET';&lt;/p&gt; + + &lt;p&gt;Where TARGET is the value of the target attribute on the JSP + tag.&lt;/p&gt; + &lt;/ul&gt;</description> - <attribute-type name="action" required="false"> - <description>MethodExpression representing the application action to invoke - when this component is activated by the user. The expression - must evaluate to a public method that takes no parameters, and - returns an Object (the toString() of which is called to derive - the logical outcome) which is passed to the NavigationHandler + <attribute-type name="action" required="true"> + <description>MethodExpression representing the application action to invoke + when this component is activated by the user. The expression + must evaluate to a public method that takes no parameters, and + returns an Object (the toString() of which is called to derive + the logical outcome) which is passed to the NavigationHandler for this application.</description> <proposal type="jsfVariables"/> <proposal type="beanProperty"/> @@ -510,9 +510,9 @@ </attribute-type> <attribute type="action"/> <attribute-type name="actionListener" required="false"> - <description>MethodExpression representing an action listener method that will be - notified when this component is activated by the user. The - expression must evaluate to a public method that takes an + <description>MethodExpression representing an action listener method that will be + notified when this component is activated by the user. The + expression must evaluate to a public method that takes an ActionEvent parameter, with a return type of void.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -524,15 +524,15 @@ </attribute-type> <attribute type="actionListener"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="immediate" required="false"> - <description>Flag indicating that, if this component is activated by the user, - notifications should be delivered to interested listeners and actions - immediately (that is, during Apply Request Values phase) rather than + <description>Flag indicating that, if this component is activated by the user, + notifications should be delivered to interested listeners and actions + immediately (that is, during Apply Request Values phase) rather than waiting until Invoke Application phase.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -544,8 +544,8 @@ </attribute-type> <attribute type="immediate"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -556,7 +556,7 @@ </proposal> </attribute-type> <attribute type="rendered"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -564,7 +564,7 @@ </attribute-type> <attribute type="value"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -572,7 +572,7 @@ </attribute-type> <attribute type="accesskey"/> <attribute-type name="charset" required="false"> - <description>The character encoding of the resource designated + <description>The character encoding of the resource designated by this hyperlink.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -580,7 +580,7 @@ </attribute-type> <attribute type="charset"/> <attribute-type name="coords" required="false"> - <description>The position and shape of the hot spot on the screen + <description>The position and shape of the hot spot on the screen (for use in client-side image maps).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -588,7 +588,7 @@ </attribute-type> <attribute type="coords"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -600,8 +600,8 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="disabled" required="false"> - <description>Flag indicating that this element must never - receive focus or be included in a subsequent + <description>Flag indicating that this element must never + receive focus or be included in a subsequent submit.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -613,7 +613,7 @@ </attribute-type> <attribute type="disabled"/> <attribute-type name="hreflang" required="false"> - <description>The language code of the resource designated + <description>The language code of the resource designated by this hyperlink.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -621,7 +621,7 @@ </attribute-type> <attribute type="hreflang"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -636,7 +636,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -644,7 +644,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -659,7 +659,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -667,7 +667,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -675,7 +675,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -683,7 +683,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -691,7 +691,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -699,7 +699,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -707,7 +707,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -715,7 +715,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -723,9 +723,9 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="rel" required="false"> - <description>The relationship from the current document - to the anchor specified by this hyperlink. - The value of this attribute is a space-separated + <description>The relationship from the current document + to the anchor specified by this hyperlink. + The value of this attribute is a space-separated list of link types.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -733,9 +733,9 @@ </attribute-type> <attribute type="rel"/> <attribute-type name="rev" required="false"> - <description>A reverse link from the anchor specified - by this hyperlink to the current document. - The value of this attribute is a space-separated + <description>A reverse link from the anchor specified + by this hyperlink to the current document. + The value of this attribute is a space-separated list of link types.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -743,10 +743,10 @@ </attribute-type> <attribute type="rev"/> <attribute-type name="shape" required="false"> - <description>The shape of the hot spot on the screen - (for use in client-side image maps). Valid - values are: default (entire region); rect - (rectangular region); circle (circular region); + <description>The shape of the hot spot on the screen + (for use in client-side image maps). Valid + values are: default (entire region); rect + (rectangular region); circle (circular region); and poly (polygonal region).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -767,8 +767,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -776,8 +776,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -785,8 +785,8 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="target" required="false"> - <description>Name of a frame where the resource - retrieved via this hyperlink is to + <description>Name of a frame where the resource + retrieved via this hyperlink is to be displayed.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -794,7 +794,7 @@ </attribute-type> <attribute type="target"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -802,7 +802,7 @@ </attribute-type> <attribute type="title"/> <attribute-type name="type" required="false"> - <description>The content type of the resource designated + <description>The content type of the resource designated by this hyperlink.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -820,92 +820,92 @@ </element-type> <element-type body-content="allowed" content="mixed" end-tag="required" name="dataTable" start-tag="required"> - <description>&lt;p&gt;Renders an HTML "table" element compliant with the HTML 401 - specification. Render the "caption" facet, if present, inside a "caption" - element immediately below the "table" element. If the "captionClass" - attribute is specified, render its value as the value of the "class" - attribute on the "caption" element. If the "captionStyle" attribute - is specified, render its value as the value of the "style" attribute - on the "caption" element.&lt;/p&gt; - &lt;p&gt;Please consult the javadoc for &lt;code&gt;UIData&lt;/code&gt; - 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. &lt;/p&gt; - - &lt;p&gt;Rendering the header&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;If the &lt;code&gt;UIData&lt;/code&gt; component has a "header" facet, or - any of the child &lt;code&gt;UIColumn&lt;/code&gt; components has a "header" - facet, render a "thead" element. If the &lt;code&gt;UIData&lt;/code&gt; - component has a "header" facet, encode its contents inside of "tr" - and "th" elements, respectively. Output the value of the - "headerClass" attribute of the &lt;code&gt;UIData&lt;/code&gt; component, if - present, as the value of the "class" attribute on the "th". - Output the number of child &lt;code&gt;UIColumn&lt;/code&gt; components of the - &lt;code&gt;UIData&lt;/code&gt; component as the value of the "colspan" - attribute on the "th". Output "colgroup" as the value of the - "scope" attribute on the "th" element. &lt;/p&gt; - - &lt;p&gt;If any of the child &lt;code&gt;UIColumn&lt;/code&gt; components has a - "header" facet render a "tr" element. For each - &lt;code&gt;UIColumn&lt;/code&gt; 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 &lt;code&gt;UIColumn&lt;/code&gt; - component, if present, as the value of the "class" attribute on - the "th". If the "headerClass" attribute of the &lt;code&gt;UIColumn&lt;/code&gt; - component is not present, output the value of the "headerClass" - attribute of the &lt;code&gt;UIData&lt;/code&gt; 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. - &lt;/p&gt; - - &lt;p&gt;Close out the "thead" element.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Rendering the footer&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;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.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Rendering the table body&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;Render a "tbody" element. Keep track of the result of the - "rows" property on the &lt;code&gt;UIData&lt;/code&gt; component. Keep track - of the number of rows we have rendered so far. Iterate through - the rows. Set the "rowIndex" property of the &lt;code&gt;UIData&lt;/code&gt; - 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 &lt;code&gt;UIData&lt;/code&gt; returned false. - Output a "tr" element. Output the value of the "rowClasses" per - the attribute description below. For each &lt;code&gt;UIColumn&lt;/code&gt; - child, output a "td" element, attaching the value of the - "columnClasses" attribute of the &lt;code&gt;UIData&lt;/code&gt; component per - the attribute description below. Recursively encode each child of - each &lt;code&gt;UIColumn&lt;/code&gt; child. Close out the "td" element. - When done with the row, close out the "tr" element. When done - with all the rows, close out the "tbody" element.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;When done rendering all the rows, set the "rowIndex" property of - the &lt;code&gt;UIData&lt;/code&gt; to -1, and close out the "table" + <description>&lt;p&gt;Renders an HTML "table" element compliant with the HTML 401 + specification. Render the "caption" facet, if present, inside a "caption" + element immediately below the "table" element. If the "captionClass" + attribute is specified, render its value as the value of the "class" + attribute on the "caption" element. If the "captionStyle" attribute + is specified, render its value as the value of the "style" attribute + on the "caption" element.&lt;/p&gt; + &lt;p&gt;Please consult the javadoc for &lt;code&gt;UIData&lt;/code&gt; + 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. &lt;/p&gt; + + &lt;p&gt;Rendering the header&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;If the &lt;code&gt;UIData&lt;/code&gt; component has a "header" facet, or + any of the child &lt;code&gt;UIColumn&lt;/code&gt; components has a "header" + facet, render a "thead" element. If the &lt;code&gt;UIData&lt;/code&gt; + component has a "header" facet, encode its contents inside of "tr" + and "th" elements, respectively. Output the value of the + "headerClass" attribute of the &lt;code&gt;UIData&lt;/code&gt; component, if + present, as the value of the "class" attribute on the "th". + Output the number of child &lt;code&gt;UIColumn&lt;/code&gt; components of the + &lt;code&gt;UIData&lt;/code&gt; component as the value of the "colspan" + attribute on the "th". Output "colgroup" as the value of the + "scope" attribute on the "th" element. &lt;/p&gt; + + &lt;p&gt;If any of the child &lt;code&gt;UIColumn&lt;/code&gt; components has a + "header" facet render a "tr" element. For each + &lt;code&gt;UIColumn&lt;/code&gt; 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 &lt;code&gt;UIColumn&lt;/code&gt; + component, if present, as the value of the "class" attribute on + the "th". If the "headerClass" attribute of the &lt;code&gt;UIColumn&lt;/code&gt; + component is not present, output the value of the "headerClass" + attribute of the &lt;code&gt;UIData&lt;/code&gt; 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. + &lt;/p&gt; + + &lt;p&gt;Close out the "thead" element.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Rendering the footer&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;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.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Rendering the table body&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;Render a "tbody" element. Keep track of the result of the + "rows" property on the &lt;code&gt;UIData&lt;/code&gt; component. Keep track + of the number of rows we have rendered so far. Iterate through + the rows. Set the "rowIndex" property of the &lt;code&gt;UIData&lt;/code&gt; + 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 &lt;code&gt;UIData&lt;/code&gt; returned false. + Output a "tr" element. Output the value of the "rowClasses" per + the attribute description below. For each &lt;code&gt;UIColumn&lt;/code&gt; + child, output a "td" element, attaching the value of the + "columnClasses" attribute of the &lt;code&gt;UIData&lt;/code&gt; component per + the attribute description below. Recursively encode each child of + each &lt;code&gt;UIColumn&lt;/code&gt; child. Close out the "td" element. + When done with the row, close out the "tr" element. When done + with all the rows, close out the "tbody" element.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;When done rendering all the rows, set the "rowIndex" property of + the &lt;code&gt;UIData&lt;/code&gt; to -1, and close out the "table" element.&lt;/p&gt;</description> <attribute-type name="first" required="false"> - <description>Zero-relative row number of the first row to be displayed. If this - property is set to zero, rendering will begin with the first row of + <description>Zero-relative row number of the first row to be displayed. If this + property is set to zero, rendering will begin with the first row of the underlying data.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -913,14 +913,14 @@ </attribute-type> <attribute type="first"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -932,24 +932,24 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="rows" required="false"> - <description>The number of rows to display, starting with the one identified by the - "first" property. If this value is set to zero, all available rows in + <description>The number of rows to display, starting with the one identified by the + "first" property. If this value is set to zero, all available rows in the underlying data model will be displayed.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="rows"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="value"/> - <attribute-type name="var" required="false"> - <description>Name of a request-scope attribute under which the model data for the - row selected by the current value of the "rowIndex" property (i.e. + <attribute-type name="var" required="true"> + <description>Name of a request-scope attribute under which the model data for the + row selected by the current value of the "rowIndex" property (i.e. also the current value of the "rowData" property) will be exposed.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -964,7 +964,7 @@ </attribute-type> <attribute type="bgcolor"/> <attribute-type name="border" required="false"> - <description>Width (in pixels) of the border to be drawn + <description>Width (in pixels) of the border to be drawn around this table.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -972,7 +972,7 @@ </attribute-type> <attribute type="border"/> <attribute-type name="captionClass" required="false"> - <description>Space-separated list of CSS style class(es) that will be + <description>Space-separated list of CSS style class(es) that will be applied to any caption generated for this table.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -987,7 +987,7 @@ </attribute-type> <attribute type="captionStyle"/> <attribute-type name="cellpadding" required="false"> - <description>Definition of how much space the user agent should + <description>Definition of how much space the user agent should leave between the border of each cell and its contents.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -995,11 +995,11 @@ </attribute-type> <attribute type="cellpadding"/> <attribute-type name="cellspacing" required="false"> - <description>Definition of how much space the user agent should - leave between the left side of the table and the - leftmost column, the top of the table and the top of - the top side of the topmost row, and so on for the - right and bottom of the table. It also specifies + <description>Definition of how much space the user agent should + leave between the left side of the table and the + leftmost column, the top of the table and the top of + the top side of the topmost row, and so on for the + right and bottom of the table. It also specifies the amount of space to leave between cells.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1007,15 +1007,15 @@ </attribute-type> <attribute type="cellspacing"/> <attribute-type name="columnClasses" required="false"> - <description>Comma-delimited list of CSS style classes that will be applied - to the columns of this table. A space separated list of - classes may also be specified for any individual column. If - the number of elements in this list is less than the number of - columns specified in the "columns" attribute, no "class" - attribute is output for each column greater than the number of - elements in the list. If the number of elements in the list - is greater than the number of columns specified in the - "columns" attribute, the elements at the posisiton in the list + <description>Comma-delimited list of CSS style classes that will be applied + to the columns of this table. A space separated list of + classes may also be specified for any individual column. If + the number of elements in this list is less than the number of + columns specified in the "columns" attribute, no "class" + attribute is output for each column greater than the number of + elements in the list. If the number of elements in the list + is greater than the number of columns specified in the + "columns" attribute, the elements at the posisiton in the list after the value of the "columns" attribute are ignored.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1023,7 +1023,7 @@ </attribute-type> <attribute type="columnClasses"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1035,7 +1035,7 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="footerClass" required="false"> - <description>Space-separated list of CSS style class(es) that will be + <description>Space-separated list of CSS style class(es) that will be applied to any footer generated for this table.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1043,12 +1043,12 @@ </attribute-type> <attribute type="footerClass"/> <attribute-type name="frame" required="false"> - <description>Code specifying which sides of the frame surrounding - this table will be visible. Valid values are: - none (no sides, default value); above (top side only); - below (bottom side only); hsides (top and bottom sides - only); vsides (right and left sides only); lhs (left - hand side only); rhs (right hand side only); box + <description>Code specifying which sides of the frame surrounding + this table will be visible. Valid values are: + none (no sides, default value); above (top side only); + below (bottom side only); hsides (top and bottom sides + only); vsides (right and left sides only); lhs (left + hand side only); rhs (right hand side only); box (all four sides); and border (all four sides).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1067,7 +1067,7 @@ </attribute-type> <attribute type="frame"/> <attribute-type name="headerClass" required="false"> - <description>Space-separated list of CSS style class(es) that will be + <description>Space-separated list of CSS style class(es) that will be applied to any header generated for this table.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1075,7 +1075,7 @@ </attribute-type> <attribute type="headerClass"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1083,7 +1083,7 @@ </attribute-type> <attribute type="lang"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1091,7 +1091,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1099,7 +1099,7 @@ </attribute-type> <attribute type="ondblclick"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1107,7 +1107,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1115,7 +1115,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1123,7 +1123,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1131,7 +1131,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1139,7 +1139,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1147,7 +1147,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1155,7 +1155,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1163,14 +1163,14 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="rowClasses" required="false"> - <description>Comma-delimited list of CSS style classes that will be applied - to the rows of this table. A space separated list of classes - may also be specified for any individual row. Thes styles are - applied, in turn, to each row in the table. For example, if - the list has two elements, the first style class in the list - is applied to the first row, the second to the second row, the - first to the third row, the second to the fourth row, etc. In - other words, we keep iterating through the list until we reach + <description>Comma-delimited list of CSS style classes that will be applied + to the rows of this table. A space separated list of classes + may also be specified for any individual row. Thes styles are + applied, in turn, to each row in the table. For example, if + the list has two elements, the first style class in the list + is applied to the first row, the second to the second row, the + first to the third row, the second to the fourth row, etc. In + other words, we keep iterating through the list until we reach the end, and then we start at the beginning again.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1178,10 +1178,10 @@ </attribute-type> <attribute type="rowClasses"/> <attribute-type name="rules" required="false"> - <description>Code specifying which rules will appear between cells - within this table. Valid values are: none (no rules, - default value); groups (between row groups); rows - (between rows only); cols (between columns only); and + <description>Code specifying which rules will appear between cells + within this table. Valid values are: none (no rules, + default value); groups (between row groups); rows + (between rows only); cols (between columns only); and all (between all rows and columns).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1203,8 +1203,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1212,8 +1212,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="summary" required="false"> - <description>Summary of this table's purpose and structure, for - user agents rendering to non-visual media such as + <description>Summary of this table's purpose and structure, for + user agents rendering to non-visual media such as speech and Braille.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1221,7 +1221,7 @@ </attribute-type> <attribute type="summary"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1246,53 +1246,53 @@ </element-type> <element-type body-content="allowed" content="mixed" end-tag="required" name="form" start-tag="required"> - <description>&lt;p&gt;Renders an HTML "form" element.&lt;/p&gt; - - &lt;p&gt;Decode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;Obtain the &lt;code&gt;Map&lt;/code&gt; from the "requestParameterMap" - property of the &lt;code&gt;ExternalContext&lt;/code&gt;. If the map contains - an entry for the "clientId" of this &lt;code&gt;UIForm&lt;/code&gt; component, - call &lt;code&gt;setSubmitted(true)&lt;/code&gt; on the form, otherwise call - &lt;code&gt;setSubmitted(false)&lt;/code&gt; on the form.&lt;/p&gt; - - &lt;/ul&gt; - - - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;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 &lt;code&gt;getActionURL()&lt;/code&gt; - method of the &lt;code&gt;ViewHandler&lt;/code&gt; for this application, then - passing that String to the &lt;code&gt;encodeActionURL()&lt;/code&gt; method - on the &lt;code&gt;ExternalContext&lt;/code&gt;. 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. Call &lt;code&gt;ViewHandler.writeState()&lt;/code&gt; - 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. Render a "name" - attribute with a value the same as the "id" attribute as described - in "&lt;a href="renderkit-summary.html"&gt;General Notes on - Encoding&lt;/a&gt;" regarding the "id" attribute for UIInput - components.&lt;/p&gt; - + <description>&lt;p&gt;Renders an HTML "form" element.&lt;/p&gt; + + &lt;p&gt;Decode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;Obtain the &lt;code&gt;Map&lt;/code&gt; from the "requestParameterMap" + property of the &lt;code&gt;ExternalContext&lt;/code&gt;. If the map contains + an entry for the "clientId" of this &lt;code&gt;UIForm&lt;/code&gt; component, + call &lt;code&gt;setSubmitted(true)&lt;/code&gt; on the form, otherwise call + &lt;code&gt;setSubmitted(false)&lt;/code&gt; on the form.&lt;/p&gt; + + &lt;/ul&gt; + + + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;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 &lt;code&gt;getActionURL()&lt;/code&gt; + method of the &lt;code&gt;ViewHandler&lt;/code&gt; for this application, then + passing that String to the &lt;code&gt;encodeActionURL()&lt;/code&gt; method + on the &lt;code&gt;ExternalContext&lt;/code&gt;. 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. Call &lt;code&gt;ViewHandler.writeState()&lt;/code&gt; + 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. Render a "name" + attribute with a value the same as the "id" attribute as described + in "&lt;a href="renderkit-summary.html"&gt;General Notes on + Encoding&lt;/a&gt;" regarding the "id" attribute for UIInput + components.&lt;/p&gt; + &lt;/ul&gt;</description> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="prependId" required="false"> - <description>Flag indicating whether or not this form should prepend its id - to its descendent's id during the clientId generation process. + <description>Flag indicating whether or not this form should prepend its id + to its descendent's id during the clientId generation process. If this flag is not set, the default value is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1300,8 +1300,8 @@ </attribute-type> <attribute type="prependId"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1313,7 +1313,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="accept" required="false"> - <description>List of content types that a server processing this form + <description>List of content types that a server processing this form will handle correctly</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1321,8 +1321,8 @@ </attribute-type> <attribute type="accept"/> <attribute-type name="acceptcharset" required="false"> - <description>List of character encodings for input data - that are accepted by the server processing + <description>List of character encodings for input data + that are accepted by the server processing this form.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1330,7 +1330,7 @@ </attribute-type> <attribute type="acceptcharset"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1342,8 +1342,8 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="enctype" required="false"> - <description>Content type used to submit the form to the server. If not - specified, the default value is + <description>Content type used to submit the form to the server. If not + specified, the default value is "application/x-www-form-urlencoded".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1351,7 +1351,7 @@ </attribute-type> <attribute type="enctype"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1359,7 +1359,7 @@ </attribute-type> <attribute type="lang"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1367,7 +1367,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1375,7 +1375,7 @@ </attribute-type> <attribute type="ondblclick"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1383,7 +1383,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1391,7 +1391,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1399,7 +1399,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1407,7 +1407,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1415,7 +1415,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1423,7 +1423,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1431,7 +1431,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1460,8 +1460,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1469,8 +1469,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="target" required="false"> - <description>Name of a frame where the response - retrieved after this form submit is to + <description>Name of a frame where the response + retrieved after this form submit is to be displayed.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1478,7 +1478,7 @@ </attribute-type> <attribute type="target"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1496,28 +1496,28 @@ </element-type> <element-type body-content="refused" content="mixed" end-tag="required" name="graphicImage" start-tag="required"> - <description>Renders an HTML "img" element. Render - the clientId as the value of the "id" attribute. Render the - value of the component as the value of the "src" attribute, - after passing it to the &lt;code&gt;getResourceURL()&lt;/code&gt; method - of the &lt;code&gt;ViewHandler&lt;/code&gt; for this application, and - passing the result through the - &lt;code&gt;encodeResourceURL()&lt;/code&gt; method of the - &lt;code&gt;ExternalContext&lt;/code&gt;. When handling the "src" - attribute, the value must not be escaped. For example, - &lt;code&gt;&amp;&lt;/code&gt; must not be turned into &lt;code&gt;&amp;amp;amp;&lt;/code&gt;. - If the "styleClass" attribute - is specified, render its value as the value of the "class" + <description>Renders an HTML "img" element. Render + the clientId as the value of the "id" attribute. Render the + value of the component as the value of the "src" attribute, + after passing it to the &lt;code&gt;getResourceURL()&lt;/code&gt; method + of the &lt;code&gt;ViewHandler&lt;/code&gt; for this application, and + passing the result through the + &lt;code&gt;encodeResourceURL()&lt;/code&gt; method of the + &lt;code&gt;ExternalContext&lt;/code&gt;. When handling the "src" + attribute, the value must not be escaped. For example, + &lt;code&gt;&amp;&lt;/code&gt; must not be turned into &lt;code&gt;&amp;amp;amp;&lt;/code&gt;. + If the "styleClass" attribute + is specified, render its value as the value of the "class" attribute.</description> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1529,7 +1529,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="url" required="false"> - <description>Context-relative URL to retrieve the resource associated with + <description>Context-relative URL to retrieve the resource associated with this component. This is an alias for the "value" property.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1539,7 +1539,7 @@ </proposal> </attribute-type> <attribute type="url"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1550,7 +1550,7 @@ </attribute-type> <attribute type="value"/> <attribute-type name="alt" required="false"> - <description>Alternate textual description of the + <description>Alternate textual description of the element rendered by this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1558,7 +1558,7 @@ </attribute-type> <attribute type="alt"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1577,10 +1577,10 @@ </attribute-type> <attribute type="height"/> <attribute-type name="ismap" required="false"> - <description>Flag indicating that this image is to be used as a server side - image map. Such an image must be enclosed within a hyperlink - ("a"). A value of false causes no attribute to be rendered, - while a value of true causes the attribute to be rendered as + <description>Flag indicating that this image is to be used as a server side + image map. Such an image must be enclosed within a hyperlink + ("a"). A value of false causes no attribute to be rendered, + while a value of true causes the attribute to be rendered as ismap="ismap".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1592,7 +1592,7 @@ </attribute-type> <attribute type="ismap"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1600,7 +1600,7 @@ </attribute-type> <attribute type="lang"/> <attribute-type name="longdesc" required="false"> - <description>URI to a long description of the image + <description>URI to a long description of the image represented by this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1608,7 +1608,7 @@ </attribute-type> <attribute type="longdesc"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1616,7 +1616,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1624,7 +1624,7 @@ </attribute-type> <attribute type="ondblclick"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1632,7 +1632,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1640,7 +1640,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1648,7 +1648,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1656,7 +1656,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1664,7 +1664,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1672,7 +1672,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1680,7 +1680,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1695,8 +1695,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1704,7 +1704,7 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1712,7 +1712,7 @@ </attribute-type> <attribute type="title"/> <attribute-type name="usemap" required="false"> - <description>The name of a client side image map (an HTML "map" + <description>The name of a client side image map (an HTML "map" element) for which this element provides the image.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1737,27 +1737,27 @@ </element-type> <element-type body-content="refused" content="mixed" end-tag="required" name="inputHidden" start-tag="required"> - <description>&lt;p&gt;Renders an HTML "input" element of type - "hidden".&lt;/p&gt; - - &lt;p&gt;Decode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;See the decode description for the &lt;a - href="javax.faces.Inputjavax.faces.Text.html#encode"&gt;Input - Text&lt;/a&gt; renderer.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;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.&lt;/p&gt; - + <description>&lt;p&gt;Renders an HTML "input" element of type + "hidden".&lt;/p&gt; + + &lt;p&gt;Decode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;See the decode description for the &lt;a + href="javax.faces.Inputjavax.faces.Text.html#encode"&gt;Input + Text&lt;/a&gt; renderer.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;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.&lt;/p&gt; + &lt;/ul&gt;</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -1767,8 +1767,8 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="converterMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the converter message, replacing any message + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the converter message, replacing any message that comes from the converter.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1776,15 +1776,15 @@ </attribute-type> <attribute type="converterMessage"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="immediate" required="false"> - <description>Flag indicating that this component's value must be - converted and validated immediately (that is, during - Apply Request Values phase), rather than waiting + <description>Flag indicating that this component's value must be + converted and validated immediately (that is, during + Apply Request Values phase), rather than waiting until Process Validations phase.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1796,8 +1796,8 @@ </attribute-type> <attribute type="immediate"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1809,7 +1809,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="required" required="false"> - <description>Flag indicating that the user is required to provide a submitted + <description>Flag indicating that the user is required to provide a submitted value for this input component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1821,8 +1821,8 @@ </attribute-type> <attribute type="required"/> <attribute-type name="requiredMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validation message for the "required" + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validation message for the "required" facility, if the "required" facility is used.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1830,10 +1830,10 @@ </attribute-type> <attribute type="requiredMessage"/> <attribute-type name="validator" required="false"> - <description>MethodExpression representing a validator method that will be called - during Process Validations to perform correctness checks on the - value of this component. The expression must evaluate to a public - method that takes FacesContext, UIComponent, and Object parameters, + <description>MethodExpression representing a validator method that will be called + during Process Validations to perform correctness checks on the + value of this component. The expression must evaluate to a public + method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.</description> <proposal type="jsfVariables"/> <proposal type="beanProperty"/> @@ -1846,15 +1846,15 @@ </attribute-type> <attribute type="validator"/> <attribute-type name="validatorMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validator message, replacing any + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validator message, replacing any message that comes from the validator.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="validatorMessage"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1862,9 +1862,9 @@ </attribute-type> <attribute type="value"/> <attribute-type name="valueChangeListener" required="false"> - <description>MethodExpression representing a value change listener method that will be - notified when a new value has been set for this input component. The - expression must evaluate to a public method that takes a + <description>MethodExpression representing a value change listener method that will be + notified when a new value has been set for this input component. The + expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1886,30 +1886,30 @@ </element-type> <element-type body-content="refused" content="mixed" end-tag="required" name="inputSecret" start-tag="required"> - <description>&lt;p&gt;Renders an HTML "input" element of "type" "password".&lt;/p&gt; - - &lt;p&gt;Decode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;See the decode description for the &lt;a - href="javax.faces.Inputjavax.faces.Text.html#encode"&gt;Input - Text&lt;/a&gt; renderer.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt; - 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.&lt;/p&gt; - + <description>&lt;p&gt;Renders an HTML "input" element of "type" "password".&lt;/p&gt; + + &lt;p&gt;Decode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;See the decode description for the &lt;a + href="javax.faces.Inputjavax.faces.Text.html#encode"&gt;Input + Text&lt;/a&gt; renderer.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt; + 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.&lt;/p&gt; + &lt;/ul&gt;</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -1919,8 +1919,8 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="converterMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the converter message, replacing any message + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the converter message, replacing any message that comes from the converter.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1928,15 +1928,15 @@ </attribute-type> <attribute type="converterMessage"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="immediate" required="false"> - <description>Flag indicating that this component's value must be - converted and validated immediately (that is, during - Apply Request Values phase), rather than waiting + <description>Flag indicating that this component's value must be + converted and validated immediately (that is, during + Apply Request Values phase), rather than waiting until Process Validations phase.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1948,8 +1948,8 @@ </attribute-type> <attribute type="immediate"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1961,7 +1961,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="required" required="false"> - <description>Flag indicating that the user is required to provide a submitted + <description>Flag indicating that the user is required to provide a submitted value for this input component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1973,8 +1973,8 @@ </attribute-type> <attribute type="required"/> <attribute-type name="requiredMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validation message for the "required" + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validation message for the "required" facility, if the "required" facility is used.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -1982,10 +1982,10 @@ </attribute-type> <attribute type="requiredMessage"/> <attribute-type name="validator" required="false"> - <description>MethodExpression representing a validator method that will be called - during Process Validations to perform correctness checks on the - value of this component. The expression must evaluate to a public - method that takes FacesContext, UIComponent, and Object parameters, + <description>MethodExpression representing a validator method that will be called + during Process Validations to perform correctness checks on the + value of this component. The expression must evaluate to a public + method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.</description> <proposal type="jsfVariables"/> <proposal type="beanProperty"/> @@ -1998,15 +1998,15 @@ </attribute-type> <attribute type="validator"/> <attribute-type name="validatorMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validator message, replacing any + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validator message, replacing any message that comes from the validator.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="validatorMessage"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2014,9 +2014,9 @@ </attribute-type> <attribute type="value"/> <attribute-type name="valueChangeListener" required="false"> - <description>MethodExpression representing a value change listener method that will be - notified when a new value has been set for this input component. The - expression must evaluate to a public method that takes a + <description>MethodExpression representing a value change listener method that will be + notified when a new value has been set for this input component. The + expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2028,7 +2028,7 @@ </attribute-type> <attribute type="valueChangeListener"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2036,7 +2036,7 @@ </attribute-type> <attribute type="accesskey"/> <attribute-type name="alt" required="false"> - <description>Alternate textual description of the + <description>Alternate textual description of the element rendered by this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2044,11 +2044,11 @@ </attribute-type> <attribute type="alt"/> <attribute-type name="autocomplete" required="false"> - <description>If the value of this attribute is "off", render "off" as the value - of the attribute. This indicates that the browser should - disable its autocomplete feature for this component. This is - useful for components that perform autocompletion and do not - want the browser interfering. If this attribute is not set or the value + <description>If the value of this attribute is "off", render "off" as the value + of the attribute. This indicates that the browser should + disable its autocomplete feature for this component. This is + useful for components that perform autocompletion and do not + want the browser interfering. If this attribute is not set or the value is "on", render nothing.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2056,7 +2056,7 @@ </attribute-type> <attribute type="autocomplete"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2068,9 +2068,9 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="disabled" required="false"> - <description>Flag indicating that this element must never receive focus or - be included in a subsequent submit. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this element must never receive focus or + be included in a subsequent submit. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as disabled="disabled".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2089,7 +2089,7 @@ </attribute-type> <attribute type="label"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2097,7 +2097,7 @@ </attribute-type> <attribute type="lang"/> <attribute-type name="maxlength" required="false"> - <description>The maximum number of characters that may + <description>The maximum number of characters that may be entered in this field.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2112,7 +2112,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onchange" required="false"> - <description>Javascript code executed when this element loses focus + <description>Javascript code executed when this element loses focus and its value has been modified since gaining focus.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2120,7 +2120,7 @@ </attribute-type> <attribute type="onchange"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2128,7 +2128,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2143,7 +2143,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2151,7 +2151,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2159,7 +2159,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2167,7 +2167,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2175,7 +2175,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2183,7 +2183,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2191,7 +2191,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2199,7 +2199,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2207,7 +2207,7 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="onselect" required="false"> - <description>Javascript code executed when text within this + <description>Javascript code executed when text within this element is selected by the user.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2215,10 +2215,10 @@ </attribute-type> <attribute type="onselect"/> <attribute-type name="readonly" required="false"> - <description>Flag indicating that this component will prohibit changes by - the user. The element may receive focus unless it has also - been disabled. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this component will prohibit changes by + the user. The element may receive focus unless it has also + been disabled. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as readonly="readonly".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2230,10 +2230,10 @@ </attribute-type> <attribute type="readonly"/> <attribute-type name="redisplay" required="false"> - <description>Flag indicating that any existing value - in this field should be rendered when the - form is created. Because this is a potential - security risk, password values are not + <description>Flag indicating that any existing value + in this field should be rendered when the + form is created. Because this is a potential + security risk, password values are not displayed by default.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2245,7 +2245,7 @@ </attribute-type> <attribute type="redisplay"/> <attribute-type name="size" required="false"> - <description>The number of characters used to determine + <description>The number of characters used to determine the width of this field.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2260,8 +2260,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2269,8 +2269,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2278,7 +2278,7 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2296,33 +2296,33 @@ </element-type> <element-type body-content="refused" content="mixed" end-tag="required" name="inputText" start-tag="required"> - <description>&lt;p&gt;Renders an HTML "input" - element of "type" "text".&lt;/p&gt; - - &lt;p&gt;&lt;a name="decode"&gt;Decode Behavior&lt;/a&gt;&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;Obtain the &lt;code&gt;Map&lt;/code&gt; from the "requestParameterMap" - property of the &lt;code&gt;ExternalContext&lt;/code&gt;. If the - &lt;code&gt;Map&lt;/code&gt; contains an entry for the "clientId" of the - component, pass the value of the entry to the - &lt;code&gt;setSubmittedValue()&lt;/code&gt; method of the component, which - must be an instance of &lt;code&gt;EditableValueHolder&lt;/code&gt;.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt; 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. - &lt;/p&gt; - + <description>&lt;p&gt;Renders an HTML "input" + element of "type" "text".&lt;/p&gt; + + &lt;p&gt;&lt;a name="decode"&gt;Decode Behavior&lt;/a&gt;&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;Obtain the &lt;code&gt;Map&lt;/code&gt; from the "requestParameterMap" + property of the &lt;code&gt;ExternalContext&lt;/code&gt;. If the + &lt;code&gt;Map&lt;/code&gt; contains an entry for the "clientId" of the + component, pass the value of the entry to the + &lt;code&gt;setSubmittedValue()&lt;/code&gt; method of the component, which + must be an instance of &lt;code&gt;EditableValueHolder&lt;/code&gt;.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt; 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. + &lt;/p&gt; + &lt;/ul&gt;</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -2332,8 +2332,8 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="converterMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the converter message, replacing any message + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the converter message, replacing any message that comes from the converter.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2341,15 +2341,15 @@ </attribute-type> <attribute type="converterMessage"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="immediate" required="false"> - <description>Flag indicating that this component's value must be - converted and validated immediately (that is, during - Apply Request Values phase), rather than waiting + <description>Flag indicating that this component's value must be + converted and validated immediately (that is, during + Apply Request Values phase), rather than waiting until Process Validations phase.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2361,8 +2361,8 @@ </attribute-type> <attribute type="immediate"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2374,7 +2374,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="required" required="false"> - <description>Flag indicating that the user is required to provide a submitted + <description>Flag indicating that the user is required to provide a submitted value for this input component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2386,8 +2386,8 @@ </attribute-type> <attribute type="required"/> <attribute-type name="requiredMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validation message for the "required" + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validation message for the "required" facility, if the "required" facility is used.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2395,10 +2395,10 @@ </attribute-type> <attribute type="requiredMessage"/> <attribute-type name="validator" required="false"> - <description>MethodExpression representing a validator method that will be called - during Process Validations to perform correctness checks on the - value of this component. The expression must evaluate to a public - method that takes FacesContext, UIComponent, and Object parameters, + <description>MethodExpression representing a validator method that will be called + during Process Validations to perform correctness checks on the + value of this component. The expression must evaluate to a public + method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.</description> <proposal type="jsfVariables"/> <proposal type="beanProperty"/> @@ -2411,15 +2411,15 @@ </attribute-type> <attribute type="validator"/> <attribute-type name="validatorMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validator message, replacing any + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validator message, replacing any message that comes from the validator.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="validatorMessage"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2427,9 +2427,9 @@ </attribute-type> <attribute type="value"/> <attribute-type name="valueChangeListener" required="false"> - <description>MethodExpression representing a value change listener method that will be - notified when a new value has been set for this input component. The - expression must evaluate to a public method that takes a + <description>MethodExpression representing a value change listener method that will be + notified when a new value has been set for this input component. The + expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2441,7 +2441,7 @@ </attribute-type> <attribute type="valueChangeListener"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2449,7 +2449,7 @@ </attribute-type> <attribute type="accesskey"/> <attribute-type name="alt" required="false"> - <description>Alternate textual description of the + <description>Alternate textual description of the element rendered by this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2457,11 +2457,11 @@ </attribute-type> <attribute type="alt"/> <attribute-type name="autocomplete" required="false"> - <description>If the value of this attribute is "off", render "off" as the value - of the attribute. This indicates that the browser should - disable its autocomplete feature for this component. This is - useful for components that perform autocompletion and do not - want the browser interfering. If this attribute is not set or the value + <description>If the value of this attribute is "off", render "off" as the value + of the attribute. This indicates that the browser should + disable its autocomplete feature for this component. This is + useful for components that perform autocompletion and do not + want the browser interfering. If this attribute is not set or the value is "on", render nothing.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2469,7 +2469,7 @@ </attribute-type> <attribute type="autocomplete"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2481,9 +2481,9 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="disabled" required="false"> - <description>Flag indicating that this element must never receive focus or - be included in a subsequent submit. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this element must never receive focus or + be included in a subsequent submit. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as disabled="disabled".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2502,7 +2502,7 @@ </attribute-type> <attribute type="label"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2510,7 +2510,7 @@ </attribute-type> <attribute type="lang"/> <attribute-type name="maxlength" required="false"> - <description>The maximum number of characters that may + <description>The maximum number of characters that may be entered in this field.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2525,7 +2525,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onchange" required="false"> - <description>Javascript code executed when this element loses focus + <description>Javascript code executed when this element loses focus and its value has been modified since gaining focus.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2533,7 +2533,7 @@ </attribute-type> <attribute type="onchange"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2541,7 +2541,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2556,7 +2556,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2564,7 +2564,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2572,7 +2572,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2580,7 +2580,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2588,7 +2588,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2596,7 +2596,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2604,7 +2604,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2612,7 +2612,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2620,7 +2620,7 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="onselect" required="false"> - <description>Javascript code executed when text within this + <description>Javascript code executed when text within this element is selected by the user.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2628,10 +2628,10 @@ </attribute-type> <attribute type="onselect"/> <attribute-type name="readonly" required="false"> - <description>Flag indicating that this component will prohibit changes by - the user. The element may receive focus unless it has also - been disabled. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this component will prohibit changes by + the user. The element may receive focus unless it has also + been disabled. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as readonly="readonly".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2643,7 +2643,7 @@ </attribute-type> <attribute type="readonly"/> <attribute-type name="size" required="false"> - <description>The number of characters used to determine + <description>The number of characters used to determine the width of this field.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2658,8 +2658,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2667,8 +2667,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2676,7 +2676,7 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2692,27 +2692,27 @@ </attribute-type> <attribute type="binding"/> </element-type> - <element-type body-content="allowed" content="mixed" + <element-type body-content="refused" content="mixed" end-tag="required" name="inputTextarea" start-tag="required"> - <description>&lt;p&gt;Renders an HTML "textarea" element.&lt;/p&gt; - - &lt;p&gt;Decode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;See the encode description for the &lt;a - href="javax.faces.Inputjavax.faces.Text.html#encode"&gt;Input - Text&lt;/a&gt; renderer.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt; Render the - clientId as the value of the "name" attribute. Render the current - valu eof the component inside the "textarea" + <description>&lt;p&gt;Renders an HTML "textarea" element.&lt;/p&gt; + + &lt;p&gt;Decode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;See the encode description for the &lt;a + href="javax.faces.Inputjavax.faces.Text.html#encode"&gt;Input + Text&lt;/a&gt; renderer.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt; Render the + clientId as the value of the "name" attribute. Render the current + valu eof the component inside the "textarea" element.&lt;/p&gt; &lt;/ul&gt;</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -2722,8 +2722,8 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="converterMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the converter message, replacing any message + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the converter message, replacing any message that comes from the converter.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2731,15 +2731,15 @@ </attribute-type> <attribute type="converterMessage"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="immediate" required="false"> - <description>Flag indicating that this component's value must be - converted and validated immediately (that is, during - Apply Request Values phase), rather than waiting + <description>Flag indicating that this component's value must be + converted and validated immediately (that is, during + Apply Request Values phase), rather than waiting until Process Validations phase.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2751,8 +2751,8 @@ </attribute-type> <attribute type="immediate"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2764,7 +2764,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="required" required="false"> - <description>Flag indicating that the user is required to provide a submitted + <description>Flag indicating that the user is required to provide a submitted value for this input component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2776,8 +2776,8 @@ </attribute-type> <attribute type="required"/> <attribute-type name="requiredMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validation message for the "required" + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validation message for the "required" facility, if the "required" facility is used.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2785,10 +2785,10 @@ </attribute-type> <attribute type="requiredMessage"/> <attribute-type name="validator" required="false"> - <description>MethodExpression representing a validator method that will be called - during Process Validations to perform correctness checks on the - value of this component. The expression must evaluate to a public - method that takes FacesContext, UIComponent, and Object parameters, + <description>MethodExpression representing a validator method that will be called + during Process Validations to perform correctness checks on the + value of this component. The expression must evaluate to a public + method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.</description> <proposal type="jsfVariables"/> <proposal type="beanProperty"/> @@ -2801,15 +2801,15 @@ </attribute-type> <attribute type="validator"/> <attribute-type name="validatorMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validator message, replacing any + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validator message, replacing any message that comes from the validator.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="validatorMessage"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2817,9 +2817,9 @@ </attribute-type> <attribute type="value"/> <attribute-type name="valueChangeListener" required="false"> - <description>MethodExpression representing a value change listener method that will be - notified when a new value has been set for this input component. The - expression must evaluate to a public method that takes a + <description>MethodExpression representing a value change listener method that will be + notified when a new value has been set for this input component. The + expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2831,7 +2831,7 @@ </attribute-type> <attribute type="valueChangeListener"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2846,7 +2846,7 @@ </attribute-type> <attribute type="cols"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2858,9 +2858,9 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="disabled" required="false"> - <description>Flag indicating that this element must never receive focus or - be included in a subsequent submit. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this element must never receive focus or + be included in a subsequent submit. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as disabled="disabled".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2879,7 +2879,7 @@ </attribute-type> <attribute type="label"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2894,7 +2894,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onchange" required="false"> - <description>Javascript code executed when this element loses focus + <description>Javascript code executed when this element loses focus and its value has been modified since gaining focus.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2902,7 +2902,7 @@ </attribute-type> <attribute type="onchange"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2910,7 +2910,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2925,7 +2925,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2933,7 +2933,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2941,7 +2941,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2949,7 +2949,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2957,7 +2957,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2965,7 +2965,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2973,7 +2973,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2981,7 +2981,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2989,7 +2989,7 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="onselect" required="false"> - <description>Javascript code executed when text within this + <description>Javascript code executed when text within this element is selected by the user.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -2997,10 +2997,10 @@ </attribute-type> <attribute type="onselect"/> <attribute-type name="readonly" required="false"> - <description>Flag indicating that this component will prohibit changes by - the user. The element may receive focus unless it has also - been disabled. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this component will prohibit changes by + the user. The element may receive focus unless it has also + been disabled. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as readonly="readonly".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3026,8 +3026,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3035,8 +3035,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3044,7 +3044,7 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3062,61 +3062,61 @@ </element-type> <element-type body-content="refused" content="mixed" end-tag="required" name="message" start-tag="required"> - <description>&lt;p&gt;Render a single message for a specific component.&lt;/p&gt; - - &lt;p&gt;Set-up for Rendering&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;Obtain the "summary" and "detail" properties from - &lt;code&gt;UIMessage&lt;/code&gt; component. If not present, keep the - empty string as the value, respectively. Obtain the first - &lt;code&gt;FacesMessage&lt;/code&gt; to render from the component, using - the "for" property of the &lt;code&gt;UIMessage&lt;/code&gt;. This will be - the only message we render. Obtain the severity style for this - message. If the severity of the message is - &lt;code&gt;FacesMessage.SEVERITY_INFO&lt;/code&gt;, the severity style - comes from the value of the "infoStyle" attribute. If the - severity of the message is - &lt;code&gt;FacesMessage.SEVERITY_WARN&lt;/code&gt;, the severity style - comes from the value of the "warnStyle" attribute, and so on for - each of the severities, &lt;code&gt;INFO, WARN, ERROR&lt;/code&gt; and - &lt;code&gt;FATAL&lt;/code&gt;. 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 - &lt;code&gt;UIMessage&lt;/code&gt; 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 &lt;code&gt;dir&lt;/code&gt; and &lt;code&gt;lang&lt;/code&gt; attributes.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Rendering&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;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 - &lt;code&gt;UIMessage&lt;/code&gt; has a "tooltip" attribute with the value of - "true", and the &lt;code&gt;UIMessage&lt;/code&gt; 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.&lt;/p&gt; - + <description>&lt;p&gt;Render a single message for a specific component.&lt;/p&gt; + + &lt;p&gt;Set-up for Rendering&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;Obtain the "summary" and "detail" properties from + &lt;code&gt;UIMessage&lt;/code&gt; component. If not present, keep the + empty string as the value, respectively. Obtain the first + &lt;code&gt;FacesMessage&lt;/code&gt; to render from the component, using + the "for" property of the &lt;code&gt;UIMessage&lt;/code&gt;. This will be + the only message we render. Obtain the severity style for this + message. If the severity of the message is + &lt;code&gt;FacesMessage.SEVERITY_INFO&lt;/code&gt;, the severity style + comes from the value of the "infoStyle" attribute. If the + severity of the message is + &lt;code&gt;FacesMessage.SEVERITY_WARN&lt;/code&gt;, the severity style + comes from the value of the "warnStyle" attribute, and so on for + each of the severities, &lt;code&gt;INFO, WARN, ERROR&lt;/code&gt; and + &lt;code&gt;FATAL&lt;/code&gt;. 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 + &lt;code&gt;UIMessage&lt;/code&gt; 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 &lt;code&gt;dir&lt;/code&gt; and &lt;code&gt;lang&lt;/code&gt; attributes.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Rendering&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;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 + &lt;code&gt;UIMessage&lt;/code&gt; has a "tooltip" attribute with the value of + "true", and the &lt;code&gt;UIMessage&lt;/code&gt; 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.&lt;/p&gt; + &lt;/ul&gt;</description> <attribute-type name="for" required="true"> <description>Client identifier of the component for which to display messages.</description> @@ -3126,14 +3126,14 @@ </attribute-type> <attribute type="for"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3145,7 +3145,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="showDetail" required="false"> - <description>Flag indicating whether the summary portion of displayed messages + <description>Flag indicating whether the summary portion of displayed messages should be included. Default value is "true".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3157,7 +3157,7 @@ </attribute-type> <attribute type="showDetail"/> <attribute-type name="showSummary" required="false"> - <description>Flag indicating whether the summary portion of displayed messages + <description>Flag indicating whether the summary portion of displayed messages should be included. Default value is "false".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3169,7 +3169,7 @@ </attribute-type> <attribute type="showSummary"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3181,7 +3181,7 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="errorClass" required="false"> - <description>CSS style class to apply to any message + <description>CSS style class to apply to any message with a severity class of "ERROR".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3189,7 +3189,7 @@ </attribute-type> <attribute type="errorClass"/> <attribute-type name="errorStyle" required="false"> - <description>CSS style(s) to apply to any message + <description>CSS style(s) to apply to any message with a severity class of "ERROR".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3197,7 +3197,7 @@ </attribute-type> <attribute type="errorStyle"/> <attribute-type name="fatalClass" required="false"> - <description>CSS style class to apply to any message + <description>CSS style class to apply to any message with a severity class of "FATAL".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3205,7 +3205,7 @@ </attribute-type> <attribute type="fatalClass"/> <attribute-type name="fatalStyle" required="false"> - <description>CSS style(s) to apply to any message + <description>CSS style(s) to apply to any message with a severity class of "FATAL".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3213,7 +3213,7 @@ </attribute-type> <attribute type="fatalStyle"/> <attribute-type name="infoClass" required="false"> - <description>CSS style class to apply to any message + <description>CSS style class to apply to any message with a severity class of "INFO".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3221,7 +3221,7 @@ </attribute-type> <attribute type="infoClass"/> <attribute-type name="infoStyle" required="false"> - <description>CSS style(s) to apply to any message + <description>CSS style(s) to apply to any message with a severity class of "INFO".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3229,7 +3229,7 @@ </attribute-type> <attribute type="infoStyle"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3244,8 +3244,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3253,7 +3253,7 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3261,7 +3261,7 @@ </attribute-type> <attribute type="title"/> <attribute-type name="tooltip" required="false"> - <description>Flag indicating whether the detail portion of the + <description>Flag indicating whether the detail portion of the message should be displayed as a tooltip.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3273,7 +3273,7 @@ </attribute-type> <attribute type="tooltip"/> <attribute-type name="warnClass" required="false"> - <description>CSS style class to apply to any message + <description>CSS style class to apply to any message with a severity class of "WARN".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3281,7 +3281,7 @@ </attribute-type> <attribute type="warnClass"/> <attribute-type name="warnStyle" required="false"> - <description>CSS style(s) to apply to any message + <description>CSS style(s) to apply to any message with a severity class of "WARN".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3299,24 +3299,24 @@ </element-type> <element-type body-content="refused" content="mixed" end-tag="required" name="messages" start-tag="required"> - <description>&lt;p&gt;The same as for the Message renderer, but output all the - messages. If the value of the "layout" attribute is "table", - render nested "table", "tr", and "td" elements, in that order. - If the value of the "layout" attribute is "list", or the "layout" - attribute is not specified, render nested "ul", "li" elements, - in that order. Output the value of the "style" attribute as the - value of the "style" attribute, output the value of the "styleClass" - attribute as the value of the "class" attribute, and output the dir - and lang attributes. Output these values on the "table" element or - the "ul" element. The component is a &lt;code&gt;UIMessages&lt;/code&gt;, and - there is no "for" attribute. Therefore, use either &lt;code&gt;null&lt;/code&gt; - to obtain the messages from the &lt;code&gt;FacesContext&lt;/code&gt; or the - empty string if the components "globalOnly" property is &lt;code&gt;true&lt;/code&gt;. - If the layout was "table" close out the table elements, otherwise, + <description>&lt;p&gt;The same as for the Message renderer, but output all the + messages. If the value of the "layout" attribute is "table", + render nested "table", "tr", and "td" elements, in that order. + If the value of the "layout" attribute is "list", or the "layout" + attribute is not specified, render nested "ul", "li" elements, + in that order. Output the value of the "style" attribute as the + value of the "style" attribute, output the value of the "styleClass" + attribute as the value of the "class" attribute, and output the dir + and lang attributes. Output these values on the "table" element or + the "ul" element. The component is a &lt;code&gt;UIMessages&lt;/code&gt;, and + there is no "for" attribute. Therefore, use either &lt;code&gt;null&lt;/code&gt; + to obtain the messages from the &lt;code&gt;FacesContext&lt;/code&gt; or the + empty string if the components "globalOnly" property is &lt;code&gt;true&lt;/code&gt;. + If the layout was "table" close out the table elements, otherwise, close out the list elements.&lt;/p&gt;</description> <attribute-type name="globalOnly" required="false"> - <description>Flag indicating that only global messages (that is, messages not - associated with any client identifier) are to be displayed. + <description>Flag indicating that only global messages (that is, messages not + associated with any client identifier) are to be displayed. Default value is "false".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3328,14 +3328,14 @@ </attribute-type> <attribute type="globalOnly"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3347,7 +3347,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="showDetail" required="false"> - <description>Flag indicating whether the summary portion of displayed messages + <description>Flag indicating whether the summary portion of displayed messages should be included. Default value is "false".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3359,7 +3359,7 @@ </attribute-type> <attribute type="showDetail"/> <attribute-type name="showSummary" required="false"> - <description>Flag indicating whether the summary portion of displayed messages + <description>Flag indicating whether the summary portion of displayed messages should be included. Default value is "true".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3371,7 +3371,7 @@ </attribute-type> <attribute type="showSummary"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3383,7 +3383,7 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="errorClass" required="false"> - <description>CSS style class to apply to any message + <description>CSS style class to apply to any message with a severity class of "ERROR".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3391,7 +3391,7 @@ </attribute-type> <attribute type="errorClass"/> <attribute-type name="errorStyle" required="false"> - <description>CSS style(s) to apply to any message + <description>CSS style(s) to apply to any message with a severity class of "ERROR".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3399,7 +3399,7 @@ </attribute-type> <attribute type="errorStyle"/> <attribute-type name="fatalClass" required="false"> - <description>CSS style class to apply to any message + <description>CSS style class to apply to any message with a severity class of "FATAL".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3407,7 +3407,7 @@ </attribute-type> <attribute type="fatalClass"/> <attribute-type name="fatalStyle" required="false"> - <description>CSS style(s) to apply to any message + <description>CSS style(s) to apply to any message with a severity class of "FATAL".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3415,7 +3415,7 @@ </attribute-type> <attribute type="fatalStyle"/> <attribute-type name="infoClass" required="false"> - <description>CSS style class to apply to any message + <description>CSS style class to apply to any message with a severity class of "INFO".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3423,7 +3423,7 @@ </attribute-type> <attribute type="infoClass"/> <attribute-type name="infoStyle" required="false"> - <description>CSS style(s) to apply to any message + <description>CSS style(s) to apply to any message with a severity class of "INFO".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3431,7 +3431,7 @@ </attribute-type> <attribute type="infoStyle"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3439,9 +3439,9 @@ </attribute-type> <attribute type="lang"/> <attribute-type name="layout" required="false"> - <description>The type of layout markup to use when rendering - error messages. Valid values are "table" (an HTML - table) and "list" (an HTML list). If not specified, + <description>The type of layout markup to use when rendering + error messages. Valid values are "table" (an HTML + table) and "list" (an HTML list). If not specified, the default value is "list".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3460,8 +3460,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3469,7 +3469,7 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3477,7 +3477,7 @@ </attribute-type> <attribute type="title"/> <attribute-type name="tooltip" required="false"> - <description>Flag indicating whether the detail portion of the + <description>Flag indicating whether the detail portion of the message should be displayed as a tooltip.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3489,7 +3489,7 @@ </attribute-type> <attribute type="tooltip"/> <attribute-type name="warnClass" required="false"> - <description>CSS style class to apply to any message + <description>CSS style class to apply to any message with a severity class of "WARN".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3497,7 +3497,7 @@ </attribute-type> <attribute type="warnClass"/> <attribute-type name="warnStyle" required="false"> - <description>CSS style(s) to apply to any message + <description>CSS style(s) to apply to any message with a severity class of "WARN".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3515,22 +3515,22 @@ </element-type> <element-type body-content="refused" content="mixed" end-tag="required" name="outputFormat" start-tag="required"> - <description>&lt;p&gt;Render parameterized text. Obtain the - &lt;code&gt;style&lt;/code&gt;, &lt;code&gt;styleClass&lt;/code&gt;, &lt;code&gt;dir&lt;/code&gt;, and - &lt;code&gt;lang&lt;/code&gt; attributees from this component. If any are - present, render a "span" element. Output the - &lt;code&gt;styleClass&lt;/code&gt; attribute (if present) as the value of the - &lt;code&gt;class&lt;/code&gt; attribute. Output the &lt;code&gt;style&lt;/code&gt; - attribute as the value of the &lt;code&gt;style&lt;/code&gt; attribute. - Output the &lt;code&gt;dir&lt;/code&gt; and &lt;code&gt;lang&lt;/code&gt; attributes as - pass through attributes. Accrue a list of the values of all child - &lt;code&gt;UIParameter&lt;/code&gt; components of this component. If there - are one or more accumulated parameter values, convert the list of - parameter values to an &lt;code&gt;Object&lt;/code&gt; array, call - &lt;code&gt;MessageFormat.format()&lt;/code&gt;, passing the - &lt;code&gt;value&lt;/code&gt; of this component as the first argument, and - the array of parameter values as the second argument, and render - the result. Otherwise, render the &lt;code&gt;value&lt;/code&gt; of this + <description>&lt;p&gt;Render parameterized text. Obtain the + &lt;code&gt;style&lt;/code&gt;, &lt;code&gt;styleClass&lt;/code&gt;, &lt;code&gt;dir&lt;/code&gt;, and + &lt;code&gt;lang&lt;/code&gt; attributees from this component. If any are + present, render a "span" element. Output the + &lt;code&gt;styleClass&lt;/code&gt; attribute (if present) as the value of the + &lt;code&gt;class&lt;/code&gt; attribute. Output the &lt;code&gt;style&lt;/code&gt; + attribute as the value of the &lt;code&gt;style&lt;/code&gt; attribute. + Output the &lt;code&gt;dir&lt;/code&gt; and &lt;code&gt;lang&lt;/code&gt; attributes as + pass through attributes. Accrue a list of the values of all child + &lt;code&gt;UIParameter&lt;/code&gt; components of this component. If there + are one or more accumulated parameter values, convert the list of + parameter values to an &lt;code&gt;Object&lt;/code&gt; array, call + &lt;code&gt;MessageFormat.format()&lt;/code&gt;, passing the + &lt;code&gt;value&lt;/code&gt; of this component as the first argument, and + the array of parameter values as the second argument, and render + the result. Otherwise, render the &lt;code&gt;value&lt;/code&gt; of this component unmodified.&lt;/p&gt;</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -3540,14 +3540,14 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3558,7 +3558,7 @@ </proposal> </attribute-type> <attribute type="rendered"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3566,7 +3566,7 @@ </attribute-type> <attribute type="value"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3578,8 +3578,8 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="escape" required="false"> - <description>Flag indicating that characters that are sensitive - in HTML and XML markup must be escaped. This flag + <description>Flag indicating that characters that are sensitive + in HTML and XML markup must be escaped. This flag is set to "true" by default.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3591,7 +3591,7 @@ </attribute-type> <attribute type="escape"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3606,8 +3606,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3615,7 +3615,7 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3631,13 +3631,13 @@ </attribute-type> <attribute type="binding"/> </element-type> - <element-type body-content="allowed" content="mixed" + <element-type body-content="refused" content="mixed" end-tag="required" name="outputLabel" start-tag="required"> - <description>Renders an HTML "label" element. Render the current value - of the component as label text if it is specified. If a "for" attribute is - specified, find the component specified by the value of the "for" - attribute, and render its client id as the value of the "for" attribute. - If "styleClass" attribute is specified, render its value as the value + <description>Renders an HTML "label" element. Render the current value + of the component as label text if it is specified. If a "for" attribute is + specified, find the component specified by the value of the "for" + attribute, and render its client id as the value of the "for" attribute. + If "styleClass" attribute is specified, render its value as the value of the "class" attribute.</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -3647,14 +3647,14 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3665,7 +3665,7 @@ </proposal> </attribute-type> <attribute type="rendered"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3673,7 +3673,7 @@ </attribute-type> <attribute type="value"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3681,7 +3681,7 @@ </attribute-type> <attribute type="accesskey"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3693,16 +3693,16 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="escape" required="false"> - <description>Flag indicating that characters that are sensitive - in HTML and XML markup must be escaped. If omitted, this + <description>Flag indicating that characters that are sensitive + in HTML and XML markup must be escaped. If omitted, this flag is assumed to be "true".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="escape"/> - <attribute-type name="for" required="false"> - <description>Client identifier of the component for which this element + <attribute-type name="for" required="true"> + <description>Client identifier of the component for which this element is a label.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3710,7 +3710,7 @@ </attribute-type> <attribute type="for"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3725,7 +3725,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3733,7 +3733,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3748,7 +3748,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3756,7 +3756,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3764,7 +3764,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3772,7 +3772,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3780,7 +3780,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3788,7 +3788,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3796,7 +3796,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3804,7 +3804,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3819,8 +3819,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3828,8 +3828,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3837,7 +3837,7 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3855,25 +3855,25 @@ </element-type> <element-type body-content="allowed" content="mixed" end-tag="required" name="outputLink" start-tag="required"> - <description>Render an HTML "a" anchor element. The value of the - component is rendered as the value of the "href" attribute. Any - child UIParameter components are appended to the String to be - output as the value of the "href" attribute as query parameters - before rendering. The entire "href" string must be passed through - a call to the &lt;code&gt;encodeResourceURL()&lt;/code&gt; method of the - &lt;code&gt;ExternalContext&lt;/code&gt;. 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 - "&lt;a href="renderkit-summary.html"&gt;General - Notes on Encoding&lt;/a&gt;" 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 + <description>Render an HTML "a" anchor element. The value of the + component is rendered as the value of the "href" attribute. Any + child UIParameter components are appended to the String to be + output as the value of the "href" attribute as query parameters + before rendering. The entire "href" string must be passed through + a call to the &lt;code&gt;encodeResourceURL()&lt;/code&gt; method of the + &lt;code&gt;ExternalContext&lt;/code&gt;. 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 + "&lt;a href="renderkit-summary.html"&gt;General + Notes on Encoding&lt;/a&gt;" 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".</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -3883,14 +3883,14 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3901,7 +3901,7 @@ </proposal> </attribute-type> <attribute type="rendered"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3914,7 +3914,7 @@ </attribute-type> <attribute type="value"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3922,7 +3922,7 @@ </attribute-type> <attribute type="accesskey"/> <attribute-type name="charset" required="false"> - <description>The character encoding of the resource designated + <description>The character encoding of the resource designated by this hyperlink.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3930,7 +3930,7 @@ </attribute-type> <attribute type="charset"/> <attribute-type name="coords" required="false"> - <description>The position and shape of the hot spot on the screen + <description>The position and shape of the hot spot on the screen (for use in client-side image maps).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3938,7 +3938,7 @@ </attribute-type> <attribute type="coords"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3950,8 +3950,8 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="disabled" required="false"> - <description>Flag indicating that this element must never - receive focus or be included in a subsequent + <description>Flag indicating that this element must never + receive focus or be included in a subsequent submit.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3963,7 +3963,7 @@ </attribute-type> <attribute type="disabled"/> <attribute-type name="hreflang" required="false"> - <description>The language code of the resource designated + <description>The language code of the resource designated by this hyperlink.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3971,7 +3971,7 @@ </attribute-type> <attribute type="hreflang"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3986,7 +3986,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -3994,7 +3994,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4009,7 +4009,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4017,7 +4017,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4025,7 +4025,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4033,7 +4033,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4041,7 +4041,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4049,7 +4049,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4057,7 +4057,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4065,7 +4065,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4073,9 +4073,9 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="rel" required="false"> - <description>The relationship from the current document - to the anchor specified by this hyperlink. - The value of this attribute is a space-separated + <description>The relationship from the current document + to the anchor specified by this hyperlink. + The value of this attribute is a space-separated list of link types.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4083,9 +4083,9 @@ </attribute-type> <attribute type="rel"/> <attribute-type name="rev" required="false"> - <description>A reverse link from the anchor specified - by this hyperlink to the current document. - The value of this attribute is a space-separated + <description>A reverse link from the anchor specified + by this hyperlink to the current document. + The value of this attribute is a space-separated list of link types.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4093,10 +4093,10 @@ </attribute-type> <attribute type="rev"/> <attribute-type name="shape" required="false"> - <description>The shape of the hot spot on the screen - (for use in client-side image maps). Valid - values are: default (entire region); rect - (rectangular region); circle (circular region); + <description>The shape of the hot spot on the screen + (for use in client-side image maps). Valid + values are: default (entire region); rect + (rectangular region); circle (circular region); and poly (polygonal region).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4111,8 +4111,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4120,8 +4120,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4129,8 +4129,8 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="target" required="false"> - <description>Name of a frame where the resource - retrieved via this hyperlink is to + <description>Name of a frame where the resource + retrieved via this hyperlink is to be displayed.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4138,7 +4138,7 @@ </attribute-type> <attribute type="target"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4146,7 +4146,7 @@ </attribute-type> <attribute type="title"/> <attribute-type name="type" required="false"> - <description>The content type of the resource designated + <description>The content type of the resource designated by this hyperlink.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4164,15 +4164,15 @@ </element-type> <element-type body-content="refused" content="mixed" end-tag="required" name="outputText" start-tag="required"> - <description>If the "styleClass", "style", "dir" or "lang" - attributes are present, render a "span" element. If the - "styleClass" attribute is present, render its value as the value - of the "class" attribute. If the "style" attribute is present, - pass it thru. If the "escape" attribute is not present, or it is - present and its value is "true" all angle brackets should be - converted to the ampersand xx semicolon syntax when rendering the - value of the "value" attribute as the value of the component. If - the "escape" attribute is present and is "false" the value of the + <description>If the "styleClass", "style", "dir" or "lang" + attributes are present, render a "span" element. If the + "styleClass" attribute is present, render its value as the value + of the "class" attribute. If the "style" attribute is present, + pass it thru. If the "escape" attribute is not present, or it is + present and its value is "true" all angle brackets should be + converted to the ampersand xx semicolon syntax when rendering the + value of the "value" attribute as the value of the component. If + the "escape" attribute is present and is "false" the value of the component should be rendered as text without escaping.</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -4182,14 +4182,14 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4200,7 +4200,7 @@ </proposal> </attribute-type> <attribute type="rendered"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4208,7 +4208,7 @@ </attribute-type> <attribute type="value"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4220,8 +4220,8 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="escape" required="false"> - <description>Flag indicating that characters that are sensitive - in HTML and XML markup must be escaped. This flag + <description>Flag indicating that characters that are sensitive + in HTML and XML markup must be escaped. This flag is set to "true" by default.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4233,7 +4233,7 @@ </attribute-type> <attribute type="escape"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4248,8 +4248,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4257,7 +4257,7 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4275,43 +4275,43 @@ </element-type> <element-type body-content="allowed" content="mixed" end-tag="required" name="panelGrid" start-tag="required"> - <description>Renders an HTML "table" element, conforming to the - rules in the HTML 401 specification. Render the "caption" facet, - if present, inside a "caption" element immediately below the "table" element. - If the "captionClass" attribute is specified, render its value as the value - of the "class" attribute on the "caption" element. If the "captionStyle" attribute - is specified, render its value as the value of the "style" attribute - on the "caption" element. If the "styleClass" attribute is specified, render - its value as the value of the "class" attribute. Render the pass-through - attributes in the table below. Render the "header" facet, if present, inside of - "thead", "tr", and "th" elements, nested in that order. If the - "headerClass" attribute is specifed, render its value as the value - of the "class" attribute on the "th" element. Render "colgroup" - as the value of the "scope" attribute. Render the value of the - "columns" attribute as the value of the "colspan" attribute on the - "th" element. Render the "footer" facet if present, using similar - logic to the rendering of the "header", but replacing "thead" with - "tfoot", "th" with "td", and "headerClass" with "footerClass". - Render the children of the &lt;code&gt;UIPanel&lt;/code&gt; component inside - of a "tbody" element. Render the children based on the value of - the "columns" attribute, creating a new row each time a "columns" - worth of children have been rendered. For the start of each row, - render a "tr" element. Output the value of the "rowClasses" per - the attribute description below. For each child, output a "td" - element, attaching the value of the "columnClasses" attribute per - the attribute description below. Recursively encode each child. - Close out the "td" element. When done with the row, close out the - "tr" element. If a child has "rendered==false" it is not rendered, + <description>Renders an HTML "table" element, conforming to the + rules in the HTML 401 specification. Render the "caption" facet, + if present, inside a "caption" element immediately below the "table" element. + If the "captionClass" attribute is specified, render its value as the value + of the "class" attribute on the "caption" element. If the "captionStyle" attribute + is specified, render its value as the value of the "style" attribute + on the "caption" element. If the "styleClass" attribute is specified, render + its value as the value of the "class" attribute. Render the pass-through + attributes in the table below. Render the "header" facet, if present, inside of + "thead", "tr", and "th" elements, nested in that order. If the + "headerClass" attribute is specifed, render its value as the value + of the "class" attribute on the "th" element. Render "colgroup" + as the value of the "scope" attribute. Render the value of the + "columns" attribute as the value of the "colspan" attribute on the + "th" element. Render the "footer" facet if present, using similar + logic to the rendering of the "header", but replacing "thead" with + "tfoot", "th" with "td", and "headerClass" with "footerClass". + Render the children of the &lt;code&gt;UIPanel&lt;/code&gt; component inside + of a "tbody" element. Render the children based on the value of + the "columns" attribute, creating a new row each time a "columns" + worth of children have been rendered. For the start of each row, + render a "tr" element. Output the value of the "rowClasses" per + the attribute description below. For each child, output a "td" + element, attaching the value of the "columnClasses" attribute per + the attribute description below. Recursively encode each child. + Close out the "td" element. When done with the row, close out the + "tr" element. If a child has "rendered==false" it is not rendered, and the column counter must not be incremented.</description> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4330,7 +4330,7 @@ </attribute-type> <attribute type="bgcolor"/> <attribute-type name="border" required="false"> - <description>Width (in pixels) of the border to be drawn + <description>Width (in pixels) of the border to be drawn around this table.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4338,7 +4338,7 @@ </attribute-type> <attribute type="border"/> <attribute-type name="captionClass" required="false"> - <description>Space-separated list of CSS style class(es) that will be + <description>Space-separated list of CSS style class(es) that will be applied to any caption generated for this table.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4353,7 +4353,7 @@ </attribute-type> <attribute type="captionStyle"/> <attribute-type name="cellpadding" required="false"> - <description>Definition of how much space the user agent should + <description>Definition of how much space the user agent should leave between the border of each cell and its contents.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4361,11 +4361,11 @@ </attribute-type> <attribute type="cellpadding"/> <attribute-type name="cellspacing" required="false"> - <description>Definition of how much space the user agent should - leave between the left side of the table and the - leftmost column, the top of the table and the top of - the top side of the topmost row, and so on for the - right and bottom of the table. It also specifies + <description>Definition of how much space the user agent should + leave between the left side of the table and the + leftmost column, the top of the table and the top of + the top side of the topmost row, and so on for the + right and bottom of the table. It also specifies the amount of space to leave between cells.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4373,23 +4373,23 @@ </attribute-type> <attribute type="cellspacing"/> <attribute-type name="columnClasses" required="false"> - <description>Comma-delimited list of CSS style classes that will be applied - to the columns of this table. A space separated list of - classes may also be specified for any individual column. If - the number of elements in this list is less than the number of - columns specified in the "columns" attribute, no "class" - attribute is output for each column greater than the number of - elements in the list. If the number of elements in the list - is greater than the number of columns specified in the - "columns" attribute, the elements at the posisiton in the list + <description>Comma-delimited list of CSS style classes that will be applied + to the columns of this table. A space separated list of + classes may also be specified for any individual column. If + the number of elements in this list is less than the number of + columns specified in the "columns" attribute, no "class" + attribute is output for each column greater than the number of + elements in the list. If the number of elements in the list + is greater than the number of columns specified in the + "columns" attribute, the elements at the posisiton in the list after the value of the "columns" attribute are ignored.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="columnClasses"/> - <attribute-type name="columns" required="false"> - <description>The number of columns to render before + <attribute-type name="columns" required="true"> + <description>The number of columns to render before starting a new row.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4397,7 +4397,7 @@ </attribute-type> <attribute type="columns"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4409,7 +4409,7 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="footerClass" required="false"> - <description>Space-separated list of CSS style class(es) that will be + <description>Space-separated list of CSS style class(es) that will be applied to any footer generated for this table.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4417,12 +4417,12 @@ </attribute-type> <attribute type="footerClass"/> <attribute-type name="frame" required="false"> - <description>Code specifying which sides of the frame surrounding - this table will be visible. Valid values are: - none (no sides, default value); above (top side only); - below (bottom side only); hsides (top and bottom sides - only); vsides (right and left sides only); lhs (left - hand side only); rhs (right hand side only); box + <description>Code specifying which sides of the frame surrounding + this table will be visible. Valid values are: + none (no sides, default value); above (top side only); + below (bottom side only); hsides (top and bottom sides + only); vsides (right and left sides only); lhs (left + hand side only); rhs (right hand side only); box (all four sides); and border (all four sides).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4441,7 +4441,7 @@ </attribute-type> <attribute type="frame"/> <attribute-type name="headerClass" required="false"> - <description>Space-separated list of CSS style class(es) that will be + <description>Space-separated list of CSS style class(es) that will be applied to any header generated for this table.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4449,7 +4449,7 @@ </attribute-type> <attribute type="headerClass"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4457,7 +4457,7 @@ </attribute-type> <attribute type="lang"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4465,7 +4465,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4473,7 +4473,7 @@ </attribute-type> <attribute type="ondblclick"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4481,7 +4481,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4489,7 +4489,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4497,7 +4497,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4505,7 +4505,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4513,7 +4513,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4521,7 +4521,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4529,7 +4529,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4537,14 +4537,14 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="rowClasses" required="false"> - <description>Comma-delimited list of CSS style classes that will be applied - to the rows of this table. A space separated list of classes - may also be specified for any individual row. Thes styles are - applied, in turn, to each row in the table. For example, if - the list has two elements, the first style class in the list - is applied to the first row, the second to the second row, the - first to the third row, the second to the fourth row, etc. In - other words, we keep iterating through the list until we reach + <description>Comma-delimited list of CSS style classes that will be applied + to the rows of this table. A space separated list of classes + may also be specified for any individual row. Thes styles are + applied, in turn, to each row in the table. For example, if + the list has two elements, the first style class in the list + is applied to the first row, the second to the second row, the + first to the third row, the second to the fourth row, etc. In + other words, we keep iterating through the list until we reach the end, and then we start at the beginning again.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4552,10 +4552,10 @@ </attribute-type> <attribute type="rowClasses"/> <attribute-type name="rules" required="false"> - <description>Code specifying which rules will appear between cells - within this table. Valid values are: none (no rules, - default value); groups (between row groups); rows - (between rows only); cols (between columns only); and + <description>Code specifying which rules will appear between cells + within this table. Valid values are: none (no rules, + default value); groups (between row groups); rows + (between rows only); cols (between columns only); and all (between all rows and columns).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4577,8 +4577,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4586,8 +4586,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="summary" required="false"> - <description>Summary of this table's purpose and structure, for - user agents rendering to non-visual media such as + <description>Summary of this table's purpose and structure, for + user agents rendering to non-visual media such as speech and Braille.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4595,7 +4595,7 @@ </attribute-type> <attribute type="summary"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4620,27 +4620,27 @@ </element-type> <element-type body-content="allowed" content="mixed" end-tag="required" name="panelGroup" start-tag="required"> - <description>Intended for use in situations when only one - UIComponent child can be nested, such as in the case of facets. - If the "style" or "styleClass" attributes are present, and the "layout" - attribute is present with a value of "block", render a "div" element, - outputting the value of the "style" attribute as the value of the - "style" attribute and the value of the "styleClass" attribute as the - value of the "class" attribute. Otherwise, if the "layout" attribute - is not present, or the "layout" attribute contains a value other than - "block", render a "span" element, outputting the value of the - "style" attribute as the value of the "style" attribute, and the value - of the "styleClass" attribute as the value of the "class" + <description>Intended for use in situations when only one + UIComponent child can be nested, such as in the case of facets. + If the "style" or "styleClass" attributes are present, and the "layout" + attribute is present with a value of "block", render a "div" element, + outputting the value of the "style" attribute as the value of the + "style" attribute and the value of the "styleClass" attribute as the + value of the "class" attribute. Otherwise, if the "layout" attribute + is not present, or the "layout" attribute contains a value other than + "block", render a "span" element, outputting the value of the + "style" attribute as the value of the "style" attribute, and the value + of the "styleClass" attribute as the value of the "class" attribute.</description> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4652,9 +4652,9 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="layout" required="false"> - <description>The type of layout markup to use when rendering this group. - If the value is "block" the renderer must produce an HTML - "div" element. Otherwise HTML "span" element must + <description>The type of layout markup to use when rendering this group. + If the value is "block" the renderer must produce an HTML + "div" element. Otherwise HTML "span" element must be produced.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4673,8 +4673,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" property on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4692,33 +4692,33 @@ </element-type> <element-type body-content="refused" content="mixed" end-tag="required" name="selectBooleanCheckbox" start-tag="required"> - <description>&lt;p&gt;Renders an HTML "input" element of type "checkbox".&lt;/p&gt; - - &lt;p&gt;Decode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;Obtain the &lt;code&gt;Map&lt;/code&gt; from the "requestParameterMap" - property of the &lt;code&gt;ExternalContext&lt;/code&gt;. If there is no - entry in the &lt;code&gt;Map&lt;/code&gt; for the "clientId" of this - component, pass "false" to the &lt;code&gt;setSubmittedValue()&lt;/code&gt; - method of the component, which must be an instance of - &lt;code&gt;EditableValueHolder&lt;/code&gt;. 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 - &lt;code&gt;setSubmittedValue()&lt;/code&gt; method of the component.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt; - 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 + <description>&lt;p&gt;Renders an HTML "input" element of type "checkbox".&lt;/p&gt; + + &lt;p&gt;Decode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;Obtain the &lt;code&gt;Map&lt;/code&gt; from the "requestParameterMap" + property of the &lt;code&gt;ExternalContext&lt;/code&gt;. If there is no + entry in the &lt;code&gt;Map&lt;/code&gt; for the "clientId" of this + component, pass "false" to the &lt;code&gt;setSubmittedValue()&lt;/code&gt; + method of the component, which must be an instance of + &lt;code&gt;EditableValueHolder&lt;/code&gt;. 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 + &lt;code&gt;setSubmittedValue()&lt;/code&gt; method of the component.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt; + 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.&lt;/p&gt; &lt;/ul&gt;</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -4728,8 +4728,8 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="converterMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the converter message, replacing any message + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the converter message, replacing any message that comes from the converter.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4737,15 +4737,15 @@ </attribute-type> <attribute type="converterMessage"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="immediate" required="false"> - <description>Flag indicating that this component's value must be - converted and validated immediately (that is, during - Apply Request Values phase), rather than waiting + <description>Flag indicating that this component's value must be + converted and validated immediately (that is, during + Apply Request Values phase), rather than waiting until Process Validations phase.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4757,8 +4757,8 @@ </attribute-type> <attribute type="immediate"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4770,7 +4770,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="required" required="false"> - <description>Flag indicating that the user is required to provide a submitted + <description>Flag indicating that the user is required to provide a submitted value for this input component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4782,8 +4782,8 @@ </attribute-type> <attribute type="required"/> <attribute-type name="requiredMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validation message for the "required" + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validation message for the "required" facility, if the "required" facility is used.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4791,10 +4791,10 @@ </attribute-type> <attribute type="requiredMessage"/> <attribute-type name="validator" required="false"> - <description>MethodExpression representing a validator method that will be called - during Process Validations to perform correctness checks on the - value of this component. The expression must evaluate to a public - method that takes FacesContext, UIComponent, and Object parameters, + <description>MethodExpression representing a validator method that will be called + during Process Validations to perform correctness checks on the + value of this component. The expression must evaluate to a public + method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.</description> <proposal type="jsfVariables"/> <proposal type="beanProperty"/> @@ -4807,15 +4807,15 @@ </attribute-type> <attribute type="validator"/> <attribute-type name="validatorMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validator message, replacing any + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validator message, replacing any message that comes from the validator.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="validatorMessage"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4823,9 +4823,9 @@ </attribute-type> <attribute type="value"/> <attribute-type name="valueChangeListener" required="false"> - <description>MethodExpression representing a value change listener method that will be - notified when a new value has been set for this input component. The - expression must evaluate to a public method that takes a + <description>MethodExpression representing a value change listener method that will be + notified when a new value has been set for this input component. The + expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4837,7 +4837,7 @@ </attribute-type> <attribute type="valueChangeListener"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4845,7 +4845,7 @@ </attribute-type> <attribute type="accesskey"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4857,9 +4857,9 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="disabled" required="false"> - <description>Flag indicating that this element must never receive focus or - be included in a subsequent submit. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this element must never receive focus or + be included in a subsequent submit. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as disabled="disabled".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4878,7 +4878,7 @@ </attribute-type> <attribute type="label"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4893,7 +4893,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onchange" required="false"> - <description>Javascript code executed when this element loses focus + <description>Javascript code executed when this element loses focus and its value has been modified since gaining focus.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4901,7 +4901,7 @@ </attribute-type> <attribute type="onchange"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4909,7 +4909,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4924,7 +4924,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4932,7 +4932,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4940,7 +4940,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4948,7 +4948,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4956,7 +4956,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4964,7 +4964,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4972,7 +4972,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4980,7 +4980,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4988,7 +4988,7 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="onselect" required="false"> - <description>Javascript code executed when text within this + <description>Javascript code executed when text within this element is selected by the user.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -4996,10 +4996,10 @@ </attribute-type> <attribute type="onselect"/> <attribute-type name="readonly" required="false"> - <description>Flag indicating that this component will prohibit changes by - the user. The element may receive focus unless it has also - been disabled. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this component will prohibit changes by + the user. The element may receive focus unless it has also + been disabled. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as readonly="readonly".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5018,8 +5018,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5027,8 +5027,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5036,7 +5036,7 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5054,54 +5054,54 @@ </element-type> <element-type body-content="allowed" content="mixed" end-tag="required" name="selectManyCheckbox" start-tag="required"> - <description>&lt;p&gt;Render an HTML checkbox list.&lt;/p&gt; - - &lt;p&gt;&lt;a name="decode"&gt;Decode Behavior&lt;/a&gt;&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;See the &lt;a - href="javax.faces.SelectManyjavax.faces.Listbox.html#decodeMany"&gt;"Decode - Behavior for UISelectMany Components"&lt;/a&gt; section.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - &lt;p&gt;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. 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 &lt;code&gt;clientId&lt;/code&gt; 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 &lt;code&gt;clientId&lt;/code&gt; 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 - &lt;a href="javax.faces.SelectManyjavax.faces.Listbox.html#options"&gt;"Rendering - the option elements" &lt;/a&gt; specification for - &lt;code&gt;ListboxRenderer&lt;/code&gt; for more detail on how to render the - "option" elements in this renderer.&lt;/p&gt; - + <description>&lt;p&gt;Render an HTML checkbox list.&lt;/p&gt; + + &lt;p&gt;&lt;a name="decode"&gt;Decode Behavior&lt;/a&gt;&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;See the &lt;a + href="javax.faces.SelectManyjavax.faces.Listbox.html#decodeMany"&gt;"Decode + Behavior for UISelectMany Components"&lt;/a&gt; section.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + &lt;p&gt;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. 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 &lt;code&gt;clientId&lt;/code&gt; 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 &lt;code&gt;clientId&lt;/code&gt; 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 + &lt;a href="javax.faces.SelectManyjavax.faces.Listbox.html#options"&gt;"Rendering + the option elements" &lt;/a&gt; specification for + &lt;code&gt;ListboxRenderer&lt;/code&gt; for more detail on how to render the + "option" elements in this renderer.&lt;/p&gt; + &lt;/ul&gt;</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -5111,8 +5111,8 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="converterMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the converter message, replacing any message + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the converter message, replacing any message that comes from the converter.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5120,15 +5120,15 @@ </attribute-type> <attribute type="converterMessage"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="immediate" required="false"> - <description>Flag indicating that this component's value must be - converted and validated immediately (that is, during - Apply Request Values phase), rather than waiting + <description>Flag indicating that this component's value must be + converted and validated immediately (that is, during + Apply Request Values phase), rather than waiting until Process Validations phase.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5140,8 +5140,8 @@ </attribute-type> <attribute type="immediate"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5153,7 +5153,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="required" required="false"> - <description>Flag indicating that the user is required to provide a submitted + <description>Flag indicating that the user is required to provide a submitted value for this input component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5165,8 +5165,8 @@ </attribute-type> <attribute type="required"/> <attribute-type name="requiredMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validation message for the "required" + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validation message for the "required" facility, if the "required" facility is used.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5174,10 +5174,10 @@ </attribute-type> <attribute type="requiredMessage"/> <attribute-type name="validator" required="false"> - <description>MethodExpression representing a validator method that will be called - during Process Validations to perform correctness checks on the - value of this component. The expression must evaluate to a public - method that takes FacesContext, UIComponent, and Object parameters, + <description>MethodExpression representing a validator method that will be called + during Process Validations to perform correctness checks on the + value of this component. The expression must evaluate to a public + method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.</description> <proposal type="jsfVariables"/> <proposal type="beanProperty"/> @@ -5190,15 +5190,15 @@ </attribute-type> <attribute type="validator"/> <attribute-type name="validatorMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validator message, replacing any + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validator message, replacing any message that comes from the validator.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="validatorMessage"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5206,9 +5206,9 @@ </attribute-type> <attribute type="value"/> <attribute-type name="valueChangeListener" required="false"> - <description>MethodExpression representing a value change listener method that will be - notified when a new value has been set for this input component. The - expression must evaluate to a public method that takes a + <description>MethodExpression representing a value change listener method that will be + notified when a new value has been set for this input component. The + expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5220,7 +5220,7 @@ </attribute-type> <attribute type="valueChangeListener"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5228,7 +5228,7 @@ </attribute-type> <attribute type="accesskey"/> <attribute-type name="border" required="false"> - <description>Width (in pixels) of the border to be drawn + <description>Width (in pixels) of the border to be drawn around the table containing the options list.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5236,7 +5236,7 @@ </attribute-type> <attribute type="border"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5248,9 +5248,9 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="disabled" required="false"> - <description>Flag indicating that this element must never receive focus or - be included in a subsequent submit. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this element must never receive focus or + be included in a subsequent submit. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as disabled="disabled".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5262,7 +5262,7 @@ </attribute-type> <attribute type="disabled"/> <attribute-type name="disabledClass" required="false"> - <description>CSS style class to apply to the rendered label + <description>CSS style class to apply to the rendered label on disabled options.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5270,7 +5270,7 @@ </attribute-type> <attribute type="disabledClass"/> <attribute-type name="enabledClass" required="false"> - <description>CSS style class to apply to the rendered label + <description>CSS style class to apply to the rendered label on enabled options.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5285,7 +5285,7 @@ </attribute-type> <attribute type="label"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5293,10 +5293,10 @@ </attribute-type> <attribute type="lang"/> <attribute-type name="layout" required="false"> - <description>Orientation of the options list to be created. - Valid values are "pageDirection" (list is laid - out vertically), or "lineDirection" (list is - laid out horizontally). If not specified, the + <description>Orientation of the options list to be created. + Valid values are "pageDirection" (list is laid + out vertically), or "lineDirection" (list is + laid out horizontally). If not specified, the default value is "lineDirection".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5315,7 +5315,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onchange" required="false"> - <description>Javascript code executed when this element loses focus + <description>Javascript code executed when this element loses focus and its value has been modified since gaining focus.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5323,7 +5323,7 @@ </attribute-type> <attribute type="onchange"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5331,7 +5331,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5346,7 +5346,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5354,7 +5354,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5362,7 +5362,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5370,7 +5370,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5378,7 +5378,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5386,7 +5386,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5394,7 +5394,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5402,7 +5402,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5410,7 +5410,7 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="onselect" required="false"> - <description>Javascript code executed when text within this + <description>Javascript code executed when text within this element is selected by the user.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5418,10 +5418,10 @@ </attribute-type> <attribute type="onselect"/> <attribute-type name="readonly" required="false"> - <description>Flag indicating that this component will prohibit changes by - the user. The element may receive focus unless it has also - been disabled. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this component will prohibit changes by + the user. The element may receive focus unless it has also + been disabled. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as readonly="readonly".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5440,8 +5440,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5449,8 +5449,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5458,7 +5458,7 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5476,123 +5476,123 @@ </element-type> <element-type body-content="allowed" content="mixed" end-tag="required" name="selectManyListbox" start-tag="required"> - <description>&lt;p&gt;Render an HTML option list.&lt;/p&gt; - - &lt;p&gt;Decode Behavior&lt;/p&gt; - - &lt;p&gt;This section documents the decode behavior for all renderers - that handle &lt;code&gt;UISelectMany&lt;/code&gt; or &lt;code&gt;UISelectOne&lt;/code&gt; - components.&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;&lt;a name="decodeMany"&gt;Decode Behavior for - &lt;code&gt;UISelectMany&lt;/code&gt; components&lt;/a&gt;&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;Obtain the &lt;code&gt;Map&lt;/code&gt; from the - "requestParameterValuesMap" property of the - &lt;code&gt;ExternalContext&lt;/code&gt;. If the &lt;code&gt;Map&lt;/code&gt; contains - an entry for the "clientId" of the component, pass the value of - the entry, cast to a &lt;code&gt;String []&lt;/code&gt;, to the - &lt;code&gt;setSubmittedValue()&lt;/code&gt; method of the component, which - must be an &lt;code&gt;EditableValueHolder&lt;/code&gt;. If the - &lt;code&gt;Map&lt;/code&gt; does not contain an entry, create an empty - &lt;code&gt;String&lt;/code&gt; array and call - &lt;code&gt;setSubmittedValue()&lt;/code&gt; with it.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;&lt;a name="decodeOne"&gt;Decode Behavior for - &lt;code&gt;UISelectOne&lt;/code&gt; components&lt;/a&gt;&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;Obtain the &lt;code&gt;Map&lt;/code&gt; from the "requestParameterMap" - property of the &lt;code&gt;ExternalContext&lt;/code&gt;. If there is a - &lt;code&gt;Map&lt;/code&gt; entry for the "clientId" property of the - component, pass it to the &lt;code&gt;setSubmittedValue()&lt;/code&gt; method - of the component.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;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 - &lt;code&gt;UISelectMany&lt;/code&gt; 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.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;&lt;a name="option"&gt;Rendering the "option" elements&lt;/a&gt;&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;The only valid children of this component are - &lt;code&gt;UISelectItem&lt;/code&gt; or &lt;code&gt;UISelectItems&lt;/code&gt; instances. - Iterate over the children of this component, and accrue a list of - &lt;code&gt;javax.faces.model.SelectItem&lt;/code&gt; instances. If the - current child is a &lt;code&gt;UISelectItem&lt;/code&gt; create a - &lt;code&gt;SelectItem&lt;/code&gt;instance from its &lt;code&gt;itemValue, - itemLabel&lt;/code&gt; and &lt;code&gt;itemDescription&lt;/code&gt; properties, add - it to the list. If the current child is a - &lt;code&gt;UISelectItems&lt;/code&gt; instance, call its - &lt;code&gt;getValue()&lt;/code&gt; method. If the result is a - &lt;code&gt;SelectItem&lt;/code&gt; bean, add it to the list. If the result - is an array of &lt;code&gt;SelectItem&lt;/code&gt; beans, add each one t othe - list. If the result is a &lt;code&gt;Collection&lt;/code&gt; of - &lt;code&gt;SelectItem&lt;/code&gt; beans, add each one to the list. If the - result isa &lt;code&gt;Map&lt;/code&gt;, create a &lt;code&gt;SelectItem&lt;/code&gt; bean - for each entry in the &lt;code&gt;Map&lt;/code&gt; using the key as the label, - the value as the value, and &lt;code&gt;null&lt;/code&gt; as the description. - Iterate over the list of &lt;code&gt;SelectItem&lt;/code&gt; beans. If the - current element is a &lt;code&gt;SelectItemGroup&lt;/code&gt;, render an - "optgroup" element with a "label" attribute, the value of which is - the "label" property from the current element, then call - &lt;code&gt;getSelectItems()&lt;/code&gt; and render each element as below. - If the current element is not a &lt;code&gt;SelectItemGroup&lt;/code&gt;, - render an "option" element. Follow the conversion rules in the - spec to obtain a renderable &lt;code&gt;String&lt;/code&gt; 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 - &lt;code&gt;getSubmittedValue()&lt;/code&gt; method, casting the result to an - &lt;code&gt;Object []&lt;/code&gt;, otherwise the component must be a - &lt;code&gt;UISelectOne&lt;/code&gt; instance, call its - &lt;code&gt;getSubmittedValue()&lt;/code&gt; method and create an &lt;code&gt;Object - []&lt;/code&gt; around the result. Determine the type of the resultant array - if the resultant array is non-null, otherwise the type is &lt;code&gt;String&lt;/code&gt;. - 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 &lt;code&gt;equals()&lt;/code&gt; method, it returns - &lt;code&gt;true&lt;/code&gt;, meaning the current element is selected. If - the resultant array is &lt;code&gt;null&lt;/code&gt;, if the component is a - &lt;code&gt;UISelectMany&lt;/code&gt;, call its &lt;code&gt;getValue()&lt;/code&gt; - method. If the result is a &lt;code&gt;List&lt;/code&gt; obtain the values in - the list as an array. Otherwise, the component must be a - &lt;code&gt;UISelectOne&lt;/code&gt; instance. Call its - &lt;code&gt;getValue()&lt;/code&gt; 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 &lt;code&gt;equals()&lt;/code&gt; method, it - returns &lt;code&gt;true&lt;/code&gt; , 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.&lt;/p&gt; - - &lt;/ul&gt; - + <description>&lt;p&gt;Render an HTML option list.&lt;/p&gt; + + &lt;p&gt;Decode Behavior&lt;/p&gt; + + &lt;p&gt;This section documents the decode behavior for all renderers + that handle &lt;code&gt;UISelectMany&lt;/code&gt; or &lt;code&gt;UISelectOne&lt;/code&gt; + components.&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;&lt;a name="decodeMany"&gt;Decode Behavior for + &lt;code&gt;UISelectMany&lt;/code&gt; components&lt;/a&gt;&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;Obtain the &lt;code&gt;Map&lt;/code&gt; from the + "requestParameterValuesMap" property of the + &lt;code&gt;ExternalContext&lt;/code&gt;. If the &lt;code&gt;Map&lt;/code&gt; contains + an entry for the "clientId" of the component, pass the value of + the entry, cast to a &lt;code&gt;String []&lt;/code&gt;, to the + &lt;code&gt;setSubmittedValue()&lt;/code&gt; method of the component, which + must be an &lt;code&gt;EditableValueHolder&lt;/code&gt;. If the + &lt;code&gt;Map&lt;/code&gt; does not contain an entry, create an empty + &lt;code&gt;String&lt;/code&gt; array and call + &lt;code&gt;setSubmittedValue()&lt;/code&gt; with it.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;&lt;a name="decodeOne"&gt;Decode Behavior for + &lt;code&gt;UISelectOne&lt;/code&gt; components&lt;/a&gt;&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;Obtain the &lt;code&gt;Map&lt;/code&gt; from the "requestParameterMap" + property of the &lt;code&gt;ExternalContext&lt;/code&gt;. If there is a + &lt;code&gt;Map&lt;/code&gt; entry for the "clientId" property of the + component, pass it to the &lt;code&gt;setSubmittedValue()&lt;/code&gt; method + of the component.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;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 + &lt;code&gt;UISelectMany&lt;/code&gt; 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.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;&lt;a name="option"&gt;Rendering the "option" elements&lt;/a&gt;&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;The only valid children of this component are + &lt;code&gt;UISelectItem&lt;/code&gt; or &lt;code&gt;UISelectItems&lt;/code&gt; instances. + Iterate over the children of this component, and accrue a list of + &lt;code&gt;javax.faces.model.SelectItem&lt;/code&gt; instances. If the + current child is a &lt;code&gt;UISelectItem&lt;/code&gt; create a + &lt;code&gt;SelectItem&lt;/code&gt;instance from its &lt;code&gt;itemValue, + itemLabel&lt;/code&gt; and &lt;code&gt;itemDescription&lt;/code&gt; properties, add + it to the list. If the current child is a + &lt;code&gt;UISelectItems&lt;/code&gt; instance, call its + &lt;code&gt;getValue()&lt;/code&gt; method. If the result is a + &lt;code&gt;SelectItem&lt;/code&gt; bean, add it to the list. If the result + is an array of &lt;code&gt;SelectItem&lt;/code&gt; beans, add each one t othe + list. If the result is a &lt;code&gt;Collection&lt;/code&gt; of + &lt;code&gt;SelectItem&lt;/code&gt; beans, add each one to the list. If the + result isa &lt;code&gt;Map&lt;/code&gt;, create a &lt;code&gt;SelectItem&lt;/code&gt; bean + for each entry in the &lt;code&gt;Map&lt;/code&gt; using the key as the label, + the value as the value, and &lt;code&gt;null&lt;/code&gt; as the description. + Iterate over the list of &lt;code&gt;SelectItem&lt;/code&gt; beans. If the + current element is a &lt;code&gt;SelectItemGroup&lt;/code&gt;, render an + "optgroup" element with a "label" attribute, the value of which is + the "label" property from the current element, then call + &lt;code&gt;getSelectItems()&lt;/code&gt; and render each element as below. + If the current element is not a &lt;code&gt;SelectItemGroup&lt;/code&gt;, + render an "option" element. Follow the conversion rules in the + spec to obtain a renderable &lt;code&gt;String&lt;/code&gt; 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 + &lt;code&gt;getSubmittedValue()&lt;/code&gt; method, casting the result to an + &lt;code&gt;Object []&lt;/code&gt;, otherwise the component must be a + &lt;code&gt;UISelectOne&lt;/code&gt; instance, call its + &lt;code&gt;getSubmittedValue()&lt;/code&gt; method and create an &lt;code&gt;Object + []&lt;/code&gt; around the result. Determine the type of the resultant array + if the resultant array is non-null, otherwise the type is &lt;code&gt;String&lt;/code&gt;. + 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 &lt;code&gt;equals()&lt;/code&gt; method, it returns + &lt;code&gt;true&lt;/code&gt;, meaning the current element is selected. If + the resultant array is &lt;code&gt;null&lt;/code&gt;, if the component is a + &lt;code&gt;UISelectMany&lt;/code&gt;, call its &lt;code&gt;getValue()&lt;/code&gt; + method. If the result is a &lt;code&gt;List&lt;/code&gt; obtain the values in + the list as an array. Otherwise, the component must be a + &lt;code&gt;UISelectOne&lt;/code&gt; instance. Call its + &lt;code&gt;getValue()&lt;/code&gt; 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 &lt;code&gt;equals()&lt;/code&gt; method, it + returns &lt;code&gt;true&lt;/code&gt; , 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.&lt;/p&gt; + + &lt;/ul&gt; + &lt;/ul&gt;</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -5602,8 +5602,8 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="converterMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the converter message, replacing any message + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the converter message, replacing any message that comes from the converter.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5611,15 +5611,15 @@ </attribute-type> <attribute type="converterMessage"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="immediate" required="false"> - <description>Flag indicating that this component's value must be - converted and validated immediately (that is, during - Apply Request Values phase), rather than waiting + <description>Flag indicating that this component's value must be + converted and validated immediately (that is, during + Apply Request Values phase), rather than waiting until Process Validations phase.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5631,8 +5631,8 @@ </attribute-type> <attribute type="immediate"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5644,7 +5644,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="required" required="false"> - <description>Flag indicating that the user is required to provide a submitted + <description>Flag indicating that the user is required to provide a submitted value for this input component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5656,8 +5656,8 @@ </attribute-type> <attribute type="required"/> <attribute-type name="requiredMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validation message for the "required" + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validation message for the "required" facility, if the "required" facility is used.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5665,10 +5665,10 @@ </attribute-type> <attribute type="requiredMessage"/> <attribute-type name="validator" required="false"> - <description>MethodExpression representing a validator method that will be called - during Process Validations to perform correctness checks on the - value of this component. The expression must evaluate to a public - method that takes FacesContext, UIComponent, and Object parameters, + <description>MethodExpression representing a validator method that will be called + during Process Validations to perform correctness checks on the + value of this component. The expression must evaluate to a public + method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.</description> <proposal type="jsfVariables"/> <proposal type="beanProperty"/> @@ -5681,15 +5681,15 @@ </attribute-type> <attribute type="validator"/> <attribute-type name="validatorMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validator message, replacing any + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validator message, replacing any message that comes from the validator.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="validatorMessage"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5697,9 +5697,9 @@ </attribute-type> <attribute type="value"/> <attribute-type name="valueChangeListener" required="false"> - <description>MethodExpression representing a value change listener method that will be - notified when a new value has been set for this input component. The - expression must evaluate to a public method that takes a + <description>MethodExpression representing a value change listener method that will be + notified when a new value has been set for this input component. The + expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5711,7 +5711,7 @@ </attribute-type> <attribute type="valueChangeListener"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5719,7 +5719,7 @@ </attribute-type> <attribute type="accesskey"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5731,9 +5731,9 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="disabled" required="false"> - <description>Flag indicating that this element must never receive focus or - be included in a subsequent submit. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this element must never receive focus or + be included in a subsequent submit. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as disabled="disabled".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5745,7 +5745,7 @@ </attribute-type> <attribute type="disabled"/> <attribute-type name="disabledClass" required="false"> - <description>CSS style class to apply to the rendered label + <description>CSS style class to apply to the rendered label on disabled options.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5753,7 +5753,7 @@ </attribute-type> <attribute type="disabledClass"/> <attribute-type name="enabledClass" required="false"> - <description>CSS style class to apply to the rendered label + <description>CSS style class to apply to the rendered label on enabled options.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5768,7 +5768,7 @@ </attribute-type> <attribute type="label"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5783,7 +5783,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onchange" required="false"> - <description>Javascript code executed when this element loses focus + <description>Javascript code executed when this element loses focus and its value has been modified since gaining focus.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5791,7 +5791,7 @@ </attribute-type> <attribute type="onchange"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5799,7 +5799,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5814,7 +5814,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5822,7 +5822,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5830,7 +5830,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5838,7 +5838,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5846,7 +5846,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5854,7 +5854,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5862,7 +5862,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5870,7 +5870,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5878,7 +5878,7 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="onselect" required="false"> - <description>Javascript code executed when text within this + <description>Javascript code executed when text within this element is selected by the user.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5886,10 +5886,10 @@ </attribute-type> <attribute type="onselect"/> <attribute-type name="readonly" required="false"> - <description>Flag indicating that this component will prohibit changes by - the user. The element may receive focus unless it has also - been disabled. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this component will prohibit changes by + the user. The element may receive focus unless it has also + been disabled. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as readonly="readonly".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5901,7 +5901,7 @@ </attribute-type> <attribute type="readonly"/> <attribute-type name="size" required="false"> - <description>Number of available options to be shown at all times. + <description>Number of available options to be shown at all times. If not specified, all available options are shown.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5916,8 +5916,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5925,8 +5925,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5934,7 +5934,7 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5952,34 +5952,34 @@ </element-type> <element-type body-content="allowed" content="mixed" end-tag="required" name="selectManyMenu" start-tag="required"> - <description>&lt;p&gt;Render an HTML option list.&lt;/p&gt; - - &lt;p&gt;&lt;a name="decode"&gt;Decode Behavior&lt;/a&gt;&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;See the &lt;a - href="javax.faces.SelectManyjavax.faces.Listbox.html#decodeMany"&gt;"Decode - Behavior for UISelectMany Components"&lt;/a&gt; section.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;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 &lt;a - href="javax.faces.SelectManyjavax.faces.Listbox.html#options"&gt;"Rendering the option - elements" &lt;/a&gt; specification for &lt;code&gt;ListboxRenderer&lt;/code&gt; for - more detail on how to render the "option" elements in this - renderer.&lt;/p&gt; - + <description>&lt;p&gt;Render an HTML option list.&lt;/p&gt; + + &lt;p&gt;&lt;a name="decode"&gt;Decode Behavior&lt;/a&gt;&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;See the &lt;a + href="javax.faces.SelectManyjavax.faces.Listbox.html#decodeMany"&gt;"Decode + Behavior for UISelectMany Components"&lt;/a&gt; section.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;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 &lt;a + href="javax.faces.SelectManyjavax.faces.Listbox.html#options"&gt;"Rendering the option + elements" &lt;/a&gt; specification for &lt;code&gt;ListboxRenderer&lt;/code&gt; for + more detail on how to render the "option" elements in this + renderer.&lt;/p&gt; + &lt;/ul&gt;</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -5989,8 +5989,8 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="converterMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the converter message, replacing any message + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the converter message, replacing any message that comes from the converter.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -5998,15 +5998,15 @@ </attribute-type> <attribute type="converterMessage"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="immediate" required="false"> - <description>Flag indicating that this component's value must be - converted and validated immediately (that is, during - Apply Request Values phase), rather than waiting + <description>Flag indicating that this component's value must be + converted and validated immediately (that is, during + Apply Request Values phase), rather than waiting until Process Validations phase.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6018,8 +6018,8 @@ </attribute-type> <attribute type="immediate"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6031,7 +6031,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="required" required="false"> - <description>Flag indicating that the user is required to provide a submitted + <description>Flag indicating that the user is required to provide a submitted value for this input component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6043,8 +6043,8 @@ </attribute-type> <attribute type="required"/> <attribute-type name="requiredMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validation message for the "required" + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validation message for the "required" facility, if the "required" facility is used.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6052,10 +6052,10 @@ </attribute-type> <attribute type="requiredMessage"/> <attribute-type name="validator" required="false"> - <description>MethodExpression representing a validator method that will be called - during Process Validations to perform correctness checks on the - value of this component. The expression must evaluate to a public - method that takes FacesContext, UIComponent, and Object parameters, + <description>MethodExpression representing a validator method that will be called + during Process Validations to perform correctness checks on the + value of this component. The expression must evaluate to a public + method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.</description> <proposal type="jsfVariables"/> <proposal type="beanProperty"/> @@ -6068,15 +6068,15 @@ </attribute-type> <attribute type="validator"/> <attribute-type name="validatorMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validator message, replacing any + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validator message, replacing any message that comes from the validator.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="validatorMessage"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6084,9 +6084,9 @@ </attribute-type> <attribute type="value"/> <attribute-type name="valueChangeListener" required="false"> - <description>MethodExpression representing a value change listener method that will be - notified when a new value has been set for this input component. The - expression must evaluate to a public method that takes a + <description>MethodExpression representing a value change listener method that will be + notified when a new value has been set for this input component. The + expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6098,7 +6098,7 @@ </attribute-type> <attribute type="valueChangeListener"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6106,7 +6106,7 @@ </attribute-type> <attribute type="accesskey"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6118,9 +6118,9 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="disabled" required="false"> - <description>Flag indicating that this element must never receive focus or - be included in a subsequent submit. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this element must never receive focus or + be included in a subsequent submit. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as disabled="disabled".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6132,7 +6132,7 @@ </attribute-type> <attribute type="disabled"/> <attribute-type name="disabledClass" required="false"> - <description>CSS style class to apply to the rendered label + <description>CSS style class to apply to the rendered label on disabled options.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6140,7 +6140,7 @@ </attribute-type> <attribute type="disabledClass"/> <attribute-type name="enabledClass" required="false"> - <description>CSS style class to apply to the rendered label + <description>CSS style class to apply to the rendered label on enabled options.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6155,7 +6155,7 @@ </attribute-type> <attribute type="label"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6170,7 +6170,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onchange" required="false"> - <description>Javascript code executed when this element loses focus + <description>Javascript code executed when this element loses focus and its value has been modified since gaining focus.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6178,7 +6178,7 @@ </attribute-type> <attribute type="onchange"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6186,7 +6186,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6201,7 +6201,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6209,7 +6209,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6217,7 +6217,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6225,7 +6225,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6233,7 +6233,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6241,7 +6241,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6249,7 +6249,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6257,7 +6257,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6265,7 +6265,7 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="onselect" required="false"> - <description>Javascript code executed when text within this + <description>Javascript code executed when text within this element is selected by the user.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6273,10 +6273,10 @@ </attribute-type> <attribute type="onselect"/> <attribute-type name="readonly" required="false"> - <description>Flag indicating that this component will prohibit changes by - the user. The element may receive focus unless it has also - been disabled. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this component will prohibit changes by + the user. The element may receive focus unless it has also + been disabled. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as readonly="readonly".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6295,8 +6295,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6304,8 +6304,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6313,7 +6313,7 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6331,34 +6331,34 @@ </element-type> <element-type body-content="allowed" content="mixed" end-tag="required" name="selectOneListbox" start-tag="required"> - <description>&lt;p&gt;Render an HTML option list.&lt;/p&gt; - - &lt;p&gt;&lt;a name="decode"&gt;Decode Behavior&lt;/a&gt;&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;See the &lt;a - href="javax.faces.SelectManyjavax.faces.Listbox.html#decodeOne"&gt;"Decode - Behavior for UISelectOne Components"&lt;/a&gt; section.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - &lt;p&gt;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 &lt;a href="javax.faces.SelectManyjavax.faces.Listbox.html#options"&gt;"Rendering the option - elements" &lt;/a&gt; specification for &lt;code&gt;ListboxRenderer&lt;/code&gt; for - more detail on how to render the "option" elements in this - renderer.&lt;/p&gt; - + <description>&lt;p&gt;Render an HTML option list.&lt;/p&gt; + + &lt;p&gt;&lt;a name="decode"&gt;Decode Behavior&lt;/a&gt;&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;See the &lt;a + href="javax.faces.SelectManyjavax.faces.Listbox.html#decodeOne"&gt;"Decode + Behavior for UISelectOne Components"&lt;/a&gt; section.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + &lt;p&gt;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 &lt;a href="javax.faces.SelectManyjavax.faces.Listbox.html#options"&gt;"Rendering the option + elements" &lt;/a&gt; specification for &lt;code&gt;ListboxRenderer&lt;/code&gt; for + more detail on how to render the "option" elements in this + renderer.&lt;/p&gt; + &lt;/ul&gt;</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -6368,8 +6368,8 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="converterMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the converter message, replacing any message + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the converter message, replacing any message that comes from the converter.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6377,15 +6377,15 @@ </attribute-type> <attribute type="converterMessage"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="immediate" required="false"> - <description>Flag indicating that this component's value must be - converted and validated immediately (that is, during - Apply Request Values phase), rather than waiting + <description>Flag indicating that this component's value must be + converted and validated immediately (that is, during + Apply Request Values phase), rather than waiting until Process Validations phase.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6397,8 +6397,8 @@ </attribute-type> <attribute type="immediate"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6410,7 +6410,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="required" required="false"> - <description>Flag indicating that the user is required to provide a submitted + <description>Flag indicating that the user is required to provide a submitted value for this input component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6422,8 +6422,8 @@ </attribute-type> <attribute type="required"/> <attribute-type name="requiredMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validation message for the "required" + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validation message for the "required" facility, if the "required" facility is used.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6431,10 +6431,10 @@ </attribute-type> <attribute type="requiredMessage"/> <attribute-type name="validator" required="false"> - <description>MethodExpression representing a validator method that will be called - during Process Validations to perform correctness checks on the - value of this component. The expression must evaluate to a public - method that takes FacesContext, UIComponent, and Object parameters, + <description>MethodExpression representing a validator method that will be called + during Process Validations to perform correctness checks on the + value of this component. The expression must evaluate to a public + method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.</description> <proposal type="jsfVariables"/> <proposal type="beanProperty"/> @@ -6447,15 +6447,15 @@ </attribute-type> <attribute type="validator"/> <attribute-type name="validatorMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validator message, replacing any + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validator message, replacing any message that comes from the validator.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="validatorMessage"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6463,9 +6463,9 @@ </attribute-type> <attribute type="value"/> <attribute-type name="valueChangeListener" required="false"> - <description>MethodExpression representing a value change listener method that will be - notified when a new value has been set for this input component. The - expression must evaluate to a public method that takes a + <description>MethodExpression representing a value change listener method that will be + notified when a new value has been set for this input component. The + expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6477,7 +6477,7 @@ </attribute-type> <attribute type="valueChangeListener"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6485,7 +6485,7 @@ </attribute-type> <attribute type="accesskey"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6497,9 +6497,9 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="disabled" required="false"> - <description>Flag indicating that this element must never receive focus or - be included in a subsequent submit. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this element must never receive focus or + be included in a subsequent submit. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as disabled="disabled".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6511,7 +6511,7 @@ </attribute-type> <attribute type="disabled"/> <attribute-type name="disabledClass" required="false"> - <description>CSS style class to apply to the rendered label + <description>CSS style class to apply to the rendered label on disabled options.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6519,7 +6519,7 @@ </attribute-type> <attribute type="disabledClass"/> <attribute-type name="enabledClass" required="false"> - <description>CSS style class to apply to the rendered label + <description>CSS style class to apply to the rendered label on enabled options.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6534,7 +6534,7 @@ </attribute-type> <attribute type="label"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6549,7 +6549,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onchange" required="false"> - <description>Javascript code executed when this element loses focus + <description>Javascript code executed when this element loses focus and its value has been modified since gaining focus.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6557,7 +6557,7 @@ </attribute-type> <attribute type="onchange"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6565,7 +6565,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6580,7 +6580,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6588,7 +6588,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6596,7 +6596,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6604,7 +6604,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6612,7 +6612,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6620,7 +6620,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6628,7 +6628,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6636,7 +6636,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6644,7 +6644,7 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="onselect" required="false"> - <description>Javascript code executed when text within this + <description>Javascript code executed when text within this element is selected by the user.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6652,10 +6652,10 @@ </attribute-type> <attribute type="onselect"/> <attribute-type name="readonly" required="false"> - <description>Flag indicating that this component will prohibit changes by - the user. The element may receive focus unless it has also - been disabled. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this component will prohibit changes by + the user. The element may receive focus unless it has also + been disabled. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as readonly="readonly".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6667,7 +6667,7 @@ </attribute-type> <attribute type="readonly"/> <attribute-type name="size" required="false"> - <description>Number of available options to be shown at all times. + <description>Number of available options to be shown at all times. If not specified, all available options are shown.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6682,8 +6682,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6691,8 +6691,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6700,7 +6700,7 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6718,34 +6718,34 @@ </element-type> <element-type body-content="allowed" content="mixed" end-tag="required" name="selectOneMenu" start-tag="required"> - <description>&lt;p&gt;Render an HTML option list.&lt;/p&gt; - - &lt;p&gt;&lt;a name="decode"&gt;Decode Behavior&lt;/a&gt;&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;See the &lt;a - href="javax.faces.SelectManyjavax.faces.Listbox.html#decodeOne"&gt;"Decode - Behavior for UISelectOne Components"&lt;/a&gt; section.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;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 &lt;a - href="javax.faces.SelectManyjavax.faces.Listbox.html#options"&gt;"Rendering - the option elements" &lt;/a&gt; specification for - &lt;code&gt;ListboxRenderer&lt;/code&gt; for more detail on how to render the - "option" elements in this renderer.&lt;/p&gt; - + <description>&lt;p&gt;Render an HTML option list.&lt;/p&gt; + + &lt;p&gt;&lt;a name="decode"&gt;Decode Behavior&lt;/a&gt;&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;See the &lt;a + href="javax.faces.SelectManyjavax.faces.Listbox.html#decodeOne"&gt;"Decode + Behavior for UISelectOne Components"&lt;/a&gt; section.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;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 &lt;a + href="javax.faces.SelectManyjavax.faces.Listbox.html#options"&gt;"Rendering + the option elements" &lt;/a&gt; specification for + &lt;code&gt;ListboxRenderer&lt;/code&gt; for more detail on how to render the + "option" elements in this renderer.&lt;/p&gt; + &lt;/ul&gt;</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -6755,8 +6755,8 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="converterMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the converter message, replacing any message + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the converter message, replacing any message that comes from the converter.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6764,15 +6764,15 @@ </attribute-type> <attribute type="converterMessage"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="immediate" required="false"> - <description>Flag indicating that this component's value must be - converted and validated immediately (that is, during - Apply Request Values phase), rather than waiting + <description>Flag indicating that this component's value must be + converted and validated immediately (that is, during + Apply Request Values phase), rather than waiting until Process Validations phase.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6784,8 +6784,8 @@ </attribute-type> <attribute type="immediate"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6797,7 +6797,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="required" required="false"> - <description>Flag indicating that the user is required to provide a submitted + <description>Flag indicating that the user is required to provide a submitted value for this input component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6809,8 +6809,8 @@ </attribute-type> <attribute type="required"/> <attribute-type name="requiredMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validation message for the "required" + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validation message for the "required" facility, if the "required" facility is used.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6818,10 +6818,10 @@ </attribute-type> <attribute type="requiredMessage"/> <attribute-type name="validator" required="false"> - <description>MethodExpression representing a validator method that will be called - during Process Validations to perform correctness checks on the - value of this component. The expression must evaluate to a public - method that takes FacesContext, UIComponent, and Object parameters, + <description>MethodExpression representing a validator method that will be called + during Process Validations to perform correctness checks on the + value of this component. The expression must evaluate to a public + method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.</description> <proposal type="jsfVariables"/> <proposal type="beanProperty"/> @@ -6834,15 +6834,15 @@ </attribute-type> <attribute type="validator"/> <attribute-type name="validatorMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validator message, replacing any + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validator message, replacing any message that comes from the validator.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="validatorMessage"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6850,9 +6850,9 @@ </attribute-type> <attribute type="value"/> <attribute-type name="valueChangeListener" required="false"> - <description>MethodExpression representing a value change listener method that will be - notified when a new value has been set for this input component. The - expression must evaluate to a public method that takes a + <description>MethodExpression representing a value change listener method that will be + notified when a new value has been set for this input component. The + expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6864,7 +6864,7 @@ </attribute-type> <attribute type="valueChangeListener"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6872,7 +6872,7 @@ </attribute-type> <attribute type="accesskey"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6884,9 +6884,9 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="disabled" required="false"> - <description>Flag indicating that this element must never receive focus or - be included in a subsequent submit. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this element must never receive focus or + be included in a subsequent submit. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as disabled="disabled".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6898,7 +6898,7 @@ </attribute-type> <attribute type="disabled"/> <attribute-type name="disabledClass" required="false"> - <description>CSS style class to apply to the rendered label + <description>CSS style class to apply to the rendered label on disabled options.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6906,7 +6906,7 @@ </attribute-type> <attribute type="disabledClass"/> <attribute-type name="enabledClass" required="false"> - <description>CSS style class to apply to the rendered label + <description>CSS style class to apply to the rendered label on enabled options.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6921,7 +6921,7 @@ </attribute-type> <attribute type="label"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6936,7 +6936,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onchange" required="false"> - <description>Javascript code executed when this element loses focus + <description>Javascript code executed when this element loses focus and its value has been modified since gaining focus.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6944,7 +6944,7 @@ </attribute-type> <attribute type="onchange"/> <attribute-type name="onclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6952,7 +6952,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6967,7 +6967,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6975,7 +6975,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6983,7 +6983,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6991,7 +6991,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -6999,7 +6999,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7007,7 +7007,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7015,7 +7015,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7023,7 +7023,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7031,7 +7031,7 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="onselect" required="false"> - <description>Javascript code executed when text within this + <description>Javascript code executed when text within this element is selected by the user.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7039,10 +7039,10 @@ </attribute-type> <attribute type="onselect"/> <attribute-type name="readonly" required="false"> - <description>Flag indicating that this component will prohibit changes by - the user. The element may receive focus unless it has also - been disabled. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this component will prohibit changes by + the user. The element may receive focus unless it has also + been disabled. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as readonly="readonly".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7061,8 +7061,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7070,8 +7070,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7079,7 +7079,7 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7097,57 +7097,57 @@ </element-type> <element-type body-content="allowed" content="mixed" end-tag="required" name="selectOneRadio" start-tag="required"> - <description>&lt;p&gt;Render a set of html "input" elements of type - "radio".&lt;/p&gt; - - &lt;p&gt;&lt;a name="decode"&gt;Decode Behavior&lt;/a&gt;&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;See the &lt;a - href="javax.faces.SelectManyjavax.faces.Listbox.html#decodeOne"&gt;"Decode - Behavior for UISelectOne Components"&lt;/a&gt; section.&lt;/p&gt; - - &lt;/ul&gt; - - &lt;p&gt;Encode Behavior&lt;/p&gt; - - &lt;ul&gt; - - &lt;p&gt;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. 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 &lt;code&gt;clientId&lt;/code&gt; 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 &lt;code&gt;clientId&lt;/code&gt; 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 - &lt;a href="javax.faces.SelectManyjavax.faces.Listbox.html#options"&gt;"Rendering the option - elements" &lt;/a&gt; specification for &lt;code&gt;ListboxRenderer&lt;/code&gt; for - more detail on how to render the "option" elements in this - renderer.&lt;/p&gt; - + <description>&lt;p&gt;Render a set of html "input" elements of type + "radio".&lt;/p&gt; + + &lt;p&gt;&lt;a name="decode"&gt;Decode Behavior&lt;/a&gt;&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;See the &lt;a + href="javax.faces.SelectManyjavax.faces.Listbox.html#decodeOne"&gt;"Decode + Behavior for UISelectOne Components"&lt;/a&gt; section.&lt;/p&gt; + + &lt;/ul&gt; + + &lt;p&gt;Encode Behavior&lt;/p&gt; + + &lt;ul&gt; + + &lt;p&gt;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. 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 &lt;code&gt;clientId&lt;/code&gt; 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 &lt;code&gt;clientId&lt;/code&gt; 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 + &lt;a href="javax.faces.SelectManyjavax.faces.Listbox.html#options"&gt;"Rendering the option + elements" &lt;/a&gt; specification for &lt;code&gt;ListboxRenderer&lt;/code&gt; for + more detail on how to render the "option" elements in this + renderer.&lt;/p&gt; + &lt;/ul&gt;</description> <attribute-type name="converter" required="false"> <description>Converter instance registered with this component.</description> @@ -7157,8 +7157,8 @@ </attribute-type> <attribute type="converter"/> <attribute-type name="converterMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the converter message, replacing any message + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the converter message, replacing any message that comes from the converter.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7166,15 +7166,15 @@ </attribute-type> <attribute type="converterMessage"/> <attribute-type name="id" required="false"> - <description>The component identifier for this component. This value must be - unique within the closest parent component that is a naming + <description>The component identifier for this component. This value must be + unique within the closest parent component that is a naming container.</description> </attribute-type> <attribute type="id"/> <attribute-type name="immediate" required="false"> - <description>Flag indicating that this component's value must be - converted and validated immediately (that is, during - Apply Request Values phase), rather than waiting + <description>Flag indicating that this component's value must be + converted and validated immediately (that is, during + Apply Request Values phase), rather than waiting until Process Validations phase.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7186,8 +7186,8 @@ </attribute-type> <attribute type="immediate"/> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit. The default value for this property is true.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7199,7 +7199,7 @@ </attribute-type> <attribute type="rendered"/> <attribute-type name="required" required="false"> - <description>Flag indicating that the user is required to provide a submitted + <description>Flag indicating that the user is required to provide a submitted value for this input component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7211,8 +7211,8 @@ </attribute-type> <attribute type="required"/> <attribute-type name="requiredMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validation message for the "required" + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validation message for the "required" facility, if the "required" facility is used.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7220,10 +7220,10 @@ </attribute-type> <attribute type="requiredMessage"/> <attribute-type name="validator" required="false"> - <description>MethodExpression representing a validator method that will be called - during Process Validations to perform correctness checks on the - value of this component. The expression must evaluate to a public - method that takes FacesContext, UIComponent, and Object parameters, + <description>MethodExpression representing a validator method that will be called + during Process Validations to perform correctness checks on the + value of this component. The expression must evaluate to a public + method that takes FacesContext, UIComponent, and Object parameters, with a return type of void.</description> <proposal type="jsfVariables"/> <proposal type="beanProperty"/> @@ -7236,15 +7236,15 @@ </attribute-type> <attribute type="validator"/> <attribute-type name="validatorMessage" required="false"> - <description>A ValueExpression enabled attribute that, if present, will be - used as the text of the validator message, replacing any + <description>A ValueExpression enabled attribute that, if present, will be + used as the text of the validator message, replacing any message that comes from the validator.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> <proposal type="jsfVariables"/> </attribute-type> <attribute type="validatorMessage"/> - <attribute-type name="value" required="false"> + <attribute-type name="value" required="true"> <description>The current value of this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7252,9 +7252,9 @@ </attribute-type> <attribute type="value"/> <attribute-type name="valueChangeListener" required="false"> - <description>MethodExpression representing a value change listener method that will be - notified when a new value has been set for this input component. The - expression must evaluate to a public method that takes a + <description>MethodExpression representing a value change listener method that will be + notified when a new value has been set for this input component. The + expression must evaluate to a public method that takes a ValueChangeEvent parameter, with a return type of void.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7266,7 +7266,7 @@ </attribute-type> <attribute type="valueChangeListener"/> <attribute-type name="accesskey" required="false"> - <description>Access key that, when pressed, transfers focus + <description>Access key that, when pressed, transfers focus to this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7274,7 +7274,7 @@ </attribute-type> <attribute type="accesskey"/> <attribute-type name="border" required="false"> - <description>Width (in pixels) of the border to be drawn + <description>Width (in pixels) of the border to be drawn around the table containing the options list.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7282,7 +7282,7 @@ </attribute-type> <attribute type="border"/> <attribute-type name="dir" required="false"> - <description>Direction indication for text that does not inherit directionality. + <description>Direction indication for text that does not inherit directionality. Valid values are "LTR" (left-to-right) and "RTL" (right-to-left).</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7294,9 +7294,9 @@ </attribute-type> <attribute type="dir"/> <attribute-type name="disabled" required="false"> - <description>Flag indicating that this element must never receive focus or - be included in a subsequent submit. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this element must never receive focus or + be included in a subsequent submit. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as disabled="disabled".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7308,7 +7308,7 @@ </attribute-type> <attribute type="disabled"/> <attribute-type name="disabledClass" required="false"> - <description>CSS style class to apply to the rendered label + <description>CSS style class to apply to the rendered label on disabled options.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7316,7 +7316,7 @@ </attribute-type> <attribute type="disabledClass"/> <attribute-type name="enabledClass" required="false"> - <description>CSS style class to apply to the rendered label + <description>CSS style class to apply to the rendered label on enabled options.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7331,7 +7331,7 @@ </attribute-type> <attribute type="label"/> <attribute-type name="lang" required="false"> - <description>Code describing the language used in the generated markup + <description>Code describing the language used in the generated markup for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7339,10 +7339,10 @@ </attribute-type> <attribute type="lang"/> <attribute-type name="layout" required="false"> - <description>Orientation of the options list to be created. - Valid values are "pageDirection" (list is laid - out vertically), or "lineDirection" (list is - laid out horizontally). If not specified, the + <description>Orientation of the options list to be created. + Valid values are "pageDirection" (list is laid + out vertically), or "lineDirection" (list is + laid out horizontally). If not specified, the default value is "lineDirection".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7361,7 +7361,7 @@ </attribute-type> <attribute type="onblur"/> <attribute-type name="onchange" required="false"> - <description>Javascript code executed when this element loses focus + <description>Javascript code executed when this element loses focus and its value has been modified since gaining focus.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7376,7 +7376,7 @@ </attribute-type> <attribute type="onclick"/> <attribute-type name="ondblclick" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is double clicked over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7391,7 +7391,7 @@ </attribute-type> <attribute type="onfocus"/> <attribute-type name="onkeydown" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7399,7 +7399,7 @@ </attribute-type> <attribute type="onkeydown"/> <attribute-type name="onkeypress" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is pressed and released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7407,7 +7407,7 @@ </attribute-type> <attribute type="onkeypress"/> <attribute-type name="onkeyup" required="false"> - <description>Javascript code executed when a key is + <description>Javascript code executed when a key is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7415,7 +7415,7 @@ </attribute-type> <attribute type="onkeyup"/> <attribute-type name="onmousedown" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is pressed down over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7423,7 +7423,7 @@ </attribute-type> <attribute type="onmousedown"/> <attribute-type name="onmousemove" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved within this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7431,7 +7431,7 @@ </attribute-type> <attribute type="onmousemove"/> <attribute-type name="onmouseout" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved away from this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7439,7 +7439,7 @@ </attribute-type> <attribute type="onmouseout"/> <attribute-type name="onmouseover" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is moved onto this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7447,7 +7447,7 @@ </attribute-type> <attribute type="onmouseover"/> <attribute-type name="onmouseup" required="false"> - <description>Javascript code executed when a pointer button is + <description>Javascript code executed when a pointer button is released over this element.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7455,7 +7455,7 @@ </attribute-type> <attribute type="onmouseup"/> <attribute-type name="onselect" required="false"> - <description>Javascript code executed when text within this + <description>Javascript code executed when text within this element is selected by the user.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7463,10 +7463,10 @@ </attribute-type> <attribute type="onselect"/> <attribute-type name="readonly" required="false"> - <description>Flag indicating that this component will prohibit changes by - the user. The element may receive focus unless it has also - been disabled. A value of false causes - no attribute to be rendered, while a value of true causes the + <description>Flag indicating that this component will prohibit changes by + the user. The element may receive focus unless it has also + been disabled. A value of false causes + no attribute to be rendered, while a value of true causes the attribute to be rendered as readonly="readonly".</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7485,8 +7485,8 @@ </attribute-type> <attribute type="style"/> <attribute-type name="styleClass" required="false"> - <description>Space-separated list of CSS style class(es) to be applied when - this element is rendered. This value must be passed through + <description>Space-separated list of CSS style class(es) to be applied when + this element is rendered. This value must be passed through as the "class" attribute on generated markup.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7494,8 +7494,8 @@ </attribute-type> <attribute type="styleClass"/> <attribute-type name="tabindex" required="false"> - <description>Position of this element in the tabbing order - for the current document. This value must be + <description>Position of this element in the tabbing order + for the current document. This value must be an integer between 0 and 32767.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7503,7 +7503,7 @@ </attribute-type> <attribute type="tabindex"/> <attribute-type name="title" required="false"> - <description>Advisory title information about markup elements generated + <description>Advisory title information about markup elements generated for this component.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7523,8 +7523,8 @@ end-tag="required" name="column" start-tag="required"> <description>&lt;p&gt;Renders a UIComponent that represents a single column of data within a parent &lt;code&gt;UIData&lt;/code&gt; component.&lt;/p&gt;</description> <attribute-type name="rendered" required="false"> - <description>Flag indicating whether or not this component should be rendered - (during Render Response Phase), or processed on any subsequent + <description>Flag indicating whether or not this component should be rendered + (during Render Response Phase), or processed on any subsequent form submit.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7548,7 +7548,7 @@ </attribute-type> <attribute type="id"/> <attribute-type name="footerClass" required="false"> - <description>Space-separated list of CSS style class(es) that will be + <description>Space-separated list of CSS style class(es) that will be applied to any column footer generated for this table.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7556,7 +7556,7 @@ </attribute-type> <attribute type="footerClass"/> <attribute-type name="headerClass" required="false"> - <description>Space-separated list of CSS style class(es) that will be + <description>Space-separated list of CSS style class(es) that will be applied to any column header generated for this table.</description> <proposal type="beanProperty"/> <proposal type="bundleProperty"/> @@ -7564,4 +7564,4 @@ </attribute-type> <attribute type="headerClass"/> </element-type> -</schema> +</schema> \ No newline at end of file