This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
FormZ provides an easy way of handling fields activation under certain conditions.
Activation can be applied directly on a form's fields, or on a specific field validation rule. The goal is to activate the process only when a given boolean expression is verified.
A form has a radio button “Do you have a pet?”.
If the user checks “Yes”, then we want to know the name of the animal: a second text field “Name of the animal” is activated, it appears and its validation becomes active.
A user can fill its first and last name, but these fields are optional.
If one of the two fields is filled, then we want to know the other one as well. We must then activate the validation rule “required” of a field only when the other one is filled.
In the previous cases, a field activation means several things:
- The field will be displayed or hidden depending on if it is activated or not (using CSS).
- Same on the server side, the field validation will only run when the field is activated.
How does it work?¶
The activation is configured thanks to two properties: activation conditions, and a boolean expression.
Conditions can be configured in two places: either at the root of a form configuration, or at the root of a field configuration.
Potentially, any condition can be verified, as long as a proper PHP implementation exists. FormZ already provides several basic conditions, like “fieldHasValue” or “fieldIsValid”. It is possible to create new conditions to fit specific needs.
You can find the different existing conditions and their configuration at the chapter “Activation”.
The boolean expression allows to use several condition thanks to logical operators: the logical “and”, the logical “or”. It also allows to gather expressions thanks to parenthesis.
(colorIsRed || colorIsBlue) && emailIsValid
This expression is valid when
the selected color is red and the email is valid, or when
the selected color is blue and the email is valid.