public class RequiredCheckboxValidator extends Object implements Validator
The omnifaces.RequiredCheckboxValidator is intented to solve a peculiar problem with
required="true" attribute of UISelectBoolean components like
<h:selectBooleanCheckbox>. If you want to require the user to tick the desired checkbox, you would
expect that setting required="true" is sufficient. But it is not, the validation wil always pass.
As for every other UIInput component the default required="true" validator would
only check if the value is actually filled and been sent to the server side, i.e. the value is not null nor empty.
In case of a <h:selectBooleanCheckbox>, which accepts Boolean or boolean
properties only, EL will coerce the unchecked value to Boolean.FALSE during apply request values phase
right before validations phase. This value is not null nor empty! Thus, the required attribute of the
<h:selectBooleanCheckbox> is fairly pointless. It would always pass the validation and thus never
display the desired required message in case of an unticked checkbox.
This validator is available by validator ID omnifaces.RequiredCheckboxValidator. Just specify it as
<f:validator> of the boolean selection component:
<h:selectBooleanCheckbox id="agree" value="#{bean.agree}" requiredMessage="You must agree!">
<f:validator validatorId="omnifaces.RequiredCheckboxValidator" />
</h:selectBooleanCheckbox>
The validator will use the message as specified in requiredMessage. If it's absent, then it will use
the default required message as specified in custom <message-bundle> in
faces-config.xml. If it's absent, then it will default to
{0}: a tick is required"
NOT_IN_RANGE_MESSAGE_ID| Constructor and Description |
|---|
RequiredCheckboxValidator() |
| Modifier and Type | Method and Description |
|---|---|
void |
validate(FacesContext context,
UIComponent component,
Object value) |
public void validate(FacesContext context, UIComponent component, Object value) throws ValidatorException
validate in interface ValidatorValidatorExceptionCopyright © 2012–2015 OmniFaces. All rights reserved.