changes.
| | h2. Overview |
| | _Since 4.1_ |
| | |
| | | The _ace:clientValidateValueRange_ component validates the input of the enclosing component by allowing only decimal values within the defined range (minimum, maximum, or both) to be submitted. |
| | | The _ace:clientValidateValueRange_ component validates the input of the enclosing component by allowing only decimal values within the defined minimum, maximum, or range to be submitted. |
| | |
| | The _ace:clientValidateValueRange_ component can be used to validate the following: |
| | * A minimum value (_minimum_ attribute) |
| | * A maximum value (_maximum_ attribute) |
| | * A value range (_minimum_ and _maximum_ attributes) |
| | |
| | {tip}See the ICEfaces Showcase [Live Demo|http://icefaces-showcase.icesoft.org/showcase.jsf?grp=ace:clientValidateValueRange] of this component, complete with source code.{tip} |
| | |
| | |
| | h2. Getting Started |
| | {panel} |
| | {code:xml|borderStyle=dashed} |
| | <html ... xmlns:ace="http://www.icefaces.org/icefaces/components"> |
| | <h:body> |
| | <h:form> |
| | ... |
| | |
| | // Validate that the entered value is not greater than 10. |
| | <ace:textEntry id="textEntry2" value="#{clientValidateValueRangeBean.value2}" |
| | label="Input Value " labelPosition="left" size="8"> |
| | <ace:clientValidateValueRange maximum="10" /> |
| | </ace:textEntry> |
| | ... |
| | |
| | // Validate that the entered value is within the range of 10 to 20. |
| | <ace:textEntry id="textEntry3" value="#{clientValidateValueRangeBean.value3}" |
| | label="Input Value " labelPosition="left" size="8"> |
| | <ace:clientValidateValueRange minimum="10" maximum="20" /> |
| | </ace:textEntry> |
| | ... |
| | |
| | </h:form> |
| | ... |
| | </h:body> |
| | </html> |
| | {code} |
| | {panel} |
| | h2. Attributes |
| | |
| | {tip:title=TagLib Documentation}This section covers attributes involved in the typical use-cases for this component. For reference, the complete taglib documentation for this component is available [here|http://www.icefaces.org/docs/v4_latest/ace/tld/ace/clientValidateValueRange.html].{tip} |
| | {panel} |
| | *minimum* required value of the input. If not defined the minimum value is not verified. |
| | {panel} |
| | {panel} |
| | *maximum* allowed value of the input. If not defined the maximum value is not verified. |
| | {panel} |
| | |
| | h2. Validation Behaviour |
| | |
| | * Client validation occurs initially when the component value is attempted to be submitted to the server, either via an ace:ajax partial-submit or a full form submit. If the client validation fails the submit to the server is aborted and the appropriate error message is displayed in an associated ace:message, ace:messages, or ace:growlMessages component (without requiring a server-roundtrip). Thus, a form submit with multiple components is processed atomically and will be completely aborted if any of the components within it fail client validation. |
| | * Before submitting an entered component value the first time (either via full form submit, or an ace:ajax partial-submit), the user can tab through components in the form without triggering annoying validation messages - they won't get bugged before having the chance to actually enter a correct value. |
| | * However, once a component is marked invalid by a previous validation failure, it is eagerly validated: As soon as the user has entered the necessary value, the error message is removed, without requiring a form submit. |
| | * Client validation supports the "immediate='true'" attribute on ace:pushButton and ace:linkButton. When "immediate='true'" the button submit will occur regardless of whether one or more components in the form are failing client validation. |
| | |
| | h2. Event Listeners |
| | |
| | No direct event listener is associated with this component. |
| | |
| | h2. Client Behavior Events |
| | |
| | No direct client behavior is associated with this component. |
| | |
| | h2. JavaScript API |
| | |
| | Not applicable. |
| | |
| | h2. Keyboard and ARIA Support |
| | |
| | Not applicable. |
| | |
| | h2. CSS Classes |
| | |
| | Not applicable. |
| | |
| | h2. Known Issues |
| | |
| | None. |
| | |
| | h2. Additional Resources |
| | |
| | None. |
ClientValidateValueRange